Schemas:

ACCOUNT_USAGE, READER_ACCOUNT_USAGE

QUERY_HISTORY-Ansicht

Diese Account Usage-Ansicht kann verwendet werden, um den Snowflake-Abfrageverlauf innerhalb der letzten 365 Tage (1 Jahr) nach verschiedenen Dimensionen (Zeitbereich, Sitzung, Benutzer, Warehouse usw.) abzufragen.

Die Ansicht ist in den Schemas ACCOUNT_USAGE und READER_ACCOUNT_USAGE mit folgenden Unterschieden verfügbar:

  • Die folgende Spalte ist nur in der Leserkontoansicht verfügbar:

    • READER_ACCOUNT_NAME

  • Die folgenden Spalten werden nicht in der Leserkontoansicht angezeigt:

    • CLUSTER_NUMBER

    • BYTES_SCANNED

    • ROWS_PRODUCED

    • OUTBOUND_DATA_TRANSFER_CLOUD

    • INBOUND_DATA_TRANSFER_CLOUD

    • INBOUND_DATA_TRANSFER_REGION

    • INBOUND_DATA_TRANSFER_BYTES

Siehe auch:

QUERY_HISTORY , QUERY_HISTORY_BY_* (Information Schema-Tabellenfunktion)

Spalten

Spaltenname

Datentyp

Beschreibung

READER_ACCOUNT_NAME

TEXT

Name des Leserkontos, in dem die SQL-Anweisung ausgeführt wurde.

QUERY_ID

TEXT

Interner/vom System generierter Bezeichner für die SQL-Anweisung.

QUERY_TEXT

TEXT

Text der SQL-Anweisung.

DATABASE_ID

NUMBER

Interner/vom System generierter Bezeichner für die Datenbank, die verwendet wurde.

DATABASE_NAME

TEXT

Datenbank, die zum Zeitpunkt der Abfrage verwendet wurde.

SCHEMA_ID

NUMBER

Interner/vom System generierter Bezeichner für das Schema, die verwendet wurde.

SCHEMA_NAME

TEXT

Schema, das zum Zeitpunkt der Abfrage verwendet wurde.

QUERY_TYPE

TEXT

DML, Abfrage usw. Wenn die Abfrage gerade ausgeführt wird oder fehlgeschlagen ist, kann der Abfragetyp UNKNOWN lauten.

SESSION_ID

NUMBER

Sitzung, die die Anweisung ausgeführt hat.

USER_NAME

TEXT

Benutzer, der die Abfrage ausgegeben hat.

ROLE_NAME

TEXT

Rolle, die zum Zeitpunkt der Abfrage in der Sitzung aktiv war.

WAREHOUSE_ID

NUMBER

Interner/vom System generierter Bezeichner für das Warehouse, das verwendet wurde.

WAREHOUSE_NAME

TEXT

Warehouse, in dem die Abfrage ggf. ausgeführt wurde.

WAREHOUSE_SIZE

TEXT

Größe des Warehouses, als diese Anweisung ausgeführt wurde.

WAREHOUSE_TYPE

TEXT

Typ des Warehouse, als diese Anweisung ausgeführt wurde.

CLUSTER_NUMBER

NUMBER

Der Cluster (in einem Multi-Cluster-Warehouse), für den diese Anweisung ausgeführt wurde.

QUERY_TAG

TEXT

Abfrage-Tag, das für diese Anweisung über den Sitzungsparameter QUERY_TAG festgelegt wird.

EXECUTION_STATUS

TEXT

Ausführungsstatus für die Abfrage: Erfolg, Fehler, Vorfall.

ERROR_CODE

NUMBER

Fehlercode, wenn die Abfrage einen Fehler zurückgegeben hat

ERROR_MESSAGE

TEXT

Fehlermeldung, wenn die Abfrage einen Fehler zurückgegeben hat

START_TIME

TIMESTAMP_LTZ

Startzeit der Anweisung (in der Zeitzone UTC)

END_TIME

TIMESTAMP_LTZ

Endzeit der Anweisung (in der Zeitzone UTC) oder NULL, wenn die Anweisung noch läuft.

TOTAL_ELAPSED_TIME

NUMBER

Verstrichene Zeit (in Millisekunden)

BYTES_SCANNED

NUMBER

Anzahl der von dieser Anweisung gescannten Bytes.

PERCENTAGE_SCANNED_FROM_CACHE

FLOAT

Prozentsatz der Daten, die vom lokalen Festplattencache gescannt wurden. Der Wertebereich reicht von 0,0 bis 1,0. Sie können mit 100 multiplizieren, um einen wahren Prozentsatz zu erhalten.

BYTES_WRITTEN

NUMBER

Anzahl der Bytes, die geschrieben wurden (z. B. beim Laden in eine Tabelle).

BYTES_WRITTEN_TO_RESULT

NUMBER

Anzahl der Bytes, die in ein Ergebnisobjekt geschrieben wurden.

BYTES_READ_FROM_RESULT

NUMBER

Anzahl der Bytes, die aus einem Ergebnisobjekt gelesen wurden.

ROWS_PRODUCED

NUMBER

Anzahl der Zeilen, die von dieser Anweisung erzeugt wurden.

ROWS_INSERTED 1

NUMBER

Anzahl der Zeilen, die von der Abfrage eingefügt wurden.

ROWS_UPDATED 1

NUMBER

Anzahl der Zeilen, die von der Abfrage aktualisiert wurden.

ROWS_DELETED 1

NUMBER

Anzahl der Zeilen, die von der Abfrage gelöscht wurden.

ROWS_UNLOADED 1

NUMBER

Anzahl der Zeilen, die während des Datenexports entladen wurden.

