Show/Hide Toolbars

Руководство администратора

Выполнить SQL запрос

Ссылки Назад Вверх Вперед

warning_icon Возможность работать с SQL напрямую из интерфейса системы по умолчанию отключена. Чтобы данная страница была доступна в интерфейсе администратора, в файле web.config (appsettings.json) должна быть отключена опция disableSQLShell. См. Руководство по техподдержке.

Вы можете проверить правильность SQL-запроса, посмотреть данные из БД, создать или изменить хранимую процедуру непосредственно из режима администрирования "Первой Формы", без необходимости переходить в графический клиент работы с SQL.

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

exec_sql-02

Просмотр результатов выполнения запроса

При выполнении скрипта блоке результата отображается время выполнения запроса в миллисекундах. Индикаторы рядом с временем классифицируют скорость выполнения:

Зеленый индикатор сигнализирует о нормальном значении времени выполнения: до 50 миллисекунд.

Желтый индикатор указывает на среднее значение: от 50 до 200 миллисекунд.

Красный индикатор сигнализирует о большом значении времени выполнения: от 200 миллисекунд и более.

В случае timeout отображается текст "Время ожидания ответа истекло".

Если в окне запроса введен текст хранимой процедуры с ключевым словом CREATE, процедура создается в БД, а если со словом ALTER, то в БД сохраняются изменения, внесенные в текст процедуры.

Чтобы посмотреть результаты выполнения хранимой процедуры используйте запрос exec [имя процедуры].

Чтобы посмотреть текст хранимой процедуры, используйте запрос exec sp_helptext 'имя процедуры'.

warning_icon  Если для отсутствия указывается статус, отличный от "Свободен", то имя пользователя в системе отображается курсивом, а цвет выбирается в зависимости от типа отсутствия.

IntelliSense

Функция IntelliSense помогает ускорить процесс написания запросов, предоставляя подсказки, автозаполнение, и дополнительную информацию. Начните вводить название категории и система предложит вам доступные варианты:

exec_sql-05

Предложенные варианты объектов БД

Справа от названия выделенного объекта в списке отображается кнопка информации — нажатие на нее отображает название категории с указанием ее ID.

Используйте стрелки вверх/вниз, чтобы выбрать нужный вариант из списка. Выберите вариант кликом мыши или нажмите Enter, чтобы вставить выбранный вариант в запрос.

Добавление точки после названия категории автоматически раскроет список всех доступных параметров в ней.

exec_sql-06

Список параметров в категории

Справа от названия дополнительного параметра в списке отображается кнопка информации — нажатие на нее отображает название параметра с указанием его ID. Кнопка информации не отображается для системных параметров.

Используйте стрелки вверх/вниз, чтобы выбрать нужный параметр из списка, для добавления параметра в запрос выберите вариант кликом мыши или нажмите Enter.

warning_icon  Функция Intellisense учитывает особенности синтаксиса PostgreSQL

План запроса

В соответствующей вкладке достуен план выполненного запроса.

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

exec_sql-03

План запроса

При наведении курсора на элементы плана пользователи могут увидеть дополнительную информацию, такую как: стоимость выполнения (оценка ресурсов, необходимых для выполнения каждого этапа запроса), количество возвращаемых строк на каждом этапе, используемые индексы, операции соединения и т.д.

exec_sql-04

Дополнительная информация

Сообщения

При добавлении (insert) и обновлении данных (update) в БД в блоке отображения результатов становится доступна вкладка Сообщения, в которой выводится количество измененных строк.

exec_sql-07

Сообщения

Строка подключения (ConnectionString)

По умолчанию для выполнения SQL запросов в качестве строки подключения (ConnectionString) используется "TCConnectionString".

В системе есть возможность указать отдельную учетную запись для выполнения TSQL-выражений. В системном файле приложения appsettings.json / web.config для этого предназначен ключ SmartConnectionString. Если значение указано в ключе, то TSQL-выражения будут выполняться под заданной строкой подключения.