Insights 管理コマンド

  • [アーティクル]

Insights 管理コマンドを使用すると、ユーザーはより細かく制御したり、データ システムに関する追加情報を収集したりできます。 このコマンドは、主に次の 2 つのカテゴリに分類されます。

  1. 管理 - これらのコマンドを使用すると、ユーザーは、クエリ、コマンド、リテンションに関する詳細情報を表示したり、リテンションを変更したりできます
  2. データ制御 - これらのコマンドを使用すると、ユーザーは、カスタム テーブルの作成と削除、ローカル データとクラウド データの取り込み、DB からのデータの消去を行うことができます

評価モードでは利用できないコマンドがあります。

カテゴリ コマンド
管理 .show queries
.show running queries
.show commands-and-queries
.show table policy retention
.alter table policy retention
データ コントロール .create table
.drop table
.set
.append
.set-or-append
.set-or-replace
.ingest into table
.purge table

管理

.show queries
ユーザー、別のユーザー、またはすべてのユーザーが現在実行しているクエリの一覧を返します。
使用法: .show queries
例: .show queries | where StartedOn > ago(1d)
これは、最後の日に実行されたすべてのクエリを表示します

.show running queries
現在実行中のクエリをすべて表示します
使用法: .show running queries
例: .show running queries
これは、現在実行中のクエリをすべて表示します

.show database policy caching
データベースの現在のキャッシュ ポリシーを表示します
使用法: .show database DatabaseName policy caching
例: .show database myDatabase policy caching
これは、指定したデータベースの現在のキャッシュ ポリシーを表示します。

.show table policy caching
テーブルの現在のキャッシュ ポリシーを表示します
使用法: .show database DatabaseName.TableName policy caching
例: .show database myDatabase.myTable policy caching
これは、指定したテーブルの現在のキャッシュ ポリシーを表示します。

.show commands-and-queries
最終的な状態に達した管理コマンドとクエリを含むテーブルを返します。 これらのコマンドとクエリは、30 日間クエリに使用できます。
使用法: .show commands-and-queries
例: .show commands-and-queries | where StartedOn > ago(1d) | where State != "Completed"
これは、最後の日に失敗したすべてのコマンドとクエリを表示します

.show table policy retention
クラスターとデータベースのルールを考慮に入れたテーブルの有効なアイテム保持ポリシーを表示します
使用法: .show table(s) (<table_name> [, ...]) policy retention
例: .show table ['events.all'] policy retention
これにより、"events.all" テーブルの現在のアイテム保持ポリシーが表示されます。

.alter table policy retention (従量課金モデルのアカウントに制限)
テーブルの現在のアイテム保持ポリシーを <retention_policy> に変更します
使用法: .alter tables (<table_name> [, ...]) policy retention <retention_policy>
例: .alter table ['events.all'] policy retention softdelete = 90d
これにより、"events.all" テーブルのデータが 90 日後にテーブルから削除されるように設定されます。

データ コントロール

.create テーブル (パフォーマンス レベル 2 以上に制限)
新しい空のテーブルを作成します。 コマンドは、特定のデータベースのコンテキストで実行する必要があります。 テーブルが既に存在する場合、コマンドは成功を返します。
使用法: .create table TableName ([columnName:columnType], ...)
例: .create table ['custom.logs'] (Level:string, Timestamp:datetime, Id:string, Message:string)
これにより、4 つの列を持つ "custom.logs" という名前の新しいテーブルが作成されます。 重要 カスタム テーブルは、"custom." で始まる必要があります。

.drop table (パフォーマンス レベル 2 以上に制限)
指定したテーブルを削除します。 注: これは元に戻すことはできません。
使用法: .drop table TableName [ifexists]
例: .drop table ['custom.logs']
これにより、"custom.logs" という名前のテーブルが削除されます。

.set (パフォーマンス レベル 2 以上に制限)
QueryOrCommand の結果を含むテーブルを作成します
使用法: .set TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
例: .set [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
これにより、上記のクエリの結果を含むテーブル "custom.recentEvents" が作成されます

.append (パフォーマンス レベル 2 以上に制限)
QueryOrCommand の結果を含む既存のテーブルを追加します
使用法: .append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
例: .append [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
これにより、上記のクエリの結果を含む既存のテーブル "custom.recentEvents" が追加されます

.set-or-append (パフォーマンス レベル 2 以上に制限)
QueryOrCommand の結果を含むテーブルを作成または追加します
使用法: .set-or-append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
例: .set-or-append [‘custom.weekEvents’] <| [‘events.all’] | where Timestamp > now() – time(7d)
これにより、上記のクエリのデータがテーブル "custom.weekEvents" に追加されます。 テーブルが存在しない場合は、作成します。

.set-or-replace (パフォーマンス レベル 2 以上に制限)
テーブルが存在する場合はそのデータを置き換えるか (既存のデータ シャードを削除します)、または存在しない場合はターゲット テーブルを作成します。 extend_schema または recreate_schema インジェスト プロパティのいずれかが true に設定されていない限り、テーブル スキーマは保持されます。 スキーマが変更された場合、これは独自のトランザクションでの実際のデータ インジェストの前に発生するため、データの取り込み失敗はスキーマが変更されなかったという意味にはなりません。
使用法: .set-or-replace TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
例: .set-or-replace [‘custom.dayEvents’] <| [‘events.all’] | where Timestamp > now() – time(1d)
これにより、テーブル "custom.dayEvents" のデータが上記のクエリに置き換えられます。

.ingest into (パフォーマンス レベル 2 以上に制限)
1 つ以上のクラウド ストレージ アーティファクトからデータを "プル" することによって、テーブルにデータを取り込みます。
使用法: .ingest into table TableName SourceDataLocator [with ( IngestionPropertyName = IngestionPropertyValue [, ...] )]
例: .ingest into table [‘custom.myData’] (h’<your url here>’) with(ignoreFirstRecord=true)
これにより、URL に一覧表示されているクラウド ストレージからテーブル "custom.myData" にデータがプッシュされます。

.purge table (パフォーマンス レベル 2 以上に制限)
テーブル内のデータをデータベースから完全に削除します
使用法: .purge table [TableName] in database [DatabaseName] allrecords with (noregrets='true')
例: .purge table [‘custom.toPurge’] in database MyDatabase allrecords
これにより、テーブル "custom.toPurge" からすべてのデータが消去され、データ システムから完全に削除されます。