--help, -h

Отобразить справку и выйти.

--component-dir=dir_name

Каталог, в котором расположены компоненты keyring. Обычно это значение системной переменной plugin_dir для локального сервера MySQL.

--defaults-extra-file=file_name

Прочитать этот файл опций после глобального файла опций, но (в Unix) перед файлом пользовательских опций. Если файл не существует или недоступен, возникает ошибка. Если file_name не является абсолютным именем пути, он интерпретируется относительно текущего каталога.

Для получения дополнительной информации об этом и других параметрах файла опций см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--defaults-file=file_name

Использовать только указанный файл опций. Если файл не существует или недоступен, возникает ошибка. Если file_name не является абсолютным именем пути, он интерпретируется относительно текущего каталога.

Исключение: Даже с --defaults-file, клиентские программы читают .mylogin.cnf.

Для получения дополнительной информации об этом и других параметрах файла опций см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--defaults-group-suffix=str

Читать не только обычные группы опций, но и группы с обычными именами и суффиксом str. Например, mysql_migrate_keyring обычно читает группу [mysql_migrate_keyring]. Если этот параметр задан как --defaults-group-suffix=_other, mysql_migrate_keyring также читает группу [mysql_migrate_keyring_other].

Для получения дополнительной информации об этом и других параметрах файла опций см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--destination-keyring=name

Целевой компонент keyring для миграции ключей. Формат и интерпретация значения параметра такие же, как описано для параметра --source-keyring.

--destination-keyring-configuration-dir=dir_name

Этот параметр применяется только в том случае, если глобальный файл конфигурации компонента keyring содержит "read_local_config": true, указывая на то, что конфигурация компонента содержится в локальном файле конфигурации. Значение параметра указывает каталог, содержащий этот локальный файл.

--get-server-public-key

Запросить у сервера открытый ключ, необходимый для обмена паролями на основе пары ключей RSA. Этот параметр применяется к клиентам, которые аутентифицируются с помощью плагина аутентификации caching_sha2_password. Для этого плагина сервер не отправляет открытый ключ, если он не запрошен. Этот параметр игнорируется для учетных записей, которые не аутентифицируются с помощью этого плагина. Он также игнорируется, если не используется обмен паролями на основе RSA, как это происходит, когда клиент подключается к серверу с использованием защищенного соединения.

Если указан --server-public-key-path=file_name и указывает на допустимый файл открытого ключа, он имеет приоритет над --get-server-public-key.

Для получения информации о плагине caching_sha2_password см. Раздел 8.4.1.1, «Кэшируемая SHA-2 подключаемая аутентификация».

--host=host_name, -h host_name

Местоположение узла работающего сервера, который в настоящее время использует один из хранилищ ключей миграции ключей. Миграция всегда происходит на локальном хосте, поэтому параметр всегда указывает значение для подключения к локальному серверу, например localhost, 127.0.0.1, ::1 или локальный IP-адрес или имя узла.

--login-path=name

Чтение параметров из указанного пути к файлу входа в .mylogin.cnf. “Путь к файлу входа” — это группа параметров, указывающих, к какому серверу MySQL подключаться и под какой учетной записью выполнять аутентификацию. Для создания или изменения файла пути к файлу входа используйте утилиту mysql_config_editor. См. Раздел 6.6.7, «mysql_config_editor — Утилита конфигурации MySQL».

Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--no-login-paths

Пропускает чтение параметров из файла пути к файлу входа.

См. --login-path для получения дополнительной информации.

Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--no-defaults

Не читать никакие файлы параметров. Если запуск программы завершается ошибкой из-за чтения неизвестных параметров из файла параметров, --no-defaults можно использовать, чтобы предотвратить их чтение.

Исключением является то, что файл .mylogin.cnf читается во всех случаях, если он существует. Это позволяет указывать пароли более безопасным способом, чем в командной строке, даже когда используется --no-defaults. Чтобы создать .mylogin.cnf, используйте утилиту mysql_config_editor. См. Раздел 6.6.7, «mysql_config_editor — Утилита конфигурации MySQL».

Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--online-migration

Этот параметр обязателен, когда работающий сервер использует keyring. Он указывает mysql_migrate_keyring выполнить онлайн-миграцию ключей. Параметр имеет следующие эффекты:

--password[=password], -p[password]

