重要
この機能は、プライベート プレビュー段階にあります。 試すには、Azure Databricks の連絡先にお問い合わせください。
このページでは、マネージド ディザスター リカバリー (DR) のレプリケーション状態を追跡する、replication システム スキーマのstates テーブルAzure Databricks参照します。 各行はフェールオーバー グループの状態イベントであり、フェールオーバー グループが変更されるたびに定期的に生成されます。 この表を使用して、レプリケーションのラグや、少なくとも 1 つの資産のレプリケーションをブロックしているエラーなど、フェールオーバー グループの現在および過去のレプリケーションの状態を監視します。
テーブル パス: system.replication.states
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 |
文字列 | イベントが生成されたときのレプリケーションの状態。 使用可能な値は、 INITIALIZING、 REPLICATING、 CREATED、 UPDATED、 DELETED、 FAILOVER_STARTED、 FAILOVER_FINISHED、および FAILOVER_ABORTEDです。 |
REPLICATING |
errors |
アレイ |
replication_stateがREPLICATINGされると、少なくとも 1 つの資産のレプリケーションをブロックしているエラーの集計された一覧 (各エラーが影響する資産の数など)。 それ以外の場合は、操作が失敗する原因となったエラー。
エラーのリファレンスを参照してください。 |
エラーリファレンスを参照 |
replication_lag_ms |
long | イベントが生成された最後の正常なレプリケーションからのミリ秒。
null値は、少なくとも 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 |
|---|---|---|
metastores |
アレイ | フェールオーバー グループによって管理されるメタストア。 |
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