通过

.set stored_query_result 命令

  • 项目

适用于：✅Azure 数据资源管理器

设置在服务上存储查询结果最多 24 小时的机制。

如果已存在存储的查询结果名称，.set 将失败。 请改用 .set-or-replace，这会删除现有的存储查询结果，并创建同名的新存储查询结果。

权限

你必须至少具有数据库查看者权限才能运行这些命令。

语法

.set [async] stored_query_result StoredQueryResultName [with (PropertyName = PropertyValue [, ...])] <| Query

.set-or-replace [async] stored_query_result StoredQueryResultName [with (PropertyName = PropertyValue [, ...])] <| Query

详细了解语法约定。

参数

客户 类型​​ 必需 说明
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
...

相关内容