フォロワー コマンド

[ バージョン ] ドロップダウン リストを使用してサービスを切り替えます。 ナビゲーションの詳細を確認します。
適用対象: Azure Data Explorer ✅

フォロワー構成を管理するための管理コマンド。 これらのコマンドは同期的に実行されますが、次回の定期的なスキーマ更新で適用されるため、新しい構成が適用されるまで短い遅延が発生する可能性があります。

フォロワー コマンドには、 データベース レベルのコマンド と テーブル レベルのコマンドが含まれます。

Permissions

このコマンドを実行するには、少なくとも データベース管理者 アクセス許可が必要です。

データベース ポリシーのオーバーライド

リーダー データベースは、フォロワー クラスター内のデータベース レベルのポリシーである キャッシュ ポリシー と 承認されたプリンシパルをオーバーライドできます。

キャッシュ ポリシー

フォロワー クラスターの既定の キャッシュ ポリシー では、リーダー クラスター データベースとテーブル レベルのキャッシュ ポリシーが使用されます。

承認されたプリンシパル

テーブルビューと具体化されたビューポリシーのオーバーライド

既定では、フォロワー クラスターの後に続くデータベース内のテーブルと具体化されたビューは、ソース エンティティのキャッシュ ポリシーを保持します。 ただし、テーブルおよび具体化されたビュー のキャッシュ ポリシー は、フォロワー クラスターでオーバーライドできます。 replace オプションを使用して、ソース エンティティのキャッシュ ポリシーをオーバーライドします。

データベース レベルのコマンド

.show follower データベース

1 つ以上のデータベース レベルのオーバーライドが構成されている他のリーダー クラスターから続くデータベース (またはデータベース) を表示します。

構文

.show follower database Databasename

.show follower databases ( DatabaseName1,...,DatabaseNameN)

アウトプット

.alter follower データベース ポリシーのキャッシュ

リーダー クラスター内のソース データベースのセットをオーバーライドするために、フォロワー データベース キャッシュ ポリシーを変更します。

Notes

• キャッシュ ポリシーの既定の modification kind は unionです。 modification kindを変更するには、.alter follower database caching-policies-modification-kind コマンドを使用します。
• 変更後のポリシーまたは有効なポリシーの表示は、 .show コマンドを使用して実行できます。
  • .show database policy retention
  • .show database details
  • .show table details
• 変更後にフォロワー データベースのオーバーライド設定を表示するには、 .show follower database

構文

.alter follower database DatabaseNamepolicycachinghot=HotDataSpan

例

.alter follower database MyDb policy caching hot = 7d

.delete フォロワー データベース ポリシーのキャッシュ

フォロワー データベースのオーバーライド キャッシュ ポリシーを削除します。 この削除により、リーダー クラスター内のソース データベースに設定されたポリシーが有効になります。

Notes

• 変更後のポリシーまたは有効なポリシーの表示は、 .show コマンドを使用して実行できます。
  • .show database policy retention
  • .show database details
  • .show table details
• 変更後にフォロワー データベースのオーバーライド設定を表示するには、 .show follower database

構文

.delete follower database Databasenamepolicycaching

例

.delete follower database MyDB policy caching

.add follower データベース プリンシパル

承認されたプリンシパルのオーバーライドのフォロワー データベース コレクションに、承認されたプリンシパルを追加します。 Notes

• このような承認されたプリンシパルの既定の modification kind は none。 modification kindを変更するには、alter follower database principals-modification-kind を使用します。
• .show コマンドを使用して、変更後のプリンシパルの有効なコレクションを表示できます。
  • .show database principals
  • .show database details
• 変更後にフォロワー データベースのオーバーライド設定を表示するには、 .show follower database

構文

.add follower database DatabaseName (admins | users | viewers | monitors) ロール (principal1,...,principalN) ['notes']

例

.add follower database MyDB viewers ('aadgroup=mygroup@microsoft.com') 'My Group'

.drop follower データベース プリンシパル

権限のあるプリンシパルのオーバーライドのフォロワー データベース コレクションから、承認されたプリンシパルを削除します。

構文

.drop follower database DatabaseName (admins | users | viewers | monitors) (principal1,...,principalN)

例

.drop follower database MyDB viewers ('aadgroup=mygroup@microsoft.com')

.alter follower database principals-modification-kind

フォロワー データベースの承認されたプリンシパルの変更の種類を変更します。

構文

.alter follower database DatabaseNameprincipals-modification-kind = (none | union | replace)

例

.alter follower database MyDB principals-modification-kind = union

.alter follower database caching-policies-modification-kind

フォロワー データベース、テーブル、具体化されたビューのキャッシュ ポリシーの変更の種類を変更します。

構文

.alter follower database DatabaseNamecaching-policies-modification-kind = (none | union | replace)

例

.alter follower database MyDB caching-policies-modification-kind = union

.alter follower database prefetch-extents

フォロワー クラスターは、基になるストレージからノードの SSD (キャッシュ) に新しいデータがフェッチされるのを待ってから、このデータをクエリ可能にすることができます。

次のコマンドは、スキーマの更新ごとに新しいエクステントをプリフェッチするフォロワー データベースの構成を変更します。

構文

.alter follower database DatabaseNameprefetch-extents = (true | false)

例

.alter follower database MyDB prefetch-extents = false

テーブルと具体化されたビューのコマンド

