Schema:

ACCOUNT_USAGE

Ansicht PIPE_USAGE_HISTORY

Mit dieser Account Usage-Ansicht können Sie den Verlauf der Daten abfragen, die mit Snowpipe in Tabellen geladen wurden, oder den Verlauf der Credits, die für die automatische Iceberg-Aktualisierung innerhalb der letzten 365 Tage (1 Jahr) verwendet wurden.

In dieser Ansicht werden für Ihr gesamtes Snowflake-Konto der Verlauf der geladenen Daten und abgerechnete Credits angezeigt. Sie können die Spalte pipe_name verwenden, um die Ansicht nach einer bestimmten Pipe oder einer Iceberg-Tabelle mit automatischer Aktualisierung zu filtern.

Spalten

Spaltenname

Datentyp

Beschreibung

PIPE_ID

NUMBER

Interner/vom System generierter Bezeichner für die Pipe, die zum Laden der Daten verwendet wird. Zeigt NULL an, wenn in der Abfrage kein Pipename angegeben wurde. Jede Zeile enthält die Summen aller innerhalb des Zeitbereichs verwendeten Pipes.

PIPE_NAME

TEXT

Name der Pipe- oder Iceberg-Tabelle mit automatischer Aktualisierung. Zeigt NULL für das interne (versteckte) Pipe-Objekt an, das zur Aktualisierung der Metadaten für eine externe Tabelle oder eine Delta-basierte Iceberg-Tabelle verwendet wird.

USAGE_DATE

DATE

Das Datum, an dem die Daten aufgenommen wurden.

CREDITS_USED

NUMBER

Anzahl der Credits, die für das Laden von Daten mit Snowpipe im Fenster zwischen START_TIME und END_TIME in Rechnung gestellt wurden.

BYTES_INSERTED

FLOAT

Anzahl der im Fenster zwischen START_TIME und END_TIME geladenen Bytes.

FILES_INSERTED

VARIANT

Anzahl der Dateien, die im Fenster zwischen START_TIME und END_TIME geladen wurden.

Nutzungshinweise

  • Die Latenzzeit der Ansicht kann bis zu 180 Minuten (3 Stunden) betragen.

  • Wenn Sie die Daten in dieser Ansicht mit einer entsprechenden Ansicht im ORGANIZATION USAGE-Schema abstimmen möchten, müssen Sie zunächst die Zeitzone der Sitzung auf UTC setzen. Führen Sie vor dem Abfragen der Account Usage-Ansicht Folgendes aus:

    ALTER SESSION SET TIMEZONE = UTC;
    Copy

  • Gelegentlich kann der Prozess der Datenverdichtung und -pflege Snowflake Credits verbrauchen. Die zurückgegebenen Ergebnisse könnten zum Beispiel zeigen, dass Sie Credits mit 0 BYTES_INSERTED und 0 FILES_INSERTED verbraucht haben. Dies bedeutet, dass keine Daten geladen wurden, sondern dass Credits für den Datenkomprimierungs- und Datenwartungsprozess verbraucht wurden.

  • Snowflake stellt Benachrichtigungen zur automatischen Aktualisierung externer Tabellen und Verzeichnistabellen in internen benannten Stagingbereichen und externen Stagingbereichen zu einem Gebührensatz in Rechnung, der dem für Snowpipe-Dateien entspricht. Sie können die Kosten abschätzen, die durch Benachrichtigungen zur automatischen Aktualisierung Ihrer externen Tabellen und Verzeichnistabellen entstehen, indem Sie diese PIPE_USAGE_HISTORY-Ansicht prüfen oder die Funktion PIPE_USAGE_HISTORY abfragen. Beachten Sie, dass Pipes mit automatischer Aktualisierung unter einem NULL-Pipe-Namen aufgelistet sind. Sie können auch die Benachrichtigungshistorie zu automatischen Aktualisierungen externer Tabellen auf Tabellen-/Stagingbereichsebene anzeigen, indem Sie die Information Schema-Tabellenfunktion AUTO_REFRESH_REGISTRATION_HISTORY verwenden.

    Um Gebühren für Benachrichtigungen zu automatischen Aktualisierungen zu vermeiden, können Sie eine manuelle Aktualisierung der externen Tabellen und Verzeichnistabellen ausführen. Bei externen Tabellen kann die Anweisung ALTER EXTERNAL TABLE <Name> REFRESH … verwendet werden, um Ihre externe Tabelle manuell mit dem externen Speicher zu synchronisieren. Bei Verzeichnistabellen kann die Anweisung ALTER STAGE <Name> REFRESH … verwendet werden, um das Verzeichnis manuell mit dem externen Speicher zu synchronisieren.

  • Snowflake berechnet keine Snowpipe-Dateikosten für die automatische Iceberg-Aktualisierung.

Beispiele

Diese Abfrage liefert den Verlauf der Pipe-Nutzung für eine Pipe namens my_auto_refresh_pipe ab einem bestimmten Datum:

SELECT
    pipe_id,
    start_time,
    end_time,
    credits_used,
    bytes_inserted,
    files_inserted
  FROM SNOWFLAKE.ACCOUNT_USAGE.PIPE_USAGE_HISTORY
  WHERE pipe_name = 'my_auto_refresh_pipe'
  AND START_TIME >= '2025-04-01';
Copy

Diese Abfrage zeigt die Credits an, die für Gebühren der automatischen Aktualisierung für eine Iceberg-Tabelle namens iceberg_glue_table ab einem bestimmten Datum verwendet wurden:

SELECT
    pipe_id,
    start_time,
    end_time,
    credits_used,
  FROM SNOWFLAKE.ACCOUNT_USAGE.PIPE_USAGE_HISTORY
  WHERE pipe_name = 'iceberg_glue_table'
  AND START_TIME >= '2025-04-01';
Copy
Sprache: Deutsch