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 ALL je nach Sitzung, ein Zähler mit der Anzahl der Sekundärrollen und die interne/systemgenerierte ID jeder Sekundärrolle. Zähler und Anzahl von IDs haben ein Maximum von 50.

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 1. Die Werte in den Spalten ROWS_INSERTED, ROWS_UPDATED und ROWS_DELETED geben die Anzahl der tatsächlich eingefügten, aktualisierten oder gelöschten Zeilen wieder.

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