Вкладка «Кластеры»#

Сценарии, доступные операторам с ролью ПОЛЬЗОВАТЕЛЬ SQL-РЕДАКТОРА:

• основные:

  • Создание конфигурации кластера

  • Создание конфигурации кластера из шаблона

  • Изменение конфигурации кластера

  • Удаление конфигурации кластера

  • Получение списка кластеров и шаблонов

  • Открытие подключения к БД

  • Выполнение SQL-запросов к БД

  • Просмотр структуры БД

• дополнительные:

  • Просмотр истории выполненных запросов

  • Получение уведомлений, выполненных с помощью функции LISTEN/NOTIFY

  • Выполнение команды с Explain

  • Получение информации об объектах БД

Также в разделе приведены:

• Описание интерфейса вкладки «Кластеры»

  • Вспомогательное меню вкладки «Кластеры»

  • Рабочая область вкладки «Кластеры»

  • SQL-редактор

• Клавиатурные сокращения

Описание вкладки «Кластеры»#

Вкладка Кластеры предназначена для:

• навигации между кластерами;

• управления объектами кластеров в Kintsugi: создание, изменение, удаление;

• взаимодействия с БД, используя SQL-редактор.

Оконная форма вкладки Кластеры делится на две части:

• Вспомогательное меню;

• Рабочая область. При открытии основной вкладки Кластеры будет пустой.

Вспомогательное меню вкладки «Кластеры»#

Внешний вид вспомогательного меню Кластеры:

Вспомогательное меню имеет три основные вкладки:

Активная вкладка выделяется цветом и подчеркиванием.

Краткое описание элементов вспомогательного меню:

В Строке меню (13) пользователю доступны следующие команды:

Рабочая область вкладки «Кластеры»#

В зависимости от выполненной команды во вспомогательном меню выводит форму:

• Создание подключений;

• Редактирование подключений;

• Удаление подключений;

• Настройки;

• панели SQL-редактора;

• свойства объектов, выбранных во вкладке Структура БД.

SQL-редактор#

Выполнение запросов к БД осуществляется в SQL-редакторе.

Основные функции SQL-редактора:

• выполнение произвольной команды SQL;

• отображение текущего состояние подключения и транзакции;

• просмотр плана выполнения инструкции SQL в текстовом, графическом или табличном формате.

На рисунке представлен внешний вид рабочей области SQL-редактора.

Визуально экранная форма SQL-редактора поделена на три блока:

• Статус бар (А) – отображает статусы для текущего подключения к СУБД;

• Рабочая область (Б) – панель для ввода SQL-команды. Обладает следующими возможностями: автонумерация строк, подсветка синтаксиса, автодополнение кода согласно SQL-стандарту PostgreSQL, Мини-карта (3), контекстное меню, дублирующие функции редактирования и исполнения, отображение ошибок в команде;

• Результат (В) – Панель вывода результатов выполнения SQL-команды отображает данные, полученные в результате выполнения последней команды.

СУБД PostgreSQL предполагает, что функциональность autocommit выполняется на клиентской стороне. Стандартное поведение PostgreSQL – это фиксация каждой транзакции после ее выполнения. Поэтому для того, чтобы отключить autocommit, необходимо явным образом открыть транзакцию, выполнив одну из команд (BEGIN, START TRANSACTION).

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

Блок «Статус бар»#

Содержит следующую информацию:

• Имя пользователя;

• Имя базы данных;

• Статус подключения. Выводится один из вариантов: Отключен, Подключение, Ожидает действия или Подключен;

• Статус выполнения запроса. Выводится статус сессии СУБД: Idle (idle in transaction) или Ожидает действия.

Блок «Рабочая область»#

Состоит из:

• панель Строка меню (1). Содержит перечень команд, которые можно выполнить в Рабочей области:

  Название	Иконка	Описание
  Отмена / Возврат	/	Позволяет отменить последнее изменение кода и вернуться на предыдущую версию по цепочке изменений. Возврат действует аналогично, но позволяет вернуть отмененное действие
  Отформатировать код		Форматирует структуру SQL-кода для лучшей читаемости
  Закомментировать строку		Комментирует выбранный участок кода
  Очистить		Очищает рабочую область SQL-редактора
  Переподключиться		Осуществляет попытку переподключения текущей сессии
  Коммит		Выполняет коммит текущей открытой транзакции
  Откатить		Выполняет откат текущей открытой транзакции
  Остановить		Останавливает выполнение запущенного ранее блока кода
  Запроc		Выполняет выбранный блок кода
  Explain		Выполняет Explain над выбранным блоком кода
  Полный экран		Раскрывает SQL-редактор на весь экран

• Контекстное меню (2). Вызывается правой кнопкой мыши в рабочей области SQL-редактора. Содержит следующие команды:

  Название	Описание
  Запрос Коммит Откатить Остановить	Дублируют функции редактирования SQL-кода, приведенные на панели Строка меню (1)
  Change All Occurrences	Изменяет все вхождения текста
  Format Document	Автоматически форматирует весь код согласно SQL-стандарту PostgreSQL
  Format Selection	Автоматически форматирует выделенную часть кода согласно SQL-стандарту PostgreSQL
  Cut Copy Paste	Набор функций для работы приложений с буфером обмена
  Command Palette	Вызывает командную строку

• панель навигации Мини-карта (3) – обеспечивает навигацию по коду. Включение и отключение отображения мини-карты в рабочей области SQL-редактора описано в пункте «Настройка вкладки «Кластеры»» раздела «Параметры настройки».

Блок «Результат»#

Выводит информацию в одном из трех форматов:

• табличное представление в случае стандартного выполнения;

• результат Explain в виде tree-диаграммы, табличного представления или JSON-документа в интерфейсе пользователя;

• строка с сообщением об ошибке.

В тех случаях, когда у нас в блоке Результат выводится больше десяти строк информации, для отображения оставшейся части необходимо:

1. Задать значение в поле Следующее количество строк.

2. Нажать кнопку Загрузить (4).

Клавиатурные сокращения#

В таблице представлены клавиатурные сокращения, необходимые для работы в SQL-редакторе.