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