Kategorien:

Information Schema, Tabellenfunktionen

STAGE_STORAGE_USAGE_HISTORY

Mit dieser Tabellenfunktion kann für alle Snowflake-Stagingbereiche in Ihrem Konto die durchschnittliche tägliche Datenspeichernutzung in Bytes in einem bestimmten Datumsbereich abgefragt werden. Die Ausgabe beinhaltet Speicher für:

  • Benannte interne Stagingbereiche.

  • Standardmäßige Stagingbereiche (für Tabellen und Benutzer).

Bemerkung

Diese Funktion gibt die Speichernutzung für Stagingbereiche innerhalb der letzten 6 Monate zurück.

Siehe auch:

DATABASE_STORAGE_USAGE_HISTORY, WAREHOUSE_METERING_HISTORY

Syntax

STAGE_STORAGE_USAGE_HISTORY(
      [ DATE_RANGE_START => <constant_expr> ]
      [, DATE_RANGE_END => <constant_expr> ] )
Copy

Argumente

Alle Argumente sind optional.

DATE_RANGE_START => constant_expr, . DATE_RANGE_END => constant_expr

Der Datumsbereich in den letzten 6 Monaten, für den die Speichernutzung des Stagingbereichs abgerufen werden soll:

  • Wenn kein Enddatum angegeben ist, wird CURRENT_DATE als Ende des Bereichs verwendet.

  • Wenn kein Startdatum angegeben ist, wird DATE_RANGE_END als Anfang des Bereichs verwendet (der Standardwert ist die Speichernutzung an einem Tag).

Wenn der Bereich außerhalb der letzten 6 Monate liegt, wird ein Fehler zurückgegeben.

Nutzungshinweise

  • Gibt Ergebnisse nur für die Rolle ACCOUNTADMIN oder für eine Rolle zurück, der die globale Berechtigung MONITOR USAGE explizit erteilt wurde.

  • 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.

Ausgabe

Die Funktion gibt die folgenden Spalten zurück:

Spaltenname

Datentyp

Beschreibung

USAGE_DATE

DATE

Datum (in der Zeitzone UTC) dieses Speichernutzungseintrags

AVERAGE_STAGE_BYTES

NUMBER

Anzahl der Bytes des verwendeten Stagingspeichers

Beispiele

Abrufen der durchschnittlichen täglichen Speichernutzung in den letzten 10 Tagen für alle internen Stagingbereiche in Ihrem Konto:

select *
from table(information_schema.stage_storage_usage_history(dateadd('days',-10,current_date()),current_date()));
Copy