Пароль учетной записи MySQL, используемой для подключения к работающему серверу, который в настоящее время использует один из хранилищ ключей миграции ключей. Значение пароля является необязательным. Если он не указан, mysql_migrate_keyring запрашивает его. Если указан, между --password= или -p и последующим паролем не должно быть пробелов. Если параметр пароля не указан, по умолчанию отправляется отсутствие пароля.

Указание пароля в командной строке следует считать небезопасным. Чтобы избежать указания пароля в командной строке, используйте файл параметров. См. Раздел 8.1.2.1, «Рекомендации для конечных пользователей по безопасности паролей».

Чтобы явно указать, что пароля нет и что mysql_migrate_keyring не должен запрашивать его, используйте параметр --skip-password.

--port=port_num, -P port_num

Для подключений TCP/IP — номер порта для подключения к работающему серверу, который в настоящее время использует одно из хранилищ ключей миграции ключей.

--print-defaults

Вывести имя программы и все параметры, которые она получает из файлов параметров.

Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--server-public-key-path=file_name

Имя пути к файлу в формате PEM, содержащему клиентскую копию открытого ключа, требуемого сервером для обмена паролями на основе пары ключей RSA. Этот параметр применяется к клиентам, которые выполняют аутентификацию с помощью плагина аутентификации sha256_password или caching_sha2_password. Этот параметр игнорируется для учетных записей, которые не выполняют аутентификацию с помощью одного из этих плагинов. Он также игнорируется, если обмен паролями на основе RSA не используется, как это происходит, когда клиент подключается к серверу с использованием защищенного соединения.

Если указан --server-public-key-path=file_name и указывает на допустимый файл открытого ключа, он имеет приоритет над --get-server-public-key.

Для sha256_password этот параметр применяется только в том случае, если MySQL был собран с использованием OpenSSL.

Для получения информации о плагинах sha256_password и caching_sha2_password см. Раздел 8.4.1.2, «SHA-256 подключаемая аутентификация» и Раздел 8.4.1.1, «Кэшируемая SHA-2 подключаемая аутентификация».

--socket=path, -S path

Для сокета Unix или именованной трубы Windows, файл сокета или именованная труба для подключения к работающему серверу, который в настоящее время использует один из ключей миграции хранилищ ключей.

В Windows этот параметр применяется только в том случае, если сервер был запущен с включенной системной переменной named_pipe для поддержки подключений через именованные трубы. Кроме того, пользователь, осуществляющий подключение, должен быть членом группы Windows, указанной в системной переменной named_pipe_full_access_group.

--source-keyring=name

Компонент исходного хранилища ключей для миграции ключей. Это имя файла библиотеки компонента, указанное без каких-либо платформенно-специфических расширений, таких как .so или .dll. Например, для использования компонента, для которого файл библиотеки равен component_keyring_file.so, укажите параметр как --source-keyring=component_keyring_file.

--source-keyring-configuration-dir=dir_name

Этот параметр применяется только в том случае, если глобальный конфигурационный файл компонента исходного хранилища ключей содержит "read_local_config": true, указывая, что конфигурация компонента находится в локальном конфигурационном файле. Значение параметра указывает каталог, содержащий этот локальный файл.

--ssl*

Параметры, начинающиеся с --ssl, определяют, подключаться ли к серверу с использованием шифрования и указывают, где найти ключи и сертификаты SSL. См. Параметры командной строки для шифрованных подключений.

--ssl-fips-mode={OFF|ON|STRICT}

Управляет включением режима FIPS на стороне клиента. Параметр --ssl-fips-mode отличается от других параметров --ssl-xxx тем, что он не используется для установления шифрованных подключений, а для управления разрешенными криптографическими операциями. См. Раздел 8.8, «Поддержка FIPS».

Разрешенные значения --ssl-fips-mode:

Этот параметр устарел. Ожидается его удаление в будущих версиях MySQL.

--tls-version=protocol_list

Разрешенные протоколы TLS для шифрованных подключений. Значение представляет собой список одного или нескольких названий протоколов, разделенных запятыми. Протоколы, которые могут быть указаны для этого параметра, зависят от библиотеки SSL, используемой для компиляции MySQL. Подробности см. в Разделе 8.3.2, «Протоколы и шифры TLS шифрованного подключения».