.set stored_query_result 命令
適用於： ✅Microsoft網狀架構✅Azure 數據總管
設定將查詢結果儲存在服務上最多 24 小時的機制。
如果預存的查詢結果名稱已經存在，則 .set 失敗。 .set-or-replace請改用 ，以刪除現有的預存查詢結果，並建立具有相同名稱的新查詢結果。
權限
您必須具有 資料庫查看器 許可權，才能執行這些命令。
語法
.set[async] stored_query_result StoredQueryResultName [ PropertyName = PropertyValue [, (with ...]] <| )查詢
.set-or-replace[async] stored_query_result StoredQueryResultName [ PropertyName = PropertyValue [, (with ...]] <| )查詢
深入瞭解 語法慣例。
參數
| 姓名 | 類型 | 必要 | 描述 |
|---|---|---|---|
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 |
| ... |