BYTES_DELETED 1

NUMBER

Anzahl der Bytes, die von der Abfrage gelöscht wurden.

PARTITIONS_SCANNED

NUMBER

Anzahl der gescannten Mikropartitionen.

PARTITIONS_TOTAL

NUMBER

Gesamtzahl der Mikropartitionen aller Tabellen, die in dieser Abfrage enthalten sind.

BYTES_SPILLED_TO_LOCAL_STORAGE

NUMBER

Datenmenge, die auf eine lokale Festplatte übertragen wurde.

BYTES_SPILLED_TO_REMOTE_STORAGE

NUMBER

Datenmenge, die auf eine externe Festplatte übertragen wurde.

BYTES_SENT_OVER_THE_NETWORK

NUMBER

Datenmenge, die über das Netzwerk gesendete wurde.

COMPILATION_TIME

NUMBER

Kompilierungszeit (in Millisekunden)

EXECUTION_TIME

NUMBER

Ausführungsdauer (in Millisekunden)

QUEUED_PROVISIONING_TIME

NUMBER

Zeit (in Millisekunden), die in der Warehouse-Warteschlange auf die Bereitstellung von Warehouse-Computeressourcen gewartet wurde, weil Warehouses erstellt, fortgesetzt oder in der Größe geändert wurden.

QUEUED_REPAIR_TIME

NUMBER

Zeit (in Millisekunden), die in der Warehouse-Warteschlange gewartet wurde, bis Computeressourcen im Warehouse repariert waren.

QUEUED_OVERLOAD_TIME

NUMBER

Zeit (in Millisekunden), die in der Warehouse-Warteschlange gewartet wurde, weil das Warehouse durch die aktuelle Abfrage-Workload überlastet war.

TRANSACTION_BLOCKED_TIME

NUMBER

Zeit (in Millisekunden), während der eine Sperre durch eine gleichzeitige DML-Operation aktiv war.

OUTBOUND_DATA_TRANSFER_CLOUD

TEXT

Ziel-Cloudanbieter für Anweisungen, die Daten in eine andere Region und/oder Cloud entladen.

OUTBOUND_DATA_TRANSFER_REGION

TEXT

Zielregion für Anweisungen, die Daten in eine andere Region und/oder Cloud entladen.

OUTBOUND_DATA_TRANSFER_BYTES

NUMBER

Anzahl der Bytes, die mit Anweisungen übertragen wurden, die Daten in eine andere Region und/oder Cloud entladen.

INBOUND_DATA_TRANSFER_CLOUD

TEXT

Quell-Cloudanbieter der Anweisungen, die Daten aus einer anderen Region und/oder Cloud laden.

INBOUND_DATA_TRANSFER_REGION

TEXT

Quellregion von Anweisungen, die Daten aus einer anderen Region und/oder Cloud laden.

INBOUND_DATA_TRANSFER_BYTES

NUMBER

Anzahl der Bytes, die in Anweisungen übertragen werden, die Daten aus einer anderen Region und/oder Cloud laden.

LIST_EXTERNAL_FILES_TIME

NUMBER

Zeit (in Millisekunden) für das Auflisten externer Dateien.

CREDITS_USED_CLOUD_SERVICES

NUMBER

Anzahl der für Clouddienste pro Stunde verbrauchten Credits.

RELEASE_VERSION

NUMBER

Release-Version im Format Hauptversion.Nebenversion.Patchversion.

EXTERNAL_FUNCTION_TOTAL_INVOCATIONS

NUMBER

Gesamtzahl, mit der durch diese Abfrage Remotedienste aufgerufen wurden. Weitere wichtige Details dazu finden Sie in den Nutzungshinweisen.

EXTERNAL_FUNCTION_TOTAL_SENT_ROWS

NUMBER

Gesamtzahl der Zeilen, die von dieser Abfrage bei allen Aufrufen an alle Remotedienste gesendet wurden.

EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS

NUMBER

Gesamtzahl der Zeilen, die von dieser Abfrage bei allen Aufrufen von allen Remotediensten empfangen wurden.

EXTERNAL_FUNCTION_TOTAL_SENT_BYTES

NUMBER

Gesamtzahl der Bytes, die von dieser Abfrage bei allen Aufrufen an alle Remotedienste gesendet wurden.

EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES

NUMBER

Gesamtzahl der Bytes, die von dieser Abfrage bei allen Aufrufen von allen Remotediensten empfangen wurden.

QUERY_LOAD_PERCENT

NUMBER

Der ungefähre Prozentsatz der aktiven Computeressourcen im Warehouse für diese Abfrageausführung.

IS_CLIENT_GENERATED_STATEMENT

TEXT

Ob die Abfrage von einem Client generiert wurde.

1(1,2,3,4,5)

Diese Felder zeigen Daten nur für Abfragen an, die ab dem 18. Januar 2020 ausgeführt wurden.

Nutzungshinweise

  • Die Latenzzeit der Ansicht kann bis zu 45 Minuten betragen.

  • Die Werte für die Spalten EXTERNAL_FUNCTION_TOTAL_INVOCATIONS, EXTERNAL_FUNCTION_TOTAL_SENT_ROWS, EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS, EXTERNAL_FUNCTION_TOTAL_SENT_BYTES und EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES werden von vielen Faktoren beeinflusst, darunter:

    • Anzahl der externen Funktionen in der Anweisung SQL.

    • Anzahl der Zeilen pro Batch, die an jeden Remotedienst gesendet werden.

    • Anzahl der Wiederholungen aufgrund vorübergehender Fehler (z. B. weil eine Antwort nicht innerhalb der erwarteten Zeit empfangen wurde).