次の方法で共有

Insights 管理コマンド

  • [アーティクル]

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

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

注意

PlayFab Insights Management は、2023 年 12 月 11 日に非推奨になりました。 今後のパフォーマンスとコストを管理するには、Azure Data Explorer (ADX) 接続を使用することをお勧めします。 タイトルがまだ Insights の場合は、管理コマンドについてこの記事を引き続き参照してください。 詳細については、「Insights 非推奨に関するブログ」を参照してください。

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

カテゴリ コマンド
管理 .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 (従量課金モデルのアカウントに制限)
1 つ以上のテーブルの現在のアイテム保持ポリシーを <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" からすべてのデータを消去し、データ システムから完全に削除します。