Spec-Zone.ru › MySQL Shell 9.2

5.7 Форматы вывода

  • 5.7.1 Табличный формат
  • 5.7.2 Формат с табуляцией
  • 5.7.3 Вертикальный формат
  • 5.7.4 Вывод в формате JSON
  • 5.7.5 Обертка JSON
  • 5.7.6 Метаданные результата

MySQL Shell может выводить результаты в табличном, табулированном или вертикальном формате, а также в формате JSON с красивым или сырым представлением. Параметр конфигурации MySQL Shell resultFormat может использоваться для задания любого из этих форматов в качестве постоянного значения по умолчанию для всех сессий или только для текущей сессии. Изменение этого параметра вступает в силу немедленно. Инструкции по настройке параметров конфигурации MySQL Shell см. в Разделе 14.4, «Настройка параметров конфигурации MySQL Shell». В качестве альтернативы, опция командной строки --result-format или её псевдонимы (--table, --tabbed, --vertical) могут использоваться при запуске для задания формата вывода для сессии. Список опций командной строки см. в Разделе A.1, «mysqlsh — MySQL Shell».

Если параметр конфигурации resultFormat не задан, то в интерактивном режиме MySQL Shell по умолчанию выводит результаты в формате отформатированной таблицы, а в пакетном режиме — в формате с табуляцией. При установке значения по умолчанию с помощью параметра конфигурации resultFormat, это значение по умолчанию применяется как в интерактивном, так и в пакетном режимах.

Функция MySQL Shell shell.dumpRows() может форматировать набор результатов, возвращаемый запросом, в любом из поддерживаемых MySQL Shell форматов вывода и выводить его в консоль. (Обратите внимание, что набор результатов потребляется функцией.)

Для интеграции MySQL Shell с внешними инструментами, можно использовать опцию --json для управления оберткой JSON для всего вывода MySQL Shell при запуске MySQL Shell из командной строки. При включённой обертке JSON, MySQL Shell генерирует либо красиво отформатированный JSON (по умолчанию), либо сырой JSON, а значение параметра конфигурации resultFormat MySQL Shell игнорируется. При выключенной обертке JSON или если она не запрошена для сессии, наборы результатов выводятся в обычном формате, заданном параметром конфигурации resultFormat.

Параметр конфигурации outputFormat устарел. Этот параметр объединял функции обертки JSON и вывода результатов. Если этот параметр всё ещё указан в файле конфигурации или скриптах MySQL Shell, поведение будет следующим:

  • С значением json или json/raw, outputFormat активирует обертывание JSON с красивым или сырым JSON, соответственно.

  • С значением table, tabbed или vertical, outputFormat отключает обертывание JSON и устанавливает параметр конфигурации resultFormat для сессии в соответствующее значение.

© 2025 Oracle
Licensed under the GPLv2 License.
https://docs.oracle.com/cd/E17952_01/mysql-shell-9.2-en/mysql-shell-output-formats.html

Spec-Zone.ru

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