Referenz zur Replikationssystemtabelle

Von Bedeutung

Dieses Feature befindet sich in der privaten Vorschauphase. Wenden Sie sich an Ihren Azure Databricks-Kontakt, um es zu testen.

Diese Seite enthält einen Verweis auf die states Tabelle im replication Systemschema, die den Replikationsstatus Azure Databricks verwalteten Notfallwiederherstellung (DR) nachverfolgt. Jede Zeile ist ein Statusereignis für eine Failovergruppe, die regelmäßig und immer dann ausgegeben wird, wenn sich die Failovergruppe ändert. Verwenden Sie diese Tabelle, um den aktuellen und historischen Replikationsstatus Ihrer Failovergruppen zu überwachen, einschließlich der Replikationsverzögerung und aller Fehler, die die Replikation von mindestens einer Ressource blockieren.

Tabellenpfad: system.replication.states

Schemareferenz für Zuständetabellen

Die states Tabelle verwendet das folgende Schema:

Spaltenname Datentyp Description Example
event_id string Eindeutiger Bezeichner für das Statusereignis. ca886134-876c-4671-a38b-332edf48c602
event_time timestamp Zeitstempel des Zeitpunkts, zu dem das Ereignis ausgegeben wurde. 2024-01-05T00:00:00.000+00:00
account_id string ID des Kontos, zu dem die Failovergruppe gehört. ca886134-876c-4671-a38b-332edf48c602
failover_group_name string Vollqualifizierter Name der Failovergruppe. accounts/account1/failover-group/group1
replication_state string Der Status der Replikation, als das Ereignis ausgegeben wurde. Mögliche Werte sind INITIALIZING: , REPLICATING, CREATED, UPDATED, DELETED, FAILOVER_STARTED, , und FAILOVER_FINISHEDFAILOVER_ABORTED. REPLICATING
errors array Wenn replication_state dies der Wert ist, ist REPLICATINGeine aggregierte Liste der Fehler, die die Replikation von mindestens einer Ressource blockieren, einschließlich der Anzahl der Ressourcen, die sich auf jeden Fehler auswirken. Andernfalls treten die Fehler auf, die dazu geführt haben, dass der Vorgang fehlschlägt. Siehe Fehlerreferenz. Siehe Fehlerreferenz
replication_lag_ms long Millisekunden seit der letzten erfolgreichen Replikation, als das Ereignis ausgegeben wurde. Ein null Wert gibt an, dass mindestens eine Ressource nie aus der Quelle in das Replikat repliziert wurde. 2323
effective_primary_region string Der primäre Bereich der Failovergruppe zum Zeitpunkt, zu dem das Ereignis ausgegeben wurde. us-west-2
managed_assets struct Die Ressourcen, die von der Failovergruppe verwaltet werden, als das Ereignis ausgegeben wurde. Siehe Referenz zu verwalteten Ressourcen. Referenz zu verwalteten Ressourcen

Fehlerverweis

Die errors Spalte enthält ein Array der Fehler, die die Replikation blockieren. Jedes Element des Arrays ist eine Struktur mit den folgenden Feldern:

Feldname Datentyp Description
error struct Details zum Fehler. Enthält error_class (Zeichenfolge), einen Klassennamen für den Fehler; parameters (Zuordnung), Schlüsselwertparameter mit Details zum Fehler und message (Zeichenfolge), eine lesbare Fehlermeldung.
affected_assets_counts array Ein Eintrag pro betroffenem Objekttyp. Jeder Eintrag enthält asset_type (Zeichenfolge), den Typ der betroffenen Ressource und failing_count (lang) die Anzahl der Ressourcen dieses Typs, die sich auf den Fehler auswirkt.

Referenz zu verwalteten Ressourcen

Die managed_assets Spalte ist eine Struktur, die die Ressourcen beschreibt, die von der Failovergruppe verwaltet werden, wenn das Ereignis ausgegeben wurde. Er enthält die folgenden Felder:

Feldname Datentyp Description
metastores array Die von der Failovergruppe verwalteten Metastores.
workspace_sets array Der Arbeitsbereich wird von der Failovergruppe verwaltet. Jeder Eintrag enthält name (Zeichenfolge) und workspace_ids (Array).
catalogs array Die Kataloge, die von der Failovergruppe verwaltet werden. Jeder Eintrag enthält name (Zeichenfolge).

Überlegungen beim Lesen der Tabelle

Beachten Sie folgendes, wenn Sie die states Tabelle analysieren:

  • Daten können bis zu 3 Stunden dauern, bis ein Ereignis aufgefüllt wird.
  • Die Tabelle enthält Ereignisse für alle Failovergruppen im Azure Databricks Konto.

Beispielabfragen

Die folgende Abfrage gibt den neuesten Replikationsstatus für eine bestimmte Failovergruppe zurück, einschließlich der aktuellen replication_stateReplikationsverzögerung und aller Blockierungsfehler:

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

Die folgende Abfrage gibt die Verteilung der Replikationsverzögerung für eine bestimmte Failovergruppe zurück:

SELECT histogram_numeric(replication_lag_ms, 20) AS replication_lag_distribution
FROM system.replication.states
WHERE failover_group_name = :failover_group_name