重要
Managed DR は利用が制限されています。 Azure Databricks アカウント チームを通じてアクセスを申請します。 Azure Databricks受け入れられた後、アカウントでマネージド DR を有効にします。
このページでは、states のレプリケーション状態を追跡する、replication システム スキーマの テーブルAzure Databricks参照します。 各行はフェールオーバー グループの状態イベントであり、フェールオーバー グループが変更されるたびに定期的に生成されます。 この表を使用して、レプリケーションのラグや、少なくとも 1 つの資産のレプリケーションをブロックしているエラーなど、フェールオーバー グループの現在および過去のレプリケーションの状態を監視します。
テーブル パス: system.replication.states
複製状態の読み方
ステータスイベントは一定間隔で送信されます。 各イベントはフェイルオーバーグループの総状態、現在の遅延、そして少なくとも1つの資産のレプリケーションを妨げているエラーを報告します。 どの個別のオブジェクトが成功裏に複製されたかは記載されていません。
replication_lag_msがnullしていない場合、そのイベントでエラーに適用されていないものはすべてその遅延まで複製されています。 他のスコープ内の資産は、 errors アレイが空でなくてもラグに対して複製し、最新の状態を保ちます。
INITIAL_REPLICATION中、すべてのスコープ内の資産が一度複製される前に、replication_lag_msnullできます。イベントはブロックエラーをリストアップできますが、完全性をまだ測定していません。
管理されたDRが全くサポートしていない資産タイプは、成功としてもエラーとしても表に表示されません。 彼らの不在が複製を意味するわけではありません。 制限事項を参照してください。 行フィルター、カラムマスク、属性ベースのアクセス制御(ABAC)など、サポートされていない機能を使用している範囲内のアセットは、テーブルに失敗として表示されます。
セカンダリーに特定の資産が存在するか確認するために、そこでオブジェクトを検査してください。 二次的な範囲内カタログは読み取り専用であるため、Azure Databricksは二次領域に別の読み取り専用のモニターワークスペースを推奨しています。 「 複製の設定」を参照してください。
States テーブル スキーマ リファレンス
states テーブルでは、次のスキーマを使用します。
| 列名 | データの種類 | Description | Example |
|---|---|---|---|
event_id |
文字列 | 状態イベントの一意識別子。 | ca886134-876c-4671-a38b-332edf48c602 |
event_time |
timestamp | イベントが生成された日時のタイムスタンプ。 | 2024-01-05T00:00:00.000+00:00 |
account_id |
文字列 | フェールオーバー グループが属しているアカウントの ID。 | ca886134-876c-4671-a38b-332edf48c602 |
failover_group_name |
文字列 | フェールオーバー グループの完全修飾名。 | accounts/account1/failover-group/group1 |
replication_state |
文字列 | イベントが生成されたときのレプリケーションの状態。 使用可能な値は、 INITIAL_REPLICATION、 ACTIVE、 CREATED、 UPDATED、 DELETED、 FAILOVER_STARTED、 FAILOVER_FINISHED、および FAILOVER_ABORTEDです。 |
ACTIVE |
errors |
アレイ |
replication_stateがINITIAL_REPLICATIONまたはACTIVEの場合、少なくとも1つの資産の複製を妨げているエラーのリストと、それぞれの影響を与える資産数をまとめて示します。
エラーのリファレンスを参照してください。 |
エラーリファレンスを参照 |
replication_lag_ms |
long | イベントが生成されたとき、スコープ内のすべての資産のレプリケーションが最後に成功してからのミリ秒。
null値は、少なくとも 1 つの資産がソースからレプリカにレプリケートされていないことを示します。 値の上昇は、DR が少なくとも 1 つのスコープ内資産をレプリケートできないことを意味しますが、他のスコープ内資産への変更は引き続きレプリケートされます。 |
2323 |
effective_primary_region |
文字列 | イベントが生成された時点のフェールオーバー グループのプライマリ リージョン。 | us-west-2 |
managed_assets |
構造体 | イベントが生成されたときにフェールオーバー グループによって管理される資産。 「管理資産のリファレンス」を参照してください。 | 「管理資産のリファレンス」を参照してください |
エラー リファレンス
errors列には、レプリケーションをブロックしているエラーの配列が含まれています。 配列の各要素は、次のフィールドを持つ構造体です。
| フィールド名 | データの種類 | Description |
|---|---|---|
error |
構造体 | エラーの詳細。
error_class (文字列)、エラーのクラス名、parameters (マップ)、エラーの詳細を含むキー値パラメーター、および人間が判読できるエラー メッセージmessage (文字列) が含まれます。 |
affected_assets_counts |
アレイ | 影響を受ける資産の種類ごとに 1 つのエントリ。 各エントリには、 asset_type (文字列)、影響を受ける資産の型、およびエラーが影響を受けるその種類の資産の数を failing_count (long) が含まれます。 |
管理資産リファレンス
managed_assets列は、イベントが生成されたときにフェールオーバー グループによって管理される資産を記述する構造体です。 これは次のフィールドが含まれています。
| フィールド名 | データの種類 | Description |
|---|---|---|
metastore_ids |
アレイ | フェイルオーバーグループが管理するメタストアのIDです。 |
workspace_sets |
アレイ | フェールオーバー グループによって管理されるワークスペース セット。 各エントリには、 name (文字列) と workspace_ids (配列) が含まれます。 |
catalogs |
アレイ | フェールオーバー グループによって管理されるカタログ。 各エントリには、 name (文字列) が含まれています。 |
テーブルを読み取る際の考慮事項
statesテーブルを分析するときは、次の点に注意してください。
- イベントが発生した後、データが設定されるまでに最大 3 時間かかる場合があります。
- テーブルには、Azure Databricks アカウント内のすべてのフェールオーバー グループのイベントが含まれています。
クエリの例
次のクエリは、特定のフェールオーバー グループの最新のレプリケーション状態 (現在の replication_state、レプリケーションのラグ、ブロック エラーなど) を返します。
SELECT
event_time,
replication_state,
replication_lag_ms,
errors
FROM system.replication.states
WHERE failover_group_name = :failover_group_name
ORDER BY event_time DESC
LIMIT 1
次のクエリは、特定のフェールオーバー グループのレプリケーションラグの分布を返します。
SELECT histogram_numeric(replication_lag_ms, 20) AS replication_lag_distribution
FROM system.replication.states
WHERE failover_group_name = :failover_group_name