Spec-Zone.ru › MySQL 8.4

6.5.6 mysqlshow — Отображение информации о базах данных, таблицах и столбцах

Клиент mysqlshow может быть использован для быстрого просмотра имеющихся баз данных, их таблиц или столбцов и индексов таблицы.

mysqlshow предоставляет интерфейс командной строки для нескольких SQL SHOW операторов. См. Раздел 15.7.7, «Операторы SHOW». Ту же информацию можно получить, используя эти операторы напрямую. Например, вы можете выполнить их из программы-клиента mysql.

Вызов mysqlshow выглядит следующим образом:

mysqlshow [options] [db_name [tbl_name [col_name]]]
  • Если база данных не указана, отображается список имён баз данных.

  • Если таблица не указана, отображаются все соответствующие таблицы в базе данных.

  • Если столбец не указан, отображаются все соответствующие столбцы и типы данных столбцов в таблице.

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

Если последний аргумент содержит символы подстановки оболочки или SQL (*, ?, % или _), отображаются только те имена, которые соответствуют шаблону подстановки. Если имя базы данных содержит нижнее подчеркивание, его следует экранировать обратной косой чертой (некоторые оболочки Unix требуют две) для получения списка соответствующих таблиц или столбцов. * и ? символы преобразуются в SQL % и _ символы подстановки. Это может вызвать некоторое недопонимание при попытке отобразить столбцы для таблицы с _ в имени, так как в этом случае mysqlshow покажет вам только имена таблиц, которые соответствуют шаблону. Это легко исправить, добавив дополнительный % в качестве отдельного аргумента в конце командной строки.

mysqlshow поддерживает следующие опции, которые могут быть указаны в командной строке или в группах [mysqlshow] и [client] файла опций. Сведения о файлах опций, используемых программами MySQL, см. в Разделе 6.2.2.2, «Использование файлов опций».

Таблица 6.15 Параметры mysqlshow

Таблица 6.15 Параметры mysqlshow
Название параметра Описание
--bind-address Использование указанного сетевого интерфейса для подключения к MySQL Server
--character-sets-dir Директория, где можно найти наборы символов
--compress Сжатие всей информации, передаваемой между клиентом и сервером
--compression-algorithms Разрешенные алгоритмы сжатия для подключений к серверу
--count Показать количество строк в каждой таблице
--debug Запись отладочного журнала
--debug-check Вывод отладочной информации при выходе программы
--debug-info Вывод отладочной информации, статистики памяти и ЦП при выходе программы
--default-auth Плагин аутентификации для использования
--default-character-set Указать набор символов по умолчанию
--defaults-extra-file Чтение указанного файла параметров дополнительно к обычным файлам параметров
--defaults-file Чтение только указанного файла параметров
--defaults-group-suffix Значение суффикса группы параметров
--enable-cleartext-plugin Включить плагин аутентификации с открытым текстом
--get-server-public-key Запрос RSA открытого ключа от сервера
--help Отображение сообщения справки и выход
--host Хост, на котором расположен сервер MySQL
--keys Показать индексы таблиц
--login-path Чтение параметров пути входа из .mylogin.cnf
--no-defaults Не читать файлы параметров
--no-login-paths Не читать пути входа из файла пути входа
--password Пароль для подключения к серверу
--password1 Первый пароль многофакторной аутентификации для подключения к серверу
--password2 Второй пароль многофакторной аутентификации для подключения к серверу
--password3 Третий пароль многофакторной аутентификации для подключения к серверу
--pipe Подключение к серверу с использованием именованной трубы (только Windows)
--plugin-dir Директория, в которой установлены плагины
--port Номер TCP/IP порта для подключения
--print-defaults Вывод параметров по умолчанию
--protocol Используемый транспортный протокол
--server-public-key-path Имя пути к файлу, содержащему RSA открытый ключ
--shared-memory-base-name Имя общей памяти для подключений с общей памятью (только Windows)
--show-table-type Показать столбец, указывающий тип таблицы
--socket Файл Unix-сокет или именованная труба Windows для использования
--ssl-ca Файл, содержащий список доверенных центров сертификации SSL
--ssl-capath Директория, содержащая файлы сертификатов доверенных центров сертификации SSL
--ssl-cert Файл, содержащий сертификат X.509
--ssl-cipher Разрешенные шифры для шифрования соединения
--ssl-crl Файл, содержащий списки отзыва сертификатов
--ssl-crlpath Директория, содержащая файлы списков отзыва сертификатов
--ssl-fips-mode Включать ли режим FIPS на стороне клиента
--ssl-key Файл, содержащий ключ X.509
--ssl-mode Желаемое состояние безопасности соединения с сервером
--ssl-session-data Файл, содержащий данные сессии SSL
--ssl-session-data-continue-on-failed-reuse Устанавливать ли подключения, если повторное использование сессии завершилось неудачей
--status Отображение дополнительной информации о каждой таблице
--tls-ciphersuites Разрешенные TLSv1.3 наборы шифров для зашифрованных подключений
--tls-sni-servername Имя сервера, предоставленное клиентом
--tls-version Разрешенные протоколы TLS для зашифрованных подключений
--user Имя пользователя MySQL для подключения к серверу
--verbose Режим подробного вывода
--version Отображение информации о версии и выход
--zstd-compression-level Уровень сжатия для подключений к серверу, использующих сжатие zstd

  • --help, -?

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

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

  • --bind-address=ip_address

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

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

  • --character-sets-dir=dir_name

    Формат командной строки --character-sets-dir=path
    Тип Строка
    Значение по умолчанию [none]

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

  • --compress, -C

    Формат командной строки --compress[={OFF|ON}]
    Устарело Да
    Тип Булево
    Значение по умолчанию OFF

    Сжимать всю информацию, передаваемую между клиентом и сервером, если это возможно. См. Раздел 6.2.8, «Управление сжатием соединения».

    Этот параметр устарел. Ожидается, что он будет удален в будущей версии MySQL. См. Настройка устаревшего сжатия соединения.

  • --compression-algorithms=value

    Формат командной строки --compression-algorithms=value
    Тип Множество
    Значение по умолчанию uncompressed
    Допустимые значения

    zlib

    zstd

    uncompressed

    Разрешенные алгоритмы сжатия для подключений к серверу. Доступные алгоритмы такие же, как и для переменной системы protocol_compression_algorithms. Значение по умолчанию — uncompressed.

    Дополнительная информация находится в Разделе 6.2.8, «Управление сжатием соединения».

  • --count

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

    Показать количество строк в каждой таблице. Это может быть медленно для не-MyISAM таблиц.

  • --debug[=debug_options], -# [debug_options]

    Формат командной строки --debug[=debug_options]
    Тип Строка
    Значение по умолчанию d:t:o

    Записывать в журнал отладки. Типичная строка debug_options — d:t:o,file_name. По умолчанию — d:t:o.

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

  • --debug-check

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

    Выводить отладочную информацию при завершении программы.

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

  • --debug-info

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

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

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

  • --default-character-set=charset_name

    Формат командной строки --default-character-set=charset_name
    Тип Строка

    Использовать charset_name в качестве набора символов по умолчанию. См. Раздел 12.15, «Настройка наборов символов».

  • --default-auth=plugin

    Формат командной строки --default-auth=plugin
    Тип Строка

    Указание о том, какой плагин проверки подлинности клиента использовать. См. Раздел 8.2.17, «Подключаемая проверка подлинности».

  • --defaults-extra-file=file_name

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

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

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

  • --defaults-file=file_name

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

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

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

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

  • --defaults-group-suffix=str

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

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

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

  • --enable-cleartext-plugin

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

    Включить плагин явного текста mysql_clear_password для аутентификации. (См. Раздел 8.4.1.4, «Клиентская явная аутентификация с помощью плагинов».)

  • --get-server-public-key

    Формат командной строки --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.2, «Кэширующая аутентификация SHA-2 с помощью плагинов».

  • --host=host_name, -h host_name

    Формат командной строки --host=host_name
    Тип Строка
    Значение по умолчанию localhost

    Подключение к серверу MySQL на заданном хосте.

  • --keys, -k

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

    Отображение индексов таблиц.

  • --login-path=name

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

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

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

  • --no-login-paths

    Формат командной строки --no-login-paths

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

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

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

  • --no-defaults

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

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

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

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

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

    Формат командной строки --password[=password]
    Тип Строка

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

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

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

  • --password1[=pass_val]

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

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

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

    --password1 и --password являются синонимами, как и --skip-password1 и --skip-password.

  • --password2[=pass_val]

    Пароль для фактора многофакторной аутентификации 2 учетной записи MySQL, используемой для подключения к серверу. Семантика этого параметра аналогична семантике для --password1; см. описание этого параметра для получения подробной информации.

  • --password3[=pass_val]

    Пароль для фактора многофакторной аутентификации 3 учетной записи MySQL, используемой для подключения к серверу. Семантика этого параметра аналогична семантике для --password1; см. описание этого параметра для получения подробной информации.

  • --pipe, -W

    Формат командной строки --pipe
    Тип String

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

  • --plugin-dir=dir_name

    Формат командной строки --plugin-dir=dir_name
    Тип Directory name

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

  • --port=port_num, -P port_num

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

    Для TCP/IP-соединений номер порта, который нужно использовать.

  • --print-defaults

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

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

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

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

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

    TCP

    SOCKET

    PIPE

    MEMORY

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

  • --server-public-key-path=file_name

    Формат командной строки --server-public-key-path=file_name
    Тип 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.3, «Подключаемая аутентификация SHA-256» и Раздел 8.4.1.2, «Кэшируемая подключаемая аутентификация SHA-2».

  • --shared-memory-base-name=name

    Формат командной строки --shared-memory-base-name=name
    Специфично для платформы Windows

    В Windows имя разделяемой памяти, используемое для соединений, выполненных с использованием разделяемой памяти с локальным сервером. Значение по умолчанию — MYSQL. Имя разделяемой памяти чувствительно к регистру.

    Этот параметр применяется только в том случае, если сервер был запущен с включенной системной переменной shared_memory для поддержки подключений с использованием разделяемой памяти.

  • --show-table-type, -t

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

    Показать столбец, указывающий тип таблицы, как в SHOW FULL TABLES. Тип — BASE TABLE или VIEW.

  • --socket=path, -S path

    Формат командной строки --socket={file_name|pipe_name}
    Тип String

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

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

  • --ssl*

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

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

    Формат командной строки --ssl-fips-mode={OFF|ON|STRICT}
    Устарело Да
    Тип Перечисление
    Значение по умолчанию OFF
    Допустимые значения

    OFF

    ON

    STRICT

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

    Допускаются следующие значения --ssl-fips-mode:

    • OFF: Отключить режим FIPS.

    • ON: Включить режим FIPS.

    • STRICT: Включить строгий режим “strict” FIPS.

    Примечание

    Если модуль объектов OpenSSL FIPS недоступен, единственным допустимым значением для --ssl-fips-mode является OFF. В этом случае установка --ssl-fips-mode в значение ON или STRICT приводит к тому, что клиент выдает предупреждение при запуске и работает в не-FIPS режиме.

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

  • --status, -i

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

    Отобразить дополнительную информацию о каждой таблице.

  • --tls-ciphersuites=ciphersuite_list

    Формат командной строки --tls-ciphersuites=ciphersuite_list
    Тип Строка

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

  • --tls-sni-servername=server_name

    Формат командной строки --tls-sni-servername=server_name
    Тип Строка

    При указании имя передается в библиотеку API libmysqlclient C с использованием параметра MYSQL_OPT_TLS_SNI_SERVERNAME. Имя сервера не чувствительно к регистру. Чтобы узнать, какое имя сервера указал клиент для текущего сеанса, если таковое имеется, проверьте переменную состояния Tls_sni_server_name.

    Указание имени сервера (SNI) является расширением протокола TLS (OpenSSL должен быть скомпилирован с использованием расширений TLS, чтобы этот параметр работал). Реализация SNI в MySQL представляет только сторону клиента.

  • --tls-version=protocol_list

    Формат командной строки --tls-version=protocol_list
    Тип Строка
    Значение по умолчанию

    TLSv1,TLSv1.1,TLSv1.2,TLSv1.3 (OpenSSL 1.1.1 или выше)

    TLSv1,TLSv1.1,TLSv1.2 (в противном случае)

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

  • --user=user_name, -u user_name

    Формат командной строки --user=user_name,
    Тип Строка

    Имя пользователя учетной записи MySQL, используемой для подключения к серверу.

  • --verbose, -v

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

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

  • --version, -V

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

    Отобразить информацию о версии и завершить работу.

  • --zstd-compression-level=level

    Формат командной строки --zstd-compression-level=#
    Тип Целое число

    Уровень сжатия, используемый для соединений с сервером, которые используют алгоритм сжатия zstd. Допустимые уровни — от 1 до 22, при этом большие значения указывают на возрастающие уровни сжатия. Уровень сжатия по умолчанию zstd равен 3. Настройка уровня сжатия не влияет на соединения, которые не используют сжатие zstd.

    Для получения дополнительной информации см. Раздел 6.2.8, «Управление сжатием соединения».

© 2025 Oracle
Licensed under the GPLv2 License.
https://docs.oracle.com/cd/E17952_01/mysql-8.4-en/mysqlshow.html

Spec-Zone.ru

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