Перейти к содержанию
MantichoraДокументация

Выполнение запросов

Консоль отправляет по одному запросу — тот, что под курсором. Она спрашивает значения, которые запрос оставил открытыми, держит запись в транзакции, когда вам это нужно, и показывает план, по которому пошёл бы сервер.

Консоль дополняет колонку city из открытой схемы, пока набирается запрос Консоль дополняет колонку city из открытой схемы, пока набирается запрос

Как выполнить запрос

Ctrl+Enter (на Mac — ⌘Enter) или Выполнить на панели инструментов выполняет выражение под курсором — не выделение и не весь текст. Запросы делятся по ; так, как это делает язык самого соединения, поэтому ; внутри строки или комментария ничего не делит.

  • Курсор на ; относится к запросу, который эта ; завершает.
  • Комментарий прямо над запросом относится к нему.
  • Курсор в пустоте после последней ; выполняет последний запрос.

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

Выполнить всё

Выполнить всё — в меню «Запуск» и в палитре команд — отправляет запросы консоли по очереди, каждый отдельно, и опасный каждый раз переспросит. На первом же неудачном оно останавливается: Остановлено на запросе N и причина от сервера. Клавиши у этой команды нет, пока вы её не назначите.

Как остановить

Пока запрос выполняется, на панели инструментов есть Отмена; то же делает Ctrl+F2. В SQLite, DuckDB, SAP HANA и Arrow Flight SQL остановленная запись уничтожает всю свою транзакцию, поэтому там первое нажатие только предупреждает, а кнопка становится Всё равно отменить.

Параметры

Имя, записанное как :name или {{name}}, — это параметр. Окно Запрос просит значения показывает запрос с отмеченными именами и поле для каждого; сколько бы раз имя ни встречалось, спросят его один раз. Имена внутри строки, имени в кавычках, комментария или приведения :: в PostgreSQL не трогаются; ? и $1 параметрами здесь не считаются.

Каждое значение пойдёт прямо в запрос, экранированное так, как читает этот сервер. Пустое поле — это пустая строка, а не NULL: для него напишите в запросе is null. Выполнить отправляет запрос, Не запускать — нет.

Транзакции

Пока сеанс открыт, на панели инструментов видно, Как ложится запрос: Автофиксация или Ручная фиксация. В ручной фиксации пишущий запрос сначала открывает транзакцию; тогда панель пишет Транзакция открыта и сколько она длится, и показывает Зафиксировать (Ctrl+Alt+K) и Откатить (Ctrl+Alt+R). Начать есть в меню «База данных» и в палитре.

Новые сеансы фиксируют так, как сказано в Настройках → Соединение → Новые сеансы фиксируют, — автоматически, если не менять; продакшен-соединение всегда открывается в ручной фиксации. Сервер без транзакций от ручной фиксации откажется и скажет об этом.

Планы

План на панели инструментов или Ctrl+Shift+P спрашивает у сервера, как он выполнил бы запрос под курсором, и ничего не выполняет: вкладка План в результате рисует ответ деревом шагов со стоимостью и числом строк, которых ждёт сервер.

Проанализировать запрос, Ctrl+Alt+P, выполняет запрос, чтобы измерить каждый шаг, и поэтому сначала спрашивает: Анализ выполняет этот запрос. Выполнить? В его дереве добавятся строки, которые шаг действительно отдал, время и доля от всего.

План показывают PostgreSQL, MySQL, SQL Server, SQLite, Oracle, SAP HANA, ClickHouse, DuckDB и MongoDB; из них ClickHouse, SAP HANA, Oracle и SQLite не анализируют. Если сервер плана не пишет — как CockroachDB или TiDB, — команда серая и с причиной.