.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

输出