Поделиться через


Команда .set stored_query_result

Область применения: ✅Microsoft Fabric✅Azure Data Explorer

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

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

Разрешения

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

Синтаксис

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

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

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

Параметры

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

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

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

Возвраты

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

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

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

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

.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
...