.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

输出

X
1
2
3
...

相关内容

• .show stored_query_result 命令。
• .drop stored_query_result 命令。
• stored_query_result()。