Referenz zur Replikationssystemtabelle

Von Bedeutung

Managed DR ist eingeschränkt verfügbar. Beantragen Sie den Zugriff über Ihr Azure Databricks-Kontoteam. Azure Databricks aktiviert verwalteten DR auf Ihrem Konto, nachdem Sie akzeptiert wurden.

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

Wie man den Replikationsstatus liest

Statusereignisse werden in regelmäßigen Abständen ausgestrahlt. Jedes Ereignis meldet den aggregierten Zustand der Failover-Gruppe, die aktuelle Verzögerung und alle Fehler, die die Replikation von mindestens einem Asset blockieren. Es listet nicht auf, welche einzelnen Objekte erfolgreich repliziert wurden.

Wenn replication_lag_ms nicht nullist, wurde alles, was nicht durch einen Fehler in diesem Ereignis abgedeckt ist, bis zu dieser Verzögerung repliziert. Andere In-Scope-Assets replizieren weiterhin und bleiben aktuell gegenüber der Verzögerung, selbst wenn das errors Array nicht leer ist. Während INITIAL_REPLICATION, bevor alle Assets im Scope einmal repliziert wurden, replication_lag_ms kann null: das Ereignis kann weiterhin Blockierungsfehler auflisten, misst aber noch nicht die Vollständigkeit.

Asset-Typen, die von verwaltetem DR überhaupt nicht unterstützt werden, erscheinen in der Tabelle nicht, weder als Erfolg noch als Fehler. Ihr Fehlen bedeutet nicht, dass sie sich vermehrt haben. Informationen finden Sie unter Einschränkungen. In-Scope-Assets, die eine nicht unterstützte Funktion verwenden, wie Zeilenfilter, Spaltenmasken oder attributbasierte Zugriffskontrolle (ABAC), erscheinen in der Tabelle als Fehler.

Um zu bestätigen, dass ein bestimmtes Objekt im Sekundärbereich existiert, inspizieren Sie das Objekt dort. Da sekundäre In-Scope-Kataloge schreibgeschützt sind, empfiehlt Azure Databricks einen separaten, schreibgeschützten Überwachungsbereich in der sekundären Region. Siehe Replikation einrichten.

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 INITIAL_REPLICATION: , ACTIVE, CREATED, UPDATED, DELETED, FAILOVER_STARTED, , und FAILOVER_FINISHEDFAILOVER_ABORTED. ACTIVE
errors array Wenn replication_state ist INITIAL_REPLICATION oder ACTIVE, eine aggregierte Liste der Fehler, die die Replikation von mindestens einem Asset blockieren, einschließlich der Anzahl der Assets, die jeder Fehler betrifft. Siehe Fehlerreferenz. Siehe Fehlerreferenz
replication_lag_ms long Millisekunden seit der letzten erfolgreichen Replikation aller Ressourcen im Gültigkeitsbereich, als das Ereignis ausgegeben wurde. Ein null Wert gibt an, dass mindestens eine Ressource nie aus der Quelle in das Replikat repliziert wurde. Ein steigender Wert bedeutet, dass DR nicht mindestens eine In-Scope-Ressource replizieren kann, aber Änderungen an anderen In-Scope-Ressourcen werden weiterhin repliziert. 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
metastore_ids array Die IDs der Metastores, die von der Failover-Gruppe verwaltet werden.
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
  • Last updated on