- Kategorien:
DATABASE_REFRESH_PROGRESS , DATABASE_REFRESH_PROGRESS_BY_JOB¶
Mit der Funktionsfamilie DATABASE_REFRESH_PROGRESS kann der Status einer Datenbankaktualisierung in verschiedenen Dimensionen abgefragt werden:
DATABASE_REFRESH_PROGRESS gibt ein JSON-Objekt zurück, das den aktuellen Aktualisierungsstatus für eine sekundäre Datenbank nach Namen angibt.
DATABASE_REFRESH_PROGRESS_BY_JOB gibt ein JSON-Objekt zurück, das den aktuellen Aktualisierungsstatus für eine sekundäre Datenbank durch eine Aktualisierungsabfrage angibt.
Jede Funktion ist für die Abfrage anhand der angegebenen Dimension optimiert.
Bemerkung
DATABASE_REFRESH_PROGRESS gibt nur die Datenbankaktualisierungsaktivität für die letzte Datenbankaktualisierung zurück, wenn diese innerhalb der letzten 14 Tage stattfand.
DATABASE_REFRESH_PROGRESS_BY_JOB gibt die Datenbankaktualisierungsaktivitäten der letzten 14 Tage zurück.
- Siehe auch:
Syntax¶
DATABASE_REFRESH_PROGRESS( '<secondary_db_name>' )
DATABASE_REFRESH_PROGRESS_BY_JOB( '<query_id>' )
Argumente¶
secondary_db_name
Name der sekundären Datenbank. Dieses Argument ist optional, wenn die sekundäre Datenbank die aktive Datenbank der aktuellen Sitzung ist.
Beachten Sie, dass der gesamte Name in einfache Anführungszeichen gesetzt werden muss.
query_id
ID der Datenbank-Aktualisierungsabfrage. Die Abfrage-ID kann von der Seite History der Weboberfläche abgerufen werden.
Nutzungshinweise¶
Gibt nur Ergebnisse für Kontoadministratoren (Benutzer mit der Rolle ACCOUNTADMIN) zurück.
Beim Aufrufen einer Tabellenfunktion des Information Schema muss die Sitzung über ein aktives INFORMATION_SCHEMA-Schema verfügen oder der Funktionsname muss vollqualifiziert sein. Weitere Details dazu finden Sie unter Snowflake Information Schema.
Die folgende Liste zeigt die Verarbeitungsreihenfolge der Phasen:
SECONDARY_UPLOADING_INVENTORY
PRIMARY_UPLOADING_METADATA
PRIMARY_UPLOADING_DATA
SECONDARY_DOWNLOADING_METADATA
SECONDARY_DOWNLOADING_DATA
COMPLETED / FAILED / CANCELED
Ausgabe¶
Die Funktion gibt die folgenden Spalten zurück:
Spaltenname |
Datentyp |
Beschreibung |
---|---|---|
PHASE_NAME |
TEXT |
Name der bisher abgeschlossenen (oder laufenden) Replikationsphasen. Die Liste der Phasen finden Sie in den Nutzungshinweisen. |
RESULT |
TEXT |
Status der Replikationsphase. Gültige Zustände sind |
START_TIME |
NUMBER |
Zeitpunkt, zu dem die Replikationsphase begann. Das Format ist die Epochenzeit. |
END_TIME |
NUMBER |
Zeitpunkt, zu dem die Phase beendet ist, falls anwendbar. Das Format ist die Epochenzeit. |
DETAILS |
VARIANT |
Nur von Funktion DATABASE_REFRESH_PROGRESS zurückgegeben. Ein JSON-Objekt, das detaillierte Informationen für die folgenden Phasen bereitstellt: . - Primäres Hochladen von Daten: Zeitstempel des aktuellen Snapshots der primären Datenbank. . - Primäres Hochladen von Daten und Sekundäres Herunterladen von Daten: Gesamtzahl der Bytes der Datenbankaktualisierung sowie Anzahl der bisher in der Phase kopierten Bytes. . - Sekundäres Herunterladen von Metadaten: Anzahl der Tabellen, Tabellenspalten und aller Datenbankobjekte (einschließlich Tabellen und Tabellenspalten) im neuesten Snapshot der Primärdatenbank. |
Beispiele¶
Abrufen des aktuellen Fortschritts der Datenbankaktualisierung für die Datenbank mydb1
:
select * from table(information_schema.database_refresh_progress(mydb1));
Abrufen des aktuellen Fortschritts einer Datenbankaktualisierung nach Abfrage-ID:
select * from table(information_schema.database_refresh_progress_by_job('012a3b45-1234-a12b-0000-1aa200012345'));