インサイト管理コマンド

インサイト管理コマンドを使用すると、ユーザーはデータシステムの追加情報をさらに制御して収集することができます。 コマンドは、次の2つの主なカテゴリに分類されます。

  1. 管理-これらのコマンドでは、クエリ、コマンド、保持に関する詳細情報を表示したり、保持を変更したりすることができます。
  2. データコントロール-これらのコマンドでは、ユーザーがカスタムテーブルを作成および削除し、ローカルとクラウドのデータを取り込み、データベースからデータを消去することができます。

一部のコマンドは、評価モードでは使用できません。

Category コマンド
管理 . クエリを表示する
. 実行中のクエリの表示
. コマンドとクエリを表示する
. テーブルポリシーの保持を表示
. alter table policy の retention
データコントロール . テーブルを作成する
. ドロップテーブル
。設定
. append
. 設定-追加
. 設定-置換
. テーブルへの取り込み
. テーブルの削除

管理

. クエリを表示する
ユーザー、または他のユーザーによって、またはすべてのユーザーによって現在実行されているクエリのリストを返します。
用途: .show queries
例: .show queries | where StartedOn > ago(1d)
最後の日に実行されたすべてのクエリを表示します。

. 実行中のクエリの表示
現在実行されているすべてのクエリを表示する
用途: .show running queries
例: .show running queries
現在実行されているすべてのクエリを表示します。

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

. テーブルポリシーのキャッシュを表示する
テーブルの現在のキャッシュポリシーを表示します
用途: .show database DatabaseName.TableName policy caching
例: .show database myDatabase.myTable policy caching
指定されたテーブルの現在の cachingt ポリシーを示します。

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

. テーブルポリシーの保持を表示
クラスターとデータベースのルールを考慮して、テーブルの有効アイテム保持ポリシーが表示される
用途: .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
これにより、90日後にテーブルから削除される "events. all" テーブルのデータが設定されます。

データコントロール

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

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

. set (performance level 2/3 に制限されています)
クエリまたはコマンドの結果を含むテーブルを作成します
用途: .set TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
例: .set [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
上記のクエリの結果を含む "recentEvents" テーブルを作成します。

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

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

. [置換] (パフォーマンスレベルが2以上に制限されている)
テーブルのデータが存在する場合 (既存のデータ shards を削除します)、または存在しない場合はターゲットテーブルを作成します。 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)
これにより、"カスタムイベント" というテーブルのデータが上のクエリで置き換えられます。

. 取り込み(パフォーマンスレベルが2以上に制限されています)
1つまたは複数のクラウドストレージ成果物からデータを "プル" して、データをテーブルに Ingests します。
用途: .ingest into table TableName SourceDataLocator [with ( IngestionPropertyName = IngestionPropertyValue [, ...] )]
例: .ingest into table [‘custom.myData’] (h’<your url here>’) with(ignoreFirstRecord=true)
これにより、url に示されているクラウドストレージの "カスタム myData" のテーブルにデータがプッシュされます。

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