Перейти к содержанию
mantichora_/docs

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

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

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

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, — команда серая и с причиной.