你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

.set stored_query_result 命令

设置一种机制，用于在服务上存储查询结果长达 24 小时。

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

权限

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

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

.set-or-replace [async] stored_query_resultStoredQueryResultName [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

输出