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

Команда .set stored_query_result

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

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

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

Заметка

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

Разрешения

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

Синтаксис

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

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

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

Параметры

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

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

Свойство Тип Описание
expiresAfter timespan Определяет, когда истекает срок действия результата хранимого запроса. Максимальное значение — 24 часа.
previewCount int Количество строк, возвращаемых в предварительной версии (значение по умолчанию — 10K). При задании этого свойства 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
...

Связанный контент