Share via

Команда SET stored_query_result

  • Статья

Задает механизм, который хранит результаты запроса в службе в течение 24 часов.

Если сохраненное имя результата запроса уже существует, происходит сбой .set . Вместо этого используйте .set-or-replace, который удаляет существующий сохраненный результат запроса и создает новый с тем же именем.

Разрешения

Для выполнения этих команд необходимо иметь разрешения на просмотр баз данных .

Синтаксис

.set [async] stored_query_resultStoredQueryResultName [with(PropertyName=PropertyValue [, ...])] <|Запроса

.set-or-replace [async] stored_query_resultStoredQueryResultName [with(PropertyName=PropertyValue [, ...])] <|Запроса

Дополнительные сведения о соглашениях о синтаксисе.

Параметры

Имя Тип Обязательно Описание
async string Если этот параметр указан, команда вернет и продолжит прием в фоновом режиме. Используйте возвращаемый OperationId с командой .show operations , чтобы получить состояние завершения приема и результаты.
StoredQueryResultName string ✔️ Сохраненное имя результата запроса, которое соответствует правилам имен сущностей .
PropertyName, PropertyValue string Одно или несколько поддерживаемых свойств.
Запрос string ✔️ Текст запроса, результаты которого будут сохранены.

Поддерживаемые свойства

Свойство Тип Описание
expiresAfter timespan Определяет, когда истечет срок действия сохраненного результата запроса. Максимум — 24 часа.
previewCount int Количество строк, возвращаемых в предварительном просмотре. Если присвоить этому свойству значение 0 (по умолчанию), команда возвращает все строки результатов запроса. Свойство игнорируется при вызове команды в async режиме .

Возвращаемое значение

Табличное подмножество записей, созданных запросом, называемое предварительным просмотром, или все записи. Независимо от количества записей, отображаемых при возврате, сохраняются все записи.

Ограничение символов

Команда завершается ошибкой, если запрос создает имя сущности с символом $ . Имена сущностей должны соответствовать правилам именования, поэтому $ символ должен быть удален для успешного выполнения команды приема.

Например, в следующем запросе search оператор создает столбец $table. Чтобы сохранить результаты запроса, используйте project-rename , чтобы переименовать столбец.

.set stored_query_result Texas <| search ['State']:'Texas' | project-rename tableName=$table

Примеры

В следующем примере создается сохраненный результат запроса с именем Numbers.

.set stored_query_result Numbers <| range X from 1 to 1000000 step 1

Выходные данные

X
1
2
3
...

См. также