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
- QUERY_ACCELERATION_BYTES_SCANNED
- QUERY_ACCELERATION_PARTITIONS_SCANNED
- QUERY_ACCELERATION_UPPER_LIMIT_SCALE_FACTOR

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 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 der Abfrage. Gültige Werte: `success` (Erfolg), `fail` (Fehler), `incident` (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).
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. Beispielsweise würde `select * from . . .` eine Menge von Ergebnissen im Tabellenformat für jedes Feld in der Auswahl liefern. . . Im Allgemeinen repräsentiert das Ergebnisobjekt das, was als Ergebnis der Abfrage erzeugt wird, und `BYTES_WRITTEN_TO_RESULT` steht für die Größe des zurückgegebenen Ergebnisses.
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 Credits, die für Clouddienste verbraucht wurden.
RELEASE_VERSION	NUMBER	Release-Version im Format `major_release.minor_release.patch_release` (<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	BOOLEAN	Gibt an, ob die Abfrage von einem Client generiert wurde.
QUERY_ACCELERATION_BYTES_SCANNED	NUMBER	Anzahl der vom Abfragebeschleunigungsdienst gescannten Bytes.
QUERY_ACCELERATION_PARTITIONS_SCANNED	NUMBER	Anzahl der vom Abfragebeschleunigungsdienst gescannten Partitionen.
QUERY_ACCELERATION_UPPER_LIMIT_SCALE_FACTOR	NUMBER	Oberes Limit des Skalierungsfaktors, der für eine Abfrage von Vorteil wäre.
CHILD_QUERIES_WAIT_TIME	NUMBER	Zeit (in Millisekunden), die bei Aufruf einer memoisierbaren Funktion bis zum Abschluss der zwischengespeicherten Suche benötigt wird.
OWNER	TEXT	Name der Rolle, die Eigentümer der Rolle ist, die zum Zeitpunkt der Abfrage in der Sitzung aktiv war.
OWNER_ROLE_TYPE	TEXT	Typ der Rolle, die Eigentümer des Objekts ist, entweder `ROLE` oder `DATABASE_ROLE`. Beachten Sie, dass Snowflake NULL zurückgibt, wenn Sie das Objekt löschen, da es keine Eigentümerrolle für ein gelöschtes Objekt gibt.
TRANSACTION_ID	NUMBER	ID der Transaktion, die die Anweisung enthält, oder 0, wenn die Anweisung nicht innerhalb einer Transaktion ausgeführt wird.
ROLE_TYPE	VARCHAR	Gibt an, ob die Abfrage von einer Rolle vom Typ `ROLE` oder `DATABASE_ROLE` ausgeführt 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).
Die Spalte CHILD_QUERIES_WAIT_TIME ist standardmäßig nicht in der Ausgabe enthalten.

Damit die Spalte hinzugefügt wird, müssen Sie das Verhaltensänderungs-Release-Bundle 2023_01 aktivieren.

Weitere Informationen zum Aktivieren von Verhaltensänderungs-Release-Bundles finden Sie unter Verwalten von Verhaltensänderungen.