4.5.1.1 Параметры клиента mysql
mysql поддерживает следующие параметры, которые можно указать в командной строке или в группах параметров [mysql] и [client] файла параметров. Дополнительную информацию о файлах параметров, используемых программами MySQL, см. в разделе 4.2.2.2, «Использование файлов параметров».
Таблица 4.13 Параметры клиента mysql
| Имя параметра | Описание | Введено | Устарело |
|---|
| --auto-rehash | Включить автоматическое перехеширование | ||
|---|---|---|---|
| --auto-vertical-output | Включить автоматический вывод набора результатов в вертикальном формате | ||
| --batch | Не использовать файл истории | ||
| --binary-as-hex | Отображать двоичные значения в шестнадцатеричном формате | 5.7.19 | |
| --binary-mode | Отключить преобразование \r\n в \n и обработку \0 как конца запроса | ||
| --bind-address | Использовать указанный сетевой интерфейс для подключения к MySQL Server | ||
| --character-sets-dir | Директория установки наборов символов | ||
| --column-names | Выводить имена столбцов в результатах | ||
| --column-type-info | Отображать метаданные набора результатов | ||
| --comments | Сохранять или удалять комментарии в запросах, отправляемых на сервер | ||
| --compress | Сжимать всю информацию, отправляемую между клиентом и сервером | ||
| --connect-expired-password | Указать серверу, что клиент может обрабатывать режим песочницы для истекших паролей | ||
| --connect-timeout | Количество секунд до истечения времени ожидания подключения | ||
| --database | Используемая база данных | ||
| --debug | Записывать отладочный журнал; поддерживается только если MySQL был скомпилирован с поддержкой отладки | ||
| --debug-check | Выводить отладочную информацию при выходе программы | ||
| --debug-info | Выводить отладочную информацию, статистику памяти и ЦП при выходе программы | ||
| --default-auth | Используемый плагин аутентификации | ||
| --default-character-set | Указать набор символов по умолчанию | ||
| --defaults-extra-file | Прочитать указанный файл настроек дополнительно к обычным файлам настроек | ||
| --defaults-file | Прочитать только указанный файл настроек | ||
| --defaults-group-suffix | Значение суффикса группы настроек | ||
| --delimiter | Установить разделитель операторов | ||
| --enable-cleartext-plugin | Включить плагин аутентификации с открытым текстом | ||
| --execute | Выполнить оператор и выйти | ||
| --force | Продолжить даже при возникновении ошибки SQL | ||
| --get-server-public-key | Запросить открытый ключ RSA у сервера | 5.7.23 | |
| --help | Вывести сообщение справки и выйти | ||
| --histignore | Шаблоны, определяющие, какие операторы игнорировать для ведения журнала | ||
| --host | Хост, на котором расположен сервер MySQL | ||
| --html | Создать HTML-вывод | ||
| --ignore-spaces | Игнорировать пробелы после имён функций | ||
| --init-command | SQL-оператор, который нужно выполнить после подключения | ||
| --line-numbers | Выводить номера строк для ошибок | ||
| --local-infile | Включить или отключить для LOCAL функциональность LOAD DATA | ||
| --login-path | Прочитать параметры пути входа из .mylogin.cnf | ||
| --max-allowed-packet | Максимальная длина пакета для отправки на сервер или получения от сервера | ||
| --max-join-size | Автоматический предел строк в соединении при использовании --safe-updates | ||
| --named-commands | Включить именованные команды mysql | ||
| --net-buffer-length | Размер буфера для TCP/IP и сокетов | ||
| --no-auto-rehash | Отключить автоматическое перехеширование | ||
| --no-beep | Не издавать звуковой сигнал при возникновении ошибок | ||
| --no-defaults | Не читать файлы настроек | ||
| --one-database | Игнорировать операторы, кроме тех, которые предназначены для базы данных по умолчанию, указанной в командной строке | ||
| --pager | Использовать заданную команду для постраничного вывода результатов запроса | ||
| --password | Пароль для подключения к серверу | ||
| --pipe | Подключение к серверу с использованием именованного канала (только Windows) | ||
| --plugin-dir | Директория установки плагинов | ||
| --port | Номер TCP/IP порта для подключения | ||
| --print-defaults | Вывести параметры по умолчанию | ||
| --prompt | Установить приглашение в указанном формате | ||
| --protocol | Использовать транспортный протокол | ||
| --quick | Не кешировать каждый результат запроса | ||
| --raw | Записывать значения столбцов без преобразования экранирования | ||
| --reconnect | Если подключение к серверу потеряно, автоматически пытаться переподключиться | ||
| --safe-updates, --i-am-a-dummy | Разрешить только операторы UPDATE и DELETE, которые указывают значения ключей | ||
| --secure-auth | Не отправлять пароли на сервер в старом формате (до 4.1) | Да | |
| --select-limit | Автоматический предел для операторов SELECT при использовании --safe-updates | ||
| --server-public-key-path | Путь к файлу, содержащему открытый ключ RSA | ||
| --shared-memory-base-name | Имя общей памяти для подключений общей памяти (только Windows) |
| --show-warnings | Показывать предупреждения после каждой команды, если они есть | ||
|---|---|---|---|
| --sigint-ignore | Игнорировать сигналы SIGINT (обычно результат нажатия Ctrl+C) | ||
| --silent | Без вывода | ||
| --skip-auto-rehash | Отключить автоматическое перестроение | ||
| --skip-column-names | Не писать имена столбцов в результатах | ||
| --skip-line-numbers | Пропустить номера строк для ошибок | ||
| --skip-named-commands | Отключить именованные команды mysql | ||
| --skip-pager | Отключить постраничный вывод | ||
| --skip-reconnect | Отключить повторное подключение | ||
| --socket | Файл Unix-сокет или именованная Windows-пайп для использования | ||
| --ssl | Включить шифрование соединения | ||
| --ssl-ca | Файл, содержащий список доверенных сертификатов SSL-Центров сертификации | ||
| --ssl-capath | Директория, содержащая файлы сертификатов доверенных SSL-Центров сертификации | ||
| --ssl-cert | Файл, содержащий сертификат X.509 | ||
| --ssl-cipher | Разрешённые шифры для шифрования соединения | ||
| --ssl-crl | Файл, содержащий списки отзыва сертификатов | ||
| --ssl-crlpath | Директория, содержащая файлы списков отзыва сертификатов | ||
| --ssl-key | Файл, содержащий ключ X.509 | ||
| --ssl-mode | Желаемое состояние безопасности соединения с сервером | 5.7.11 | |
| --ssl-verify-server-cert | Проверка имени хоста по имени общего имени (Common Name) сертификата сервера | ||
| --syslog | Записывать интерактивные команды в syslog | ||
| --table | Выводить результат в табличном формате | ||
| --tee | Добавить копию вывода в указанный файл | ||
| --tls-version | Разрешённые протоколы TLS для шифрованных соединений | 5.7.10 | |
| --unbuffered | Очищать буфер после каждой команды | ||
| --user | Имя пользователя MySQL для подключения к серверу | ||
| --verbose | Подробный режим | ||
| --version | Отобразить информацию о версии и выйти | ||
| --vertical | Печать строк запроса вертикально (по одной строке на значение столбца) | ||
| --wait | Если соединение не может быть установлено, подождать и повторить попытку вместо прерывания | ||
| --xml | Создать вывод в формате XML |
-
--help,-?Формат командной строки --helpОтобразить справку и выйти.
-
Формат командной строки --auto-rehashОтключено параметром skip-auto-rehashВключить автоматическое обновление хеш-таблицы. Эта опция включена по умолчанию, что позволяет использовать автодополнение для имён баз данных, таблиц и столбцов. Используйте
--disable-auto-rehashдля отключения обновления хеш-таблицы. Это позволит mysql запускаться быстрее, но вам потребуется ввести командуrehashили её сокращённый вариант\#, если вы хотите использовать автодополнение имён.Для автодополнения имени введите его начальную часть и нажмите Tab. Если имя однозначно, mysql дополнит его. В противном случае, вы можете нажать Tab ещё раз, чтобы увидеть возможные имена, начинающиеся с введённой вами части. Автодополнение не происходит, если нет базы данных по умолчанию.
ПримечаниеДля этой функции требуется клиент MySQL, скомпилированный с библиотекой readline. Как правило, библиотека readline недоступна в Windows.
-
Формат командной строки --auto-vertical-outputПриводить результаты к вертикальному отображению, если они слишком широки для текущего окна, и использовать обычный табличный формат в противном случае. (Это относится к операторам, завершающимся на
;или\G.) -
--batch,-BФормат командной строки --batchВыводить результаты, используя табуляцию в качестве разделителя столбцов, при этом каждая строка находится на новой строке. С этой опцией mysql не использует файл истории.
Режим пакетной обработки приводит к нетабличному формату вывода и экранированию специальных символов. Экранирование можно отключить с помощью режима raw; см. описание опции
--raw. -
Формат командной строки --binary-as-hexВведено 5.7.19 Тип Булево Значение по умолчанию FALSEПри указании этой опции mysql отображает двоичные данные в шестнадцатеричном формате (
0x). Это происходит независимо от того, является ли общий формат вывода табличным, вертикальным, HTML или XML.value--binary-as-hexпри включении влияет на отображение всех двоичных строк, включая те, которые возвращаются функциями, такими какCHAR()иUNHEX(). Следующий пример демонстрирует это, используя ASCII-код дляA(65 десятичное, 41 шестнадцатеричное):-
--binary-as-hexотключен:mysql>
SELECT CHAR(0x41), UNHEX('41');+------------+-------------+ | CHAR(0x41) | UNHEX('41') | +------------+-------------+ | A | A | +------------+-------------+ -
--binary-as-hexвключен:mysql>
SELECT CHAR(0x41), UNHEX('41');+------------------------+--------------------------+ | CHAR(0x41) | UNHEX('41') | +------------------------+--------------------------+ | 0x41 | 0x41 | +------------------------+--------------------------+
Чтобы записать выражение двоичной строки так, чтобы оно отображалось как строка символов независимо от того, включена ли опция
--binary-as-hex, используйте следующие методы:-
Функция
CHAR()имеет предложениеUSING:charsetmysql>
SELECT CHAR(0x41 USING utf8mb4);+--------------------------+ | CHAR(0x41 USING utf8mb4) | +--------------------------+ | A | +--------------------------+ -
В более общем случае используйте
CONVERT()для преобразования выражения в заданную кодировку:mysql>
SELECT CONVERT(UNHEX('41') USING utf8mb4);+------------------------------------+ | CONVERT(UNHEX('41') USING utf8mb4) | +------------------------------------+ | A | +------------------------------------+
Эта опция была добавлена в MySQL 5.7.19.
-
-
Формат командной строки --binary-modeЭта опция полезна при обработке вывода mysqlbinlog, который может содержать значения
BLOB. По умолчанию, mysql преобразует\r\nв строках операторов в\nи интерпретирует\0как разделитель операторов.--binary-modeотключает обе функции. Это также отключает все команды mysql, кромеcharsetиdelimiterв неинтерактивном режиме (для ввода, передаваемого в mysql или загружаемого с помощью командыsource). -
Формат командной строки --bind-address=ip_addressНа компьютере с несколькими сетевыми интерфейсами используйте эту опцию для выбора интерфейса, который будет использоваться для подключения к серверу MySQL.
-
Формат командной строки --character-sets-dir=dir_nameТип Имя каталога Каталог, в котором установлены кодировки символов. См. Раздел 10.15, «Настройка кодировки символов».
-
Формат командной строки --column-namesВыводить имена столбцов в результатах.
-
Формат командной строки --column-type-infoОтображать метаданные результирующего набора. Эта информация соответствует содержимому структур данных C API
MYSQL_FIELD. См. .
-
--comments,-cФормат командной строки --commentsТип Boolean Значение по умолчанию FALSEУдалять или сохранять комментарии в операторах, отправляемых на сервер. Значение по умолчанию —
--skip-comments(удалять комментарии), включить с помощью--comments(сохранять комментарии).ПримечаниеВ MySQL 5.7 клиент mysql всегда передает подсказки оптимизатору на сервер, независимо от того, задан этот параметр или нет. Чтобы убедиться, что подсказки оптимизатора не удаляются, если вы используете более старую версию клиента mysql с версией сервера, которая понимает подсказки оптимизатора, вызовите mysql с параметром
--comments.Удаление комментариев устарело начиная с MySQL 5.7.20. Следует ожидать, что эта функция и параметры для управления ею будут удалены в будущих выпусках MySQL.
-
--compress,-CФормат командной строки --compress[={OFF|ON}]Тип Boolean Значение по умолчанию OFFСжимать всю информацию, передаваемую между клиентом и сервером, если это возможно. См. Раздел 4.2.6, «Управление сжатием соединения».
-
Формат командной строки --connect-expired-passwordУказать серверу, что клиент может обрабатывать режим песочницы, если учетная запись, используемая для подключения, имеет истекший срок действия пароля. Это может быть полезно для неинтерактивных вызовов mysql, поскольку обычно сервер отключает неинтерактивные клиенты, которые пытаются подключиться, используя учетную запись с истекшим сроком действия пароля. (См. Раздел 6.2.12, «Обработка сервером истекших паролей».)
-
Формат командной строки --connect-timeout=valueТип Numeric Значение по умолчанию 0Количество секунд до истечения времени ожидания подключения. (Значение по умолчанию —
0.) -
--database=,db_name-Ddb_nameФормат командной строки --database=dbnameТип String База данных для использования. Это полезно прежде всего в файле параметров.
-
--debug[=,debug_options]-# [debug_options]Формат командной строки --debug[=debug_options]Тип String Значение по умолчанию d:t:o,/tmp/mysql.traceЗаписать журнал отладки. Типичная строка
debug_options—d:t:o,. Значение по умолчанию —file_named:t:o,/tmp/mysql.trace.Этот параметр доступен только в том случае, если MySQL был собран с использованием
WITH_DEBUG. Дистрибутивные двоичные файлы MySQL, предоставляемые Oracle, не собираются с использованием этого параметра. -
Формат командной строки --debug-checkТип Boolean Значение по умолчанию FALSEВывести некоторую отладочную информацию при выходе программы.
Этот параметр доступен только в том случае, если MySQL был собран с использованием
WITH_DEBUG. Дистрибутивные двоичные файлы MySQL, предоставляемые Oracle, не собираются с использованием этого параметра. -
--debug-info,-TФормат командной строки --debug-infoТип Boolean Значение по умолчанию FALSEВывести отладочную информацию, а также статистику использования памяти и процессора при выходе программы.
Этот параметр доступен только в том случае, если MySQL был собран с использованием
WITH_DEBUG. Дистрибутивные двоичные файлы MySQL, предоставляемые Oracle, не собираются с использованием этого параметра. -
Формат командной строки --default-auth=pluginТип String Подсказка о том, какой плагин проверки подлинности на стороне клиента следует использовать. См. Раздел 6.2.13, «Подключаемая аутентификация».
-
--default-character-set=charset_nameФормат командной строки --default-character-set=charset_nameТип String Использовать
charset_nameв качестве кодировки по умолчанию для клиента и соединения.Этот параметр может быть полезен, если операционная система использует одну кодировку, а клиент mysql по умолчанию использует другую. В этом случае вывод может быть отформатирован неправильно. Обычно такие проблемы можно исправить, используя этот параметр, чтобы принудительно заставить клиента использовать системную кодировку.
Для получения дополнительной информации см. Раздел 10.4, «Кодировки и правила сортировки соединения», и Раздел 10.15, «Конфигурация кодировки».
-
--defaults-extra-file=file_nameФормат командной строки --defaults-extra-file=file_nameТип Имя файла Прочитать этот файл параметров после глобального файла параметров, но (в Unix) до файла параметров пользователя. Если файл не существует или недоступен, произойдет ошибка. Если
file_nameне является абсолютным именем пути, он интерпретируется относительно текущего каталога.Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 4.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».
-
Формат командной строки --defaults-file=file_nameТип Имя файла Использовать только указанный файл параметров. Если файл не существует или недоступен, произойдет ошибка. Если
file_nameне является абсолютным именем пути, он интерпретируется относительно текущего каталога.Исключение: даже с
--defaults-file, клиентские программы читают.mylogin.cnf.Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 4.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».
-
Формат командной строки --defaults-group-suffix=strТип Строка Читает не только обычные группы параметров, но и группы с обычными именами и суффиксом
str. Например, mysql обычно читает группы[client]и[mysql]. Если этот параметр задан как--defaults-group-suffix=_other, mysql также читает группы[client_other]и[mysql_other].Дополнительную информацию об этом и других параметрах файла опций см. в разделе 4.2.2.3, «Параметры командной строки, влияющие на обработку файла опций».
-
Формат командной строки --delimiter=strТип Строка Значение по умолчанию ;Устанавливает разделитель операторов. По умолчанию используется точка с запятой (
;). -
Отключает именованные команды. Используйте форму
\*только, или используйте именованные команды только в начале строки, заканчивающейся точкой с запятой (;). mysql по умолчанию запускается с этой опцией включённой. Однако даже с этой опцией команды в длинном формате все ещё работают с первой строки. См. раздел 4.5.1.2, «Команды клиента mysql». -
Формат командной строки --enable-cleartext-pluginТип Булево Значение по умолчанию FALSEВключает подключаемый модуль аутентификации
mysql_clear_passwordcleartext. (См. раздел 6.4.1.6, «Подключаемые модули аутентификации cleartext на стороне клиента».) -
--execute=,statement-estatementФормат командной строки --execute=statementТип Строка Выполнить оператор и выйти. Формат вывода по умолчанию аналогичен выводу с
--batch. См. раздел 4.2.2.1, «Использование параметров в командной строке», для некоторых примеров. С этим параметром mysql не использует файл истории. -
--force,-fФормат командной строки --forceПродолжить, даже если произошла ошибка SQL.
-
Формат командной строки --get-server-public-keyВведено 5.7.23 Тип Булево Запросить у сервера открытый ключ, необходимый для обмена паролями на основе пар ключей RSA. Этот параметр применяется к клиентам, которые аутентифицируются с помощью подключаемого модуля аутентификации
caching_sha2_password. Для этого плагина сервер не отправляет открытый ключ, если он не запрошен. Этот параметр игнорируется для учётных записей, которые не проходят аутентификацию с этим плагином. Он также игнорируется, если обмен паролями на основе RSA не используется, как в случае, когда клиент подключается к серверу с помощью защищённого соединения.Если задан
--server-public-key-path=и указывает действительный файл открытого ключа, он имеет приоритет надfile_name--get-server-public-key.Сведения о подключаемом модуле
caching_sha2_passwordсм. в разделе 6.4.1.4, «Подключаемый модуль аутентификации caching SHA-2».Параметр
--get-server-public-keyбыл добавлен в MySQL 5.7.23. -
Формат командной строки --histignore=pattern_listТип Строка Список одного или нескольких разделенных двоеточием шаблонов, определяющих операторы для игнорирования в целях протоколирования. Эти шаблоны добавляются к списку шаблонов по умолчанию (
"*IDENTIFIED*:*PASSWORD*"). Указанное значение для этого параметра влияет на протоколирование операторов, записанных в файл истории, и вsyslog, если задан параметр--syslog. Дополнительную информацию см. в разделе 4.5.1.3, «Протоколирование клиента mysql». -
--host=,host_name-hhost_nameФормат командной строки --host=host_nameТип Строка Значение по умолчанию localhostПодключиться к серверу MySQL на указанном хосте.
-
--html,-HФормат командной строки --htmlСоздать HTML-вывод.
-
--ignore-spaces,-iФормат командной строки --ignore-spacesИгнорировать пробелы после имён функций. Влияние этого описано в обсуждении режима SQL
IGNORE_SPACE(см. раздел 5.1.10, «Режимы SQL сервера»). -
Формат командной строки --init-command=strОператор SQL для выполнения после подключения к серверу. Если автоматическое переподключение включено, оператор выполняется снова после переподключения.
-
Формат командной строки --line-numbersОтключено skip-line-numbersВыводить номера строк для ошибок. Отключить это с помощью
--skip-line-numbers.
-
Формат командной строки --local-infile[={0|1}]Тип Булево Значение по умолчанию FALSEПо умолчанию, возможность
LOCALдляLOAD DATAопределяется значениями по умолчанию, скомпилированными в библиотеку MySQL. Чтобы явно включить или отключить загрузку данныхLOCAL, используйте параметр--local-infile. Если параметр используется без значения, он включает загрузку данныхLOCAL. Если параметр задан как--local-infile=0или--local-infile=1, он отключает или включает загрузку данныхLOCAL.Для успешного выполнения операций загрузки
LOCALв mysql также требуется разрешение сервера на локальную загрузку; см. Раздел 6.1.6, «Соображения безопасности для LOAD DATA LOCAL» -
Формат командной строки --login-path=nameТип Строка Считывает параметры из указанного пути входа в файл путей входа
.mylogin.cnf. «Путь входа» — это группа параметров, определяющая, с каким сервером MySQL соединиться и под какой учетной записью авторизоваться. Для создания или изменения файла путей входа используйте утилиту mysql_config_editor. См. Раздел 4.6.6, «mysql_config_editor — Утилита конфигурации MySQL».Дополнительную информацию об этом и других параметрах файлов см. в Разделе 4.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».
-
Формат командной строки --max-allowed-packet=valueТип Числовой Значение по умолчанию 16777216Максимальный размер буфера для связи клиент/сервер. По умолчанию 16 МБ, максимальное значение 1 ГБ.
-
Формат командной строки --max-join-size=valueТип Числовой Значение по умолчанию 1000000Автоматический лимит строк в соединении при использовании
--safe-updates. (Значение по умолчанию 1 000 000.) -
--named-commands,-GФормат командной строки --named-commandsОтключено skip-named-commandsВключить именованные команды mysql. Разрешены команды в длинном формате, а не только в коротком. Например,
quitи\qраспознаются. Используйте--skip-named-commandsдля отключения именованных команд. См. Раздел 4.5.1.2, «Команды клиента mysql». -
Формат командной строки --net-buffer-length=valueТип Числовой Значение по умолчанию 16384Размер буфера для связи TCP/IP и сокетов. (Значение по умолчанию 16 КБ.)
-
--no-auto-rehash,-AФормат командной строки --no-auto-rehashУстарело Да Это имеет тот же эффект, что и
--skip-auto-rehash. См. описание--auto-rehash. -
--no-beep,-bФормат командной строки --no-beepНе издавать звуковой сигнал при возникновении ошибок.
-
Формат командной строки --no-defaultsНе читать никакие файлы параметров. Если запуск программы терпит неудачу из-за чтения неизвестных параметров из файла параметров,
--no-defaultsможет быть использован для предотвращения их чтения.Исключением является файл
.mylogin.cnf, который читается во всех случаях, если он существует. Это позволяет задавать пароли более безопасным способом, чем в командной строке, даже если используется--no-defaults. Чтобы создать.mylogin.cnf, используйте утилиту mysql_config_editor. См. Раздел 4.6.6, «mysql_config_editor — Утилита конфигурации MySQL».Дополнительную информацию об этом и других параметрах файлов см. в Разделе 4.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».
-
--one-database,-oФормат командной строки --one-databaseИгнорировать операторы, кроме тех, которые выполняются, когда текущей базой данных является база данных, указанная в командной строке. Данный параметр примитивен и должен использоваться с осторожностью. Фильтрация операторов основана только на операторах
USE.Изначально, mysql выполняет операторы из входных данных, потому что указание базы данных
db_nameв командной строке эквивалентно вставке оператораUSEв начало входных данных. Затем для каждого оператораdb_nameUSE, который встречается, mysql принимает или отклоняет последующие операторы в зависимости от того, является ли указанная база данных базой данных из командной строки. Содержимое операторов не имеет значения.Предположим, что mysql вызывается для обработки этого набора операторов:
DELETE FROM db2.t2; USE db2; DROP TABLE db1.t1; CREATE TABLE db1.t1 (i INT); USE db1; INSERT INTO t1 (i) VALUES(1); CREATE TABLE db2.t1 (j INT);
Если командная строка — mysql --force --one-database db1, mysql обрабатывает входные данные следующим образом:
Оператор
DELETEвыполняется, потому что текущая база данных —db1, даже несмотря на то, что оператор указывает таблицу в другой базе данных.Операторы
DROP TABLEиCREATE TABLEне выполняются, потому что текущая база данных не являетсяdb1, даже несмотря на то, что операторы указывают таблицу вdb1.Операторы
INSERTиCREATE TABLEвыполняются, потому что текущая база данных —db1, даже несмотря на то, что операторCREATE TABLEуказывает таблицу в другой базе данных.
-
Формат командной строки --pager[=command]Отключается skip-pagerТип Строка Используйте данную команду для постраничного отображения результатов запроса. Если команда опущена, по умолчанию используется значение вашей переменной среды
PAGER. Допустимые пагинаторы: less, more, cat [> filename] и т. д. Этот параметр работает только в системах Unix и только в интерактивном режиме. Чтобы отключить пагинатор, используйте--skip-pager. Раздел 4.5.1.2, «Команды клиента mysql», подробно описывает постраничное отображение вывода. -
--password[=,password]-p[password]Формат командной строки --password[=password]Тип Строка Пароль учетной записи MySQL, используемой для подключения к серверу. Значение пароля необязательно. Если оно не указано, mysql запросит его. Если указано, между параметром
--password=или-pи следующим за ним паролем не должно быть пробелов. Если параметр пароля не указан, по умолчанию пароль не передается.Указание пароля в командной строке считается небезопасным. Чтобы избежать ввода пароля в командной строке, используйте файл параметров. Смотрите Раздел 6.1.2.1, «Руководство для конечных пользователей по безопасности паролей».
Чтобы явно указать, что пароль отсутствует и что mysql не должен его запрашивать, используйте параметр
--skip-password. -
--pipe,-WФормат командной строки --pipeТип Строка В Windows подключайтесь к серверу через именованный канал. Этот параметр применяется только если сервер был запущен с включенной переменной системы
named_pipeдля поддержки подключений через именованные каналы. Кроме того, пользователь, производящий подключение, должен быть членом группы Windows, указанной в переменной системыnamed_pipe_full_access_group. -
Формат командной строки --plugin-dir=dir_nameТип Имя каталога Каталог, в котором следует искать плагины. Укажите этот параметр, если параметр
--default-authиспользуется для указания плагина аутентификации, но mysql не находит его. Смотрите Раздел 6.2.13, «Подключаемая аутентификация». -
--port=,port_num-Pport_numФормат командной строки --port=port_numТип Числовое значение Значение по умолчанию 3306Номер порта для подключений TCP/IP.
-
Формат командной строки --print-defaultsВывести имя программы и все параметры, полученные из файлов параметров.
Дополнительную информацию об этом и других параметрах файлов параметров см. в Разделе 4.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».
-
Формат командной строки --prompt=format_strТип Строка Значение по умолчанию mysql>Установить приглашение в указанном формате. По умолчанию —
mysql>. Специальные последовательности, которые может содержать приглашение, описаны в Разделе 4.5.1.2, «Команды клиента mysql». -
--protocol={TCP|SOCKET|PIPE|MEMORY}Формат командной строки --protocol=typeТип Строка Значение по умолчанию [see text]Допустимые значения TCPSOCKETPIPEMEMORYТранспортный протокол для подключения к серверу. Полезно, когда другие параметры подключения приводят к использованию протокола, отличного от желаемого. Подробности допустимых значений см. в Разделе 4.2.5, «Протоколы транспортного соединения».
-
--quick,-qФормат командной строки --quickНе кэшировать каждый результат запроса, выводить каждую строку по мере ее получения. Это может замедлить работу сервера, если вывод приостановлен. С этим параметром, mysql не использует файл истории.
По умолчанию, mysql получает все строки результата до вывода любой информации; при хранении этих строк он вычисляет максимальную длину столбца на основе фактического значения каждого столбца последовательно. При выводе вывода он использует этот максимум для форматирования. Когда параметр
--quickуказан, mysql не имеет строк, для которых можно вычислить длину перед началом, и поэтому использует максимальную длину. В следующем примере таблицаt1имеет один столбец типаBIGINTи содержит 4 строки. Вывод по умолчанию имеет ширину 9 символов; эта ширина равна максимальному количеству символов в любом из значений столбцов в возвращенных строках (5), плюс 2 символа каждый для пробелов, используемых в качестве отступа, и|символов, используемых в качестве разделителей столбцов. Вывод при использовании параметра--quickимеет ширину 25 символов; это равно количеству символов, необходимых для представления-9223372036854775808, которое является самым длинным возможным значением, которое может быть сохранено в столбце (со знаком)BIGINT, или 19 символов, плюс 4 символа для отступа и разделителей столбцов. Разницу можно увидеть здесь:$>
mysql -t test -e "SELECT * FROM t1"+-------+ | c1 | +-------+ | 100 | | 1000 | | 10000 | | 10 | +-------+ $>mysql --quick -t test -e "SELECT * FROM t1"+----------------------+ | c1 | +----------------------+ | 100 | | 1000 | | 10000 | | 10 | +----------------------+ -
--raw,-rФормат командной строки --rawДля табличного вывода, «рамка» вокруг столбцов позволяет отличить одно значение столбца от другого. Для нетабличного вывода (например, при работе в пакетном режиме или когда задан параметр
--batchили--silent), специальные символы экранируются в выводе, чтобы их можно было легко идентифицировать. Новая строка, табуляция,NULи обратный слэш записываются как\n,\t,\0и\\. Параметр--rawотключает эту экранировку символов.Следующий пример демонстрирует табличный и нетабличный вывод, а также использование режима raw для отключения экранирования:
%
mysqlmysql> SELECT CHAR(92); +----------+ | CHAR(92) | +----------+ | \ | +----------+ %mysql -smysql> SELECT CHAR(92); CHAR(92) \\ %mysql -s -rmysql> SELECT CHAR(92); CHAR(92) \ -
Формат командной строки --reconnectОтключено при skip-reconnectПри потере соединения с сервером автоматически пытаться переподключиться. Одна попытка переподключения выполняется каждый раз при потере соединения. Чтобы отключить поведение переподключения, используйте
--skip-reconnect. -
--safe-updates,--i-am-a-dummy,-UФормат командной строки --safe-updates--i-am-a-dummyТип Булево Значение по умолчанию FALSEЕсли этот параметр включен, операторы
UPDATEиDELETE, которые не используют ключ вWHEREилиLIMITкоманда, вызывают ошибку. Кроме того, накладываются ограничения на операторыSELECT, которые генерируют (или оцениваются для генерации) очень больших наборов результатов. Если этот параметр установлен в файле параметров, вы можете использовать--skip-safe-updatesв командной строке для его перезаписи. Более подробную информацию об этом параметре см. в разделе Использование режима Safe-Updates (--safe-updates). -
Формат командной строки --secure-authУстаревший Да Не отправлять пароли на сервер в старом формате (до версии 4.1). Это предотвращает подключение, кроме серверов, использующих новый формат пароля.
Начиная с MySQL 5.7.5, этот параметр устарел; ожидается его удаление в будущих версиях MySQL. Он всегда включен, и попытка его выключения (
--skip-secure-auth,--secure-auth=0) приводит к ошибке. До MySQL 5.7.5 этот параметр включен по умолчанию, но может быть выключен.ПримечаниеПароли, использующие метод хэширования до версии 4.1, менее безопасны, чем пароли, использующие родной метод хэширования паролей, и их следует избегать. Пароли до версии 4.1 устарели, и поддержка их была удалена в MySQL 5.7.5. Инструкции по обновлению учетных записей см. в разделе Раздел 6.4.1.3, «Переход от хэширования паролей до версии 4.1 и плагина mysql_old_password».
-
Формат командной строки --select-limit=valueТип Числовой Значение по умолчанию 1000Автоматическое ограничение для операторов
SELECTпри использовании--safe-updates. (Значение по умолчанию — 1000.) -
--server-public-key-path=file_nameФормат командной строки --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см. в Разделе 6.4.1.5, «Плагин аутентификации SHA-256» и Разделе 6.4.1.4, «Кэширование плагина аутентификации SHA-2». -
--shared-memory-base-name=nameФормат командной строки --shared-memory-base-name=nameСпецифично для платформы Windows В Windows имя общих ресурсов для соединений, созданных с помощью общих ресурсов с локальным сервером. Значение по умолчанию —
MYSQL. Имя общих ресурсов чувствительно к регистру.Этот параметр применяется только в том случае, если сервер был запущен с включенной переменной системы
shared_memoryдля поддержки подключений с общими ресурсами.
-
Формат командной строки --show-warningsВыводить предупреждения после каждой команды, если они есть. Этот параметр применим к интерактивному и пакетному режимам.
-
Формат командной строки --sigint-ignoreИгнорировать сигналы
SIGINT(обычно, результат нажатия Control+C).Без этого параметра нажатие Control+C прерывает текущую команду, если она есть, или отменяет частично введённую строку в противном случае.
-
--silent,-sФормат командной строки --silentТихий режим. Выводить меньше вывода. Этот параметр можно указывать несколько раз для получения всё меньше и меньше вывода.
Этот параметр приводит к нетабличному формату вывода и экранированию специальных символов. Экранирование можно отключить, используя режим без обработки; см. описание параметра
--raw. -
Формат командной строки --skip-column-namesНе выводить имена столбцов в результатах. Использование этого параметра приводит к выравниванию вывода по правому краю, как показано здесь:
$>
echo "SELECT * FROM t1" | mysql -t test+-------+ | c1 | +-------+ | a,c,d | | c | +-------+ $>echo "SELECT * FROM t1" | ./mysql -uroot -Nt test+-------+ | a,c,d | | c | +-------+ -
Формат командной строки --skip-line-numbersНе выводить номера строк для ошибок. Полезно при сравнении файлов результатов, содержащих сообщения об ошибках.
-
--socket=,path-SpathФормат командной строки --socket={file_name|pipe_name}Тип Строка Для подключений к
localhost, используемый файл Unix-сокет или, в Windows, имя именованной трубы.В Windows этот параметр применим только в том случае, если сервер был запущен с системной переменной
named_pipe, включённой для поддержки именованных трубных соединений. Кроме того, пользователь, осуществляющий подключение, должен быть членом группы Windows, указанной системной переменнойnamed_pipe_full_access_group. -
--ssl*Параметры, начинающиеся с
--ssl, определяют, подключаться ли к серверу с использованием шифрования, и указывают, где найти ключи и сертификаты SSL. См. Параметры командной строки для зашифрованных подключений. -
--syslog,-jФормат командной строки --syslogЭтот параметр заставляет mysql отправлять интерактивные инструкции в системную службу регистрации. В Unix это
syslog; в Windows — журнал событий Windows. Место назначения, куда отображаются записанные сообщения, зависит от системы. В Linux место назначения часто является файлом/var/log/messages.Вот пример вывода, сгенерированный в Linux с помощью
--syslog. Этот вывод отформатирован для удобочитаемости; каждое зарегистрированное сообщение фактически занимает отдельную строку.Mar 7 12:39:25 myhost MysqlClient[20824]: SYSTEM_USER:'oscar', MYSQL_USER:'my_oscar', CONNECTION_ID:23, DB_SERVER:'127.0.0.1', DB:'--', QUERY:'USE test;' Mar 7 12:39:28 myhost MysqlClient[20824]: SYSTEM_USER:'oscar', MYSQL_USER:'my_oscar', CONNECTION_ID:23, DB_SERVER:'127.0.0.1', DB:'test', QUERY:'SHOW TABLES;'
Дополнительную информацию см. в разделе 4.5.1.3, «Регистрация клиента mysql».
-
--table,-tФормат командной строки --tableОтображать вывод в табличном формате. Это значение по умолчанию для интерактивного использования, но может использоваться для создания табличного вывода в пакетном режиме.
-
Формат командной строки --tee=file_nameТип Имя файла Добавить копию вывода в указанный файл. Этот параметр работает только в интерактивном режиме. Раздел 4.5.1.2, «Команды клиента mysql» более подробно рассматривает файлы tee.
-
Формат командной строки --tls-version=protocol_listВведено 5.7.10 Тип Строка Значение по умолчанию (≥ 5.7.28) TLSv1,TLSv1.1,TLSv1.2Значение по умолчанию (≤ 5.7.27) TLSv1,TLSv1.1,TLSv1.2(OpenSSL)TLSv1,TLSv1.1(yaSSL)Разрешенные TLS-протоколы для зашифрованных соединений. Значение представляет собой список одного или нескольких названий протоколов, разделённых запятыми. Протоколы, которые могут быть указаны для этого параметра, зависят от используемой библиотеки SSL при компиляции MySQL. Для получения подробностей см. раздел 6.3.2, «TLS-протоколы и шифры зашифрованных соединений».
Этот параметр был добавлен в MySQL 5.7.10.
-
--unbuffered,-nФормат командной строки --unbufferedОчистить буфер после каждой запроса.
-
--user=,user_name-uuser_nameФормат командной строки --user=user_nameТип Строка Имя пользователя учётной записи MySQL, используемой для подключения к серверу.
-
--verbose,-vФормат командной строки --verboseРежим подробных сообщений. Выводить больше информации о действиях программы. Этот параметр можно указывать несколько раз для увеличения количества выводимой информации. (Например,
-v -v -vотображает табличный формат вывода даже в пакетном режиме.) -
--version,-VФормат командной строки --versionОтобразить информацию о версии и завершить работу.
-
--vertical,-EФормат командной строки --verticalВыводить строки запроса вертикально (по одной строке на значение столбца). Без этого параметра можно указать вертикальный вывод для отдельных инструкций, завершив их
\G. -
--wait,-wФормат командной строки --waitЕсли подключение не может быть установлено, подождать и повторить попытку вместо прерывания.
-
--xml,-XФормат командной строки --xmlВывод XML-данных.
<field name="
column_name">NULL</field>Вывод, когда используется
--xmlс mysql, соответствует выводу mysqldump с--xml. Подробности см. в разделе 4.5.4, «mysqldump — Программа резервного копирования базы данных».Вывод XML также использует пространство имён XML, как показано здесь:
$>
mysql --xml -uroot -e "SHOW VARIABLES LIKE 'version%'"<?xml version="1.0"?> <resultset statement="SHOW VARIABLES LIKE 'version%'" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"> <row> <field name="Variable_name">version</field> <field name="Value">5.0.40-debug</field> </row> <row> <field name="Variable_name">version_comment</field> <field name="Value">Source distribution</field> </row> <row> <field name="Variable_name">version_compile_machine</field> <field name="Value">i686</field> </row> <row> <field name="Variable_name">version_compile_os</field> <field name="Value">suse-linux-gnu</field> </row> </resultset>
© 2025 Oracle
Licensed under the GPLv2 License.