フォロワー テーブルまたは具体化されたビューキャッシュ ポリシーの変更

リーダー クラスター内のソース データベースで設定されたポリシーをオーバーライドするために、フォロワー データベースのテーブルまたは具体化されたビューのキャッシュ ポリシーを変更します。

構文

.alter follower database DatabaseName テーブル TableNamepolicycachinghot=HotDataSpan

.alter follower database DatabaseName テーブル (TableName1,...,TableNameN)policycachinghot=HotDataSpan

.alter follower database DatabaseName materialized-viewNamepolicycachinghot=

.alter follower database DatabaseName materialized-views (ViewName1,...,ViewNameN)policycachinghot=HotDataSpan

例

.alter follower database MyDb tables (Table1, Table2) policy caching hot = 7d

.alter follower database MyDb materialized-views (View1, View2) policy caching hot = 7d

フォロワー テーブルまたは具体化されたビューのキャッシュ ポリシーを削除する

フォロワー データベースのテーブルまたは具体化されたビューのキャッシュ ポリシーのオーバーライドを削除します。 リーダー クラスター内のソース データベースに設定されたポリシーが、有効なポリシーになります。

構文

.delete follower database DatabaseNametableTablenamepolicycaching

.delete follower database DatabaseNametables(TableName1,...,TableNameN)policycaching

.delete follower database DatabaseNamematerialized-viewViewnamepolicycaching

.delete follower database DatabaseNamematerialized-views(ViewName1,...,ViewNameN)policycaching

例

.delete follower database MyDB tables (Table1, Table2) policy caching

.delete follower database MyDB materialized-views (View1, View2) policy caching

サンプル構成

フォロワー データベースを構成する手順の例を次に示します。

この例では：

• フォロワー クラスター MyFollowerCluster 、リーダー クラスターからのデータベース MyDatabase に従 MyLeaderCluster。

  • MyDatabaseには、N、MyTable1、MyTable2、... MyTable3 (MyTableNN 3) の>テーブルがあります。
  • MyLeaderCluster の場合:

  MyTable1 キャッシュ ポリシー	MyTable2 キャッシュ ポリシー	MyTable3...MyTableN キャッシュ ポリシー	MyDatabase 承認されたプリンシパル
  ホット データスパン = 7d	ホット データスパン = 30d	ホット データスパン = 365d	閲覧者 = aadgroup=scubadivers@contoso.com; 管理者 = aaduser=jack@contoso.com

  • MyFollowerClusterで必要な内容は次のとおりです。

  MyTable1 キャッシュ ポリシー	MyTable2 キャッシュ ポリシー	MyTable3...MyTableN キャッシュ ポリシー	MyDatabase 承認されたプリンシパル
  ホット データスパン = 1d	ホット データスパン = 3d	ホット データスパン = 0d (何もキャッシュされません)	管理者 = aaduser=jack@contoso.com閲覧者 = aaduser=jill@contoso.com

実行する手順

前提 条件：クラスター MyFollowerClusterからデータベース MyDatabaseに従ってクラスター MyLeaderClusterを設定します。

現在の構成を表示する

MyDatabaseで実行されているMyFollowerClusterに従って、現在の構成を確認します。

.show follower database MyDatabase
| evaluate narrow() // just for presentation purposes

承認されたプリンシパルをオーバーライドする

MyDatabaseのMyFollowerClusterに対して承認されたプリンシパルのコレクションを、データベース管理者として 1 人の Microsoft Entra ユーザーと、データベース ビューアーとして 1 人の Microsoft Entra ユーザーのみを含むコレクションに置き換えます。

.add follower database MyDatabase admins ('aaduser=jack@contoso.com')

.add follower database MyDatabase viewers ('aaduser=jill@contoso.com')

.alter follower database MyDatabase principals-modification-kind = replace

これらの 2 つの特定のプリンシパルのみが、 MyDatabase にアクセスする権限を持っています。 MyFollowerCluster

.show database MyDatabase principals

.show follower database MyDatabase
| mv-expand parse_json(AuthorizedPrincipalsOverride)
| project AuthorizedPrincipalsOverride.Principal.FullyQualifiedName

キャッシュ ポリシーをオーバーライドする

MyDatabase上のMyFollowerCluster用のデータベース レベルのキャッシュ ポリシーとテーブル レベルのキャッシュ ポリシーのコレクションを置き換えます。このポリシーでは、とMyTable1の期間、それぞれデータがキャッシュされる 2 つの特定のテーブル (MyTable2、1d) を除く、データがキャッシュ3dすべてのテーブルを設定します。

.alter follower database MyDatabase policy caching hot = 0d

.alter follower database MyDatabase table MyTable1 policy caching hot = 1d

.alter follower database MyDatabase table MyTable2 policy caching hot = 3d

.alter follower database MyDatabase caching-policies-modification-kind = replace

これら 2 つの特定のテーブルにのみデータがキャッシュされ、残りのテーブルには 0dのホット データ期間があります。

.show tables details
| summarize TableNames = make_list(TableName) by CachingPolicy

.show follower database MyDatabase
| mv-expand parse_json(TableMetadataOverrides)
| project TableMetadataOverrides

概要

MyDatabaseでMyFollowerClusterがフォローされている現在の構成を確認します。

.show follower database MyDatabase
| evaluate narrow() // just for presentation purposes