Kategorien:: Information Schema, Tabellenfunktionen

AVAILABLE_LISTING_REFRESH_HISTORY¶

Gibt den Aktualisierungsverlauf der letzten 14 Tage für ein verfügbares Freigabeangebot oder eine Datenbank zurück, die aus einem Freigabeangebot mit einer Cloud-übergreifenden automatischen Ausführung eingebunden wurde. Die zurückgegebenen Informationen enthalten Details zur Replikation von Daten, die bei jedem Aktualisierungsereignis zur Freigabeangebotsdatenbank hinzugefügt werden. Diese Funktion steht allen Verbrauchern von Freigabeangeboten zur Verfügung, die über eine Berechtigung für das verfügbare Freigabeangebot oder die eingebundene Datenbank verfügen.

Syntax¶

AVAILABLE_LISTING_REFRESH_HISTORY(
  OBJECT_TYPE => '<object_type>',
  OBJECT_NAME => '<object_name>' )

Copy

Argumente¶

OBJECT_TYPE => 'object_type': Typ des Objekts, entweder listing oder database.
OBJECT_NAME => 'object_name': Name des Objekts, der je nach Objekttyp entweder der globale Name des Freigabeangebots oder der Name der eingebundenen Datenbank sein kann.

Ausgabe¶

Die Funktion gibt die folgenden Spalten zurück:

Spaltenname	Datentyp	Beschreibung
OBJECT_TYPE	TEXT	Listet den Typ des Snowflake-Objekts auf. Zum Beispiel: Freigabeangebot.
OBJECT_NAME	TEXT	Name des Freigabeangebots oder der eingebundenen Datenbank.
PHASE	TEXT	Aktuelle Phase der Replikationsoperation, dargestellt als eine Phase von insgesamt X Phasen. Beispiel: 2/6.
PHASE_NAME	TEXT	Name der bisher abgeschlossenen (oder laufenden) Replikationsphasen. Die Liste der Phasen finden Sie unter Nutzungshinweise.
PROGRESS	TEXT	PRIMARY_UPLOADING_DATA: Prozentsatz der insgesamt replizierten Bytes (Upload). SECONDARY_DOWNLOADING_METADATA: Prozentualer Anteil an der Gesamtzahl der replizierten Objekte. SECONDARY_DOWNLOADING_DATA: Prozentsatz der insgesamt replizierten Bytes (Upload). Leer für die übrigen Phasen.
START_TIME	TIMESTAMP_LTZ	Zeitpunkt, zu dem die Replikationsphase begann.
END_TIME	TIMESTAMP_LTZ	Zeitpunkt, zu dem die Phase beendet ist, falls anwendbar. NULL, wenn sich die Phase noch in Ausführung befindet oder wenn sie die abschließende Phase ist (`COMPLETED/FAILED/CANCELED`).
JOB_UUID	TEXT	Abfrage-ID des Aktualisierungsjobs.
PRIMARY_SNAPSHOT_TIMESTAMP	TIMESTAMP_LTZ	Zeitstempel, wann der primäre Snapshot erstellt wurde.
ERROR	VARIANT	NULL wenn die Aktualisierungsoperation erfolgreich war. Wenn die Aktualisierungsoperation fehlschlägt, wird ein JSON-Objekt zurückgegeben, das detaillierte Informationen zu dem Fehler enthält: `errorCode`: Fehlercode des Fehlers. `errorMessage`: Fehlermeldung des Fehlers.

Nutzungshinweise¶

Gibt nur Zeilen für eine Rolle mit einer Berechtigung für das Freigabeangebot zurück, wenn der Freigabeangebot für das Konto sichtbar ist.
Wenn object_type auf database (im Gegensatz zu listing) festgelegt ist, werden nur Zeilen für Rollen mit einer Berechtigung für diese Datenbank zurückgegeben.
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 Informationen finden Sie unter Information Schema.

Liste der Phasen in der Reihenfolge der Bearbeitung:
1. SECONDARY_SYNCHRONIZING_MEMBERSHIP
2. SECONDARY_UPLOADING_INVENTORY
3. PRIMARY_UPLOADING_METADATA
4. PRIMARY_UPLOADING_DATA
5. SECONDARY_DOWNLOADING_METADATA
6. SECONDARY_DOWNLOADING_DATA
7. COMPLETED / FAILED / CANCELED

Beispiele¶

Abrufen des Verlaufs für die Datenbank my_mounted_database.

SELECT * FROM TABLE(
  INFORMATION_SCHEMA.AVAILABLE_LISTING_REFRESH_HISTORY(
    OBJECT_TYPE=>'database',
    OBJECT_NAME=>'my_mounted_database'
  )
);

Copy