.set stored_query_result コマンド
サービスにクエリ結果を最大 24 時間格納するメカニズムを設定します。
格納されているクエリ結果名が既に存在する場合、 .set は失敗します。 代わりに、既存の格納されているクエリ結果を削除し、同じ名前の新しいクエリ結果を作成する .set-or-replaceを使用します。
アクセス許可
これらのコマンドを実行するには、 Database Viewer アクセス許可が必要です。
構文
.set [async] stored_query_result StoredQueryResultName [with (PropertyName = PropertyValue [, ...])] <| クエリ
.set-or-replace [async] stored_query_result StoredQueryResultName [with (PropertyName = PropertyValue [, ...])] <| クエリ
構文規則について詳しく知る。
パラメーター
| 件名 | タイプ | Required | 説明 |
|---|---|---|---|
async |
string |
指定した場合、コマンドはバックグラウンドでインジェストを返して続行します。 .show operations コマンドで返されたOperationIdを使用して、インジェストの完了状態と結果を取得します。 |
|
| StoredQueryResultName | string |
✔️ | エンティティ名ルールに準拠する格納されたクエリ結果名。 |
| PropertyName、 PropertyValue | string |
1 つ以上の サポートされるプロパティ。 | |
| クエリ | 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 |
| ... |