メインコンテンツまでスキップ
に最終更新

レプリケーションシステムテーブルのリファレンス

備考

プレビュー

この機能は プライベート プレビュー段階です。試用については、Databricksの連絡先にお問い合わせください。

このページでは、Databricksのマネージド ディザスタリカバリ (DR)のレプリケーションステータスを追跡する、replication システムスキーマ内のstates テーブルに関するリファレンスを提供します。各行はフェイルオーバーグループのステータスイベントであり、定期的に、およびフェイルオーバーグループが変更されるたびに発行されます。このテーブルを使用して、フェイルオーバーグループの現在および過去のレプリケーションステータス（レプリケーション遅延や、少なくとも1つのアセットのレプリケーションを妨げているエラーを含む）を監視します。

テーブルパス ： system.replication.states

ステートテーブルスキーマ参照​

このstatesテーブルは次のスキーマを使用しています。

列名

データ型

説明

例

event_id

string

ステータスイベントの一意の識別子。

ca886134-876c-4671-a38b-332edf48c602

event_time

timestamp

イベントが出力されたときのタイムスタンプ。

2024-01-05T00:00:00.000+00:00

account_id

string

フェイルオーバーグループが属するアカウントのIDです。

ca886134-876c-4671-a38b-332edf48c602

failover_group_name

string

フェイルオーバーグループの完全修飾名

accounts/account1/failover-group/group1

replication_state

string

イベント発行時のレプリケーションの状態。可能な値は、 INITIALIZING、 REPLICATING、 CREATED、 UPDATED、 DELETED、 FAILOVER_STARTED、 FAILOVER_FINISHED、 および FAILOVER_ABORTEDです。

REPLICATING

errors

array

replication_stateがREPLICATINGの場合、少なくとも1つのアセットのレプリケーションをブロックしているエラーの集約リスト（各エラーが影響を与えるアセットの数を含む）が提供されます。そうしないと、操作の失敗を引き起こしたエラーが発生します。エラー参照を参照してください。

エラー参照を参照してください。

replication_lag_ms

long

イベントが生成された時点での最終複製からのミリ秒null値は、少なくとも1つのアセットがソースからレプリカに複製されたことがないことを示します。

2323

effective_primary_region

string

イベントが発行された時点でのフェイルオーバーグループのプライマリリージョンです。

us-west-2

managed_assets

struct

イベント発生時にフェイルオーバーグループが管理していたアセット管理対象アセットの参照をご覧ください。

管理アセット参照を参照してください

エラーリファレンス​

errors 列には、レプリケーションをブロックしているエラーの配列が含まれています。配列の各要素は、次のフィールドを持つ構造体です。

フィールド名

データ型

説明

error

struct

エラーの詳細です。error_class（文字列）、エラーのクラス名；parameters（マップ）、エラーの詳細を含むキーと値のパラメーター；およびmessage（文字列）、人間が判読できるエラーメッセージが含まれます。

affected_assets_counts

array

対象のアセットタイプにつき、エントリは1つです。各エントリには、影響を受けるアセットのタイプである「asset_type」（文字列）、およびエラーが影響するそのタイプのアセットの数である「failing_count」（長整数）が含まれます。

管理アセット参照​

managed_assets 列は、イベントが発行されたときにフェールオーバーグループによって管理されていた資産を記述する構造体です。次のフィールドが含まれます：

フィールド名

データ型

説明

metastores

array

フェイルオーバーグループによって管理されるメタストアです。

workspace_sets

array

フェールオーバーグループによって管理されるワークスペースです。各エントリには、name (文字列) と workspace_ids (配列) が含まれています。

catalogs

array

フェイルオーバーグループで管理されているカタログです。各エントリにはname（文字列）が含まれています。

テーブルの読み込みに関する注意事項​

statesテーブルを分析する際には、以下の点にご注意ください。

  • データはイベント発生後に反映されるのに最大3時間かかる場合があります。
  • このテーブルには、Databricksアカウントのすべてのフェイルオーバーグループのイベントが含まれています。

クエリの例​

次のクエリーは、特定のフェイルオーバーグループについて、現在のreplication_state、レプリケーションラグ、およびブロックエラーを含む最新のレプリケーションステータスを返します。

SQL
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

次のクエリは、特定のフェイルオーバーグループのレプリケーションラグの分散を返します。

SQL
SELECT histogram_numeric(replication_lag_ms, 20) AS replication_lag_distribution
FROM system.replication.states
WHERE failover_group_name = :failover_group_name
このページの見出し