Ansicht QUERY_HISTORY (Account Usage): Änderungen an Spalten und neue Spalten (Ausstehend)¶
Achtung
Diese Verhaltensänderung ist in Bundle 2024_02 enthalten.
Den aktuellen Status des Bundles finden Sie unter Bundle-Verlauf.
Die QUERY_HISTORY-Ansicht enthält die folgenden neuen Spalten und Änderungen an Spalten:
Neue Spalten in Ansicht QUERY_HISTORY¶
Wenn dieses Verhaltensänderungs-Bundle aktiviert ist, enthält die Account Usage-Ansicht QUERY_HISTORY die folgenden neuen Spalten:
Spaltenname |
Datentyp |
Beschreibung |
---|---|---|
SECONDARY_ROLE_STATS |
VARCHAR |
Eine JSON-formatierte Zeichenfolge, die drei Felder zu den in der Abfrage ausgewerteten Sekundärrollen enthält: eine Liste der Sekundärrollen oder |
ROWS_WRITTEN_TO_RESULT |
NUMBER |
Anzahl der Zeilen, die in ein Ergebnisobjekt geschrieben wurden. Für CREATE TABLE AS SELECT (CTAS) und alle DML-Operationen ist dieses Ergebnis Weitere Informationen dazu finden Sie unter Spalte ROWS_PRODUCED veraltet. |
ROWS_INSERTED |
NUMBER |
Anzahl der Zeilen, die von der Abfrage eingefügt wurden. |
QUERY_RETRY_TIME |
NUMBER |
Gesamtausführungszeit (in Millisekunden) für Abfragewiederholungen, die durch behebbare Fehler verursacht wurden. Weitere Informationen dazu finden Sie unter Abfragewiederholungsspalten. |
QUERY_RETRY_CAUSE |
VARIANT |
Array von Fehlermeldungen für behebbare Fehler. Das Array enthält eine Fehlermeldung für jeden Abfrageversuch. Wird die Abfrage nicht wiederholt, ist das Array leer. Weitere Informationen dazu finden Sie unter Abfragewiederholungsspalten. |
FAULT_HANDLING_TIME |
NUMBER |
Gesamtausführungszeit (in Millisekunden) für Abfragewiederholungen, die durch nicht behebbare Fehler verursacht wurden. Weitere Informationen dazu finden Sie unter Abfragewiederholungsspalten. |
Diese Spalten werden in der Ansicht als letzte Spalten (ganz rechts) hinzugefügt.
Weitere Informationen dazu finden Sie auch unter Information Schema: Neue Spalten in Ausgabe der Funktionen QUERY_HISTORY, QUERY_HISTORY_BY_* (Ausstehend).
Abfragewiederholungsspalten¶
Es kann sein, dass eine Abfrage ein oder mehrere Male wiederholt werden muss, um erfolgreich abgeschlossen zu werden. Es kann mehrere Ursachen geben, die zu einer Wiederholung einer Abfrage führen. Einige dieser Ursachen sind behebbar, d. h. ein Benutzer kann Änderungen vornehmen, um Abfragewiederholungen für eine bestimmte Abfrage zu reduzieren oder zu vermeiden. Wenn beispielsweise eine Abfrage aufgrund von fehlendem Arbeitsspeicher wiederholt wird, kann das Problem durch Änderung der Warehouse-Einstellungen behoben werden.
Einige Abfragewiederholungen werden durch eine Fehlertoleranz verursacht, die nicht behebbar ist. Das heißt, ein Benutzer kann keine Änderung vornehmen, um die Wiederholung der Abfrage zu verhindern. So kann beispielsweise die Abfragewiederholung durch einen Netzwerkausfall verursacht werden. In diesem Fall gibt es keine Änderung an der Abfrage oder an dem ausführenden Warehouse, mit der sich die Abfragewiederholung verhindern lässt.
Die Spalten QUERY_RETRY_TIME, QUERY_RETRY_CAUSE und FAULT_HANDLING_TIME können Ihnen helfen, Abfragen zu optimieren, die wiederholt werden, und Schwankungen in der Abfrageleistung besser zu verstehen.
Spalte ROWS_PRODUCED veraltet¶
Die Spalte ROWS_PRODUCED wird in einem zukünftigen Release veraltet sein. Der Wert in der Spalte ROWS_PRODUCED spiegelt nicht immer die logische Anzahl der Zeilen wider, die von einer Abfrage betroffenen sind. Beispielsweise kann der Wert in der Spalte ROWS_PRODUCED Zeilen enthalten, die aufgrund des Umschreibens von Mikropartitionen gelöscht wurden, und könnte größer sein als die tatsächliche Anzahl der betroffenen Zeilen. Snowflake empfiehlt stattdessen die Verwendung der Spalten ROWS_INSERTED, ROWS_UPDATED, ROWS_WRITTEN_TO RESULTS und ROWS_DELETED.
Änderungen an den Spalten der QUERY_HISTORY-Ansicht¶
Die folgenden Spalten sind in der QUERY_HISTORY-Ansicht (Account Usage) enthalten:
BYTES_WRITTEN_TO_RESULT
ROWS_INSERTED
Die Werte in diesen Spalten sind für bestimmte Typen von Abfragen wie folgt:
- Vor der Änderung:
BYTES_WRITTEN_TO_RESULT
0
für kleine Abfragen.ROWS_INSERTED:
0
für CTAS-Abfragen (CREATE TABLE AS SELECT).- Nach der Änderung:
BYTES_WRITTEN_TO_RESULT
Anzahl der Bytes, die in ein Ergebnisobjekt für kleine Abfragen geschrieben wurden.
ROWS_INSERTED:
Anzahl der Zeilen, die für CTAS-Abfragen (CREATE TABLE AS SELECT) eingefügt wurden.
Weitere Informationen dazu finden Sie auch unter Information Schema: Neue Spalten in Ausgabe der Funktionen QUERY_HISTORY, QUERY_HISTORY_BY_* (Ausstehend).
Ref.: 1431, 1524, 1540