Spec-Zone.ru › MySQL 5.7

4.5.1.1 Параметры клиента mysql

mysql поддерживает следующие параметры, которые можно указать в командной строке или в группах параметров [mysql] и [client] файла параметров. Дополнительную информацию о файлах параметров, используемых программами MySQL, см. в разделе 4.2.2.2, «Использование файлов параметров».

Таблица 4.13 Параметры клиента mysql

Таблица 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

    Формат командной строки --auto-rehash
    Отключено параметром skip-auto-rehash

    Включить автоматическое обновление хеш-таблицы. Эта опция включена по умолчанию, что позволяет использовать автодополнение для имён баз данных, таблиц и столбцов. Используйте --disable-auto-rehash для отключения обновления хеш-таблицы. Это позволит mysql запускаться быстрее, но вам потребуется ввести команду rehash или её сокращённый вариант \#, если вы хотите использовать автодополнение имён.

    Для автодополнения имени введите его начальную часть и нажмите Tab. Если имя однозначно, mysql дополнит его. В противном случае, вы можете нажать Tab ещё раз, чтобы увидеть возможные имена, начинающиеся с введённой вами части. Автодополнение не происходит, если нет базы данных по умолчанию.

    Примечание

    Для этой функции требуется клиент MySQL, скомпилированный с библиотекой readline. Как правило, библиотека readline недоступна в Windows.

  • --auto-vertical-output

    Формат командной строки --auto-vertical-output

    Приводить результаты к вертикальному отображению, если они слишком широки для текущего окна, и использовать обычный табличный формат в противном случае. (Это относится к операторам, завершающимся на ; или \G.)

  • --batch, -B

    Формат командной строки --batch

    Выводить результаты, используя табуляцию в качестве разделителя столбцов, при этом каждая строка находится на новой строке. С этой опцией mysql не использует файл истории.

    Режим пакетной обработки приводит к нетабличному формату вывода и экранированию специальных символов. Экранирование можно отключить с помощью режима raw; см. описание опции --raw.

  • --binary-as-hex

    Формат командной строки --binary-as-hex
    Введено 5.7.19
    Тип Булево
    Значение по умолчанию FALSE

    При указании этой опции mysql отображает двоичные данные в шестнадцатеричном формате (0xvalue). Это происходит независимо от того, является ли общий формат вывода табличным, вертикальным, HTML или XML.

    --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 charset:

      mysql> 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

    Формат командной строки --binary-mode

    Эта опция полезна при обработке вывода mysqlbinlog, который может содержать значения BLOB. По умолчанию, mysql преобразует \r\n в строках операторов в \n и интерпретирует \0 как разделитель операторов. --binary-mode отключает обе функции. Это также отключает все команды mysql, кроме charset и delimiter в неинтерактивном режиме (для ввода, передаваемого в mysql или загружаемого с помощью команды source).

  • --bind-address=ip_address

    Формат командной строки --bind-address=ip_address

    На компьютере с несколькими сетевыми интерфейсами используйте эту опцию для выбора интерфейса, который будет использоваться для подключения к серверу MySQL.

  • --character-sets-dir=dir_name

    Формат командной строки --character-sets-dir=dir_name
    Тип Имя каталога

    Каталог, в котором установлены кодировки символов. См. Раздел 10.15, «Настройка кодировки символов».

  • --column-names

    Формат командной строки --column-names

    Выводить имена столбцов в результатах.

  • --column-type-info

    Формат командной строки --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

    Формат командной строки --connect-expired-password

    Указать серверу, что клиент может обрабатывать режим песочницы, если учетная запись, используемая для подключения, имеет истекший срок действия пароля. Это может быть полезно для неинтерактивных вызовов mysql, поскольку обычно сервер отключает неинтерактивные клиенты, которые пытаются подключиться, используя учетную запись с истекшим сроком действия пароля. (См. Раздел 6.2.12, «Обработка сервером истекших паролей».)

  • --connect-timeout=value

    Формат командной строки --connect-timeout=value
    Тип Numeric
    Значение по умолчанию 0

    Количество секунд до истечения времени ожидания подключения. (Значение по умолчанию — 0.)

  • --database=db_name, -D db_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_name. Значение по умолчанию — d:t:o,/tmp/mysql.trace.

    Этот параметр доступен только в том случае, если MySQL был собран с использованием WITH_DEBUG. Дистрибутивные двоичные файлы MySQL, предоставляемые Oracle, не собираются с использованием этого параметра.

  • --debug-check

    Формат командной строки --debug-check
    Тип Boolean
    Значение по умолчанию FALSE

    Вывести некоторую отладочную информацию при выходе программы.

    Этот параметр доступен только в том случае, если MySQL был собран с использованием WITH_DEBUG. Дистрибутивные двоичные файлы MySQL, предоставляемые Oracle, не собираются с использованием этого параметра.

  • --debug-info, -T

    Формат командной строки --debug-info
    Тип Boolean
    Значение по умолчанию FALSE

    Вывести отладочную информацию, а также статистику использования памяти и процессора при выходе программы.

    Этот параметр доступен только в том случае, если MySQL был собран с использованием WITH_DEBUG. Дистрибутивные двоичные файлы MySQL, предоставляемые Oracle, не собираются с использованием этого параметра.

  • --default-auth=plugin

    Формат командной строки --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

    Формат командной строки --defaults-file=file_name
    Тип Имя файла

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

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

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

  • --defaults-group-suffix=str

    Формат командной строки --defaults-group-suffix=str
    Тип Строка

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

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

  • --delimiter=str

    Формат командной строки --delimiter=str
    Тип Строка
    Значение по умолчанию ;

    Устанавливает разделитель операторов. По умолчанию используется точка с запятой (;).

  • --disable-named-commands

    Отключает именованные команды. Используйте форму \* только, или используйте именованные команды только в начале строки, заканчивающейся точкой с запятой (;). mysql по умолчанию запускается с этой опцией включённой. Однако даже с этой опцией команды в длинном формате все ещё работают с первой строки. См. раздел 4.5.1.2, «Команды клиента mysql».

  • --enable-cleartext-plugin

    Формат командной строки --enable-cleartext-plugin
    Тип Булево
    Значение по умолчанию FALSE

    Включает подключаемый модуль аутентификации mysql_clear_password cleartext. (См. раздел 6.4.1.6, «Подключаемые модули аутентификации cleartext на стороне клиента».)

  • --execute=statement, -e statement

    Формат командной строки --execute=statement
    Тип Строка

    Выполнить оператор и выйти. Формат вывода по умолчанию аналогичен выводу с --batch. См. раздел 4.2.2.1, «Использование параметров в командной строке», для некоторых примеров. С этим параметром mysql не использует файл истории.

  • --force, -f

    Формат командной строки --force

    Продолжить, даже если произошла ошибка SQL.

  • --get-server-public-key

    Формат командной строки --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

    Формат командной строки --histignore=pattern_list
    Тип Строка

    Список одного или нескольких разделенных двоеточием шаблонов, определяющих операторы для игнорирования в целях протоколирования. Эти шаблоны добавляются к списку шаблонов по умолчанию ("*IDENTIFIED*:*PASSWORD*"). Указанное значение для этого параметра влияет на протоколирование операторов, записанных в файл истории, и в syslog, если задан параметр --syslog. Дополнительную информацию см. в разделе 4.5.1.3, «Протоколирование клиента mysql».

  • --host=host_name, -h host_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

    Формат командной строки --init-command=str

    Оператор SQL для выполнения после подключения к серверу. Если автоматическое переподключение включено, оператор выполняется снова после переподключения.

  • --line-numbers

    Формат командной строки --line-numbers
    Отключено skip-line-numbers

    Выводить номера строк для ошибок. Отключить это с помощью --skip-line-numbers.

  • --local-infile[={0|1}]

    Формат командной строки --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

    Формат командной строки --login-path=name
    Тип Строка

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

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

  • --max-allowed-packet=value

    Формат командной строки --max-allowed-packet=value
    Тип Числовой
    Значение по умолчанию 16777216

    Максимальный размер буфера для связи клиент/сервер. По умолчанию 16 МБ, максимальное значение 1 ГБ.

  • --max-join-size=value

    Формат командной строки --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

    Формат командной строки --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

    Не читать никакие файлы параметров. Если запуск программы терпит неудачу из-за чтения неизвестных параметров из файла параметров, --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_name в начало входных данных. Затем для каждого оператора USE, который встречается, 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]

    Формат командной строки --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

    Формат командной строки --plugin-dir=dir_name
    Тип Имя каталога

    Каталог, в котором следует искать плагины. Укажите этот параметр, если параметр --default-auth используется для указания плагина аутентификации, но mysql не находит его. Смотрите Раздел 6.2.13, «Подключаемая аутентификация».

  • --port=port_num, -P port_num

    Формат командной строки --port=port_num
    Тип Числовое значение
    Значение по умолчанию 3306

    Номер порта для подключений TCP/IP.

  • --print-defaults

    Формат командной строки --print-defaults

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

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

  • --prompt=format_str

    Формат командной строки --prompt=format_str
    Тип Строка
    Значение по умолчанию mysql>

    Установить приглашение в указанном формате. По умолчанию — mysql>. Специальные последовательности, которые может содержать приглашение, описаны в Разделе 4.5.1.2, «Команды клиента mysql».

  • --protocol={TCP|SOCKET|PIPE|MEMORY}

    Формат командной строки --protocol=type
    Тип Строка
    Значение по умолчанию [see text]
    Допустимые значения

    TCP

    SOCKET

    PIPE

    MEMORY

    Транспортный протокол для подключения к серверу. Полезно, когда другие параметры подключения приводят к использованию протокола, отличного от желаемого. Подробности допустимых значений см. в Разделе 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 для отключения экранирования:

    % mysql
    mysql> SELECT CHAR(92);
    +----------+
    | CHAR(92) |
    +----------+
    | \        |
    +----------+
    
    % mysql -s
    mysql> SELECT CHAR(92);
    CHAR(92)
    \\
    
    % mysql -s -r
    mysql> SELECT CHAR(92);
    CHAR(92)
    \
    
  • --reconnect

    Формат командной строки --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

    Формат командной строки --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

    Формат командной строки --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

    Формат командной строки --show-warnings

    Выводить предупреждения после каждой команды, если они есть. Этот параметр применим к интерактивному и пакетному режимам.

  • --sigint-ignore

    Формат командной строки --sigint-ignore

    Игнорировать сигналы SIGINT (обычно, результат нажатия Control+C).

    Без этого параметра нажатие Control+C прерывает текущую команду, если она есть, или отменяет частично введённую строку в противном случае.

  • --silent, -s

    Формат командной строки --silent

    Тихий режим. Выводить меньше вывода. Этот параметр можно указывать несколько раз для получения всё меньше и меньше вывода.

    Этот параметр приводит к нетабличному формату вывода и экранированию специальных символов. Экранирование можно отключить, используя режим без обработки; см. описание параметра --raw.

  • --skip-column-names, -N

    Формат командной строки --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, -L

    Формат командной строки --skip-line-numbers

    Не выводить номера строк для ошибок. Полезно при сравнении файлов результатов, содержащих сообщения об ошибках.

  • --socket=path, -S path

    Формат командной строки --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

    Формат командной строки --tee=file_name
    Тип Имя файла

    Добавить копию вывода в указанный файл. Этот параметр работает только в интерактивном режиме. Раздел 4.5.1.2, «Команды клиента mysql» более подробно рассматривает файлы tee.

  • --tls-version=protocol_list

    Формат командной строки --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, -u user_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.
https://docs.oracle.com/cd/E17952_01/mysql-5.7-en/mysql-command-options.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API