Команда .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 |
... |
Связанный контент
- Команда .show stored_query_result.
- Команда .drop stored_query_result.
- stored_query_result().