Kategorien:

Information Schema, Tabellenfunktionen

LISTING_REFRESH_HISTORY

Gibt die Aktualisierungsverlauf der letzten 14 Tage für ein Freigabeangebot mit einer Cloud-übergreifenden automatischen Ausführung zurück. Die zurückgegebenen Informationen enthalten Replikationsdetails für Aktualisierungsereignisse, bei denen das Freigabeangebot mit einer bestimmten Zielregion synchronisiert wird.

Diese Funktion steht Anbietern von Freigabeangeboten zur Verfügung, die über eine Berechtigung für das angegebene Freigabeangebot verfügen.

Syntax

LISTING_REFRESH_HISTORY(
  LISTING_NAME => '<listing_name>'
  [ , SNOWFLAKE_REGION => '<snowflake_region>' ]
  [ , REGION_GROUP => '<region_group>' ] )
Copy

Argumente

Erforderlich

LISTING_NAME => 'listing_name'

SQL-Bezeichner eines Freigabeangebots mit einer Cloud-übergreifenden automatischen Ausführung in diesem Konto. Den SQL-Bezeichner für Freigabeangebote finden Sie in der Namensspalte, die von „show listings in data exchange <exchange_name>“ zurückgegeben wird. In ähnlicher Weise kann der SQL-Bezeichner für den Datenaustausch in der Namensspalte gefunden werden, die von show data exchanges zurückgegeben wird.

Optional

SNOWFLAKE_REGION => 'snowflake_region'

Die Snowflake-Regionsgruppe, in die das Freigabeangebot repliziert wird. Hier können Sie den Aktualisierungsverlauf für diese Replikation einsehen. Dies folgt der gleichen Formatierung wie die Spalte snowflake_region, die von SHOW REGIONS zurückgegeben wird. Wenn keine Region angegeben wird, wird der Verlauf für alle Zielregionen angezeigt.

REGION_GROUP =>  'region_group'

Die Snowflake-Regionsgruppe, in die das Freigabeangebot repliziert wird und für die Sie den Aktualisierungsverlauf einsehen können.

Standardmäßig PUBLIC. Dieses Argument muss nur angegeben werden, wenn sich die zu überwachende Zielregion in einer Region für US-Regierungsbehörden oder einer Virtual Private Snowflake-Region befindet.

Ausgabe

Die Funktion gibt die folgenden Spalten zurück:

Spaltenname

Datentyp

Beschreibung

LISTING_NAME

TEXT

Name des Freigabeangebots mit einer Cloud-übergreifenden automatischen Ausführung in diesem Konto.

SNOWFLAKE_REGION

TEXT

Name der Snowflake Region, in die das Freigabeangebot repliziert wird. Beispiel: aws_us_east_1.

REGION_GROUP

TEXT

Name der Snowflake Regionsgruppe, in die das Freigabeangebot repliziert wird. Beispiel: PUBLIC.

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

Der aktuelle Replikationsfortschritt in Prozent.

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.

TOTAL_BYTES

VARIANT

Ein JSON-Objekt, das detaillierte Informationen zu aktualisierten Datenbanken bereitstellt:

  • totalBytesToReplicate: Gesamtzahl der Bytes, die voraussichtlich repliziert werden.

  • bytesUploaded: Tatsächliche Anzahl der hochgeladenen Bytes.

  • bytesDownloaded: Tatsächliche Anzahl der heruntergeladenen Bytes.

  • databases: Liste von JSON-Objekten mit folgenden Felder für jede Mitgliedsdatenbank:

    • name: Name der Datenbank.

    • totalBytesToReplicate: Summe der Bytes, die voraussichtlich für die Datenbank repliziert werden.

OBJECT_COUNT

VARIANT

Ein JSON-Objekt, das detaillierte Informationen zu aktualisierten Objekten bereitstellt:

  • totalObjects: Gesamtzahl der Objekte in der Replikations- oder Failover-Gruppe.

  • completedObjects: Gesamtzahl der verarbeiteten Objekte.

  • objectTypes: Liste von JSON-Objekten mit folgenden Feldern für jeden Typ:

    • objectType: Typ des Objekts (z. B. Benutzer, Rollen, Berechtigungen, Warehouses, Schemas, Tabellen, Spalten usw.).

    • totalObjects: Gesamtzahl der Objekte dieses Typs in der Replikations- oder Failover-Gruppe.

    • completedObjects: Gesamtzahl der Objekte dieses Typs, die verarbeitet wurden.

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.

  • Gibt nur Zeilen für ein Freigabeangebot im aktuellen Konto 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 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

  • Die Ausgabe enthält auch den Verlauf anderer Angebote, die auf dieselbe Datenbank verweisen, da sie gemeinsam aktualisiert werden. Wenn die Eingabe ein Freigabeangebot der Anwendung ist, enthält sie den Verlauf aller Freigabeangebote der Anwendung in der angegebenen Region.

  • In den Phasen PRIMARY_UPLOADING_DATA und SECONDARY_DOWNLOADING_DATA erfolgt vor der Replikationsoperation eine Schätzung des totalBytesToReplicate-Werts. Dieser Wert kann von dem totalBytesToUpload- oder totalBytesToDownload-Wert der jeweiligen Phase abweichen.

    Wenn beispielsweise während der Phase PRIMARY_UPLOADING_DATA von einer vorherigen Replikationsoperation einige Bytes hochgeladen wurden, die Operation aber vorzeitig abgebrochen wurde, werden diese Bytes nicht erneut hochgeladen. In diesem Fall wäre totalBytesToUpload niedriger als totalBytesToReplicate.

Beispiele

Rufen Sie den Verlauf des Freigabeangebots my_listing ab, der auf AWS US East-1, einer Public-Cloud-Region, aktualisiert wird.

select * from table(information_schema.listing_refresh_history(listing_name=>'my_listing',snowflake_region=>'AWS_US_EAST_1))
Copy
Sprache: Deutsch