- Schemas:
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: |
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 |
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 |
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 |
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 |
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.