Abfrageaktivität mit Abfrageverlauf überwachen¶

Erforderliche Berechtigungen zum Anzeigen des Abfrageverlaufs¶

Sie können jederzeit den Verlauf der von Ihnen ausgeführten Abfragen einsehen.

Es hängt aber von Ihrer aktiven Rolle ab, für welche weitere Abfragen Ihnen auf der Seite Query History Verläufe angezeigt werden:

• Wenn Ihre aktive Rolle die Rolle ACCOUNTADMIN ist, können Sie Verläufe aller Abfragen des Kontos einsehen.

• Wenn Ihre aktive Rolle die Berechtigung MONITOR oder OPERATE für ein Warehouse hat, können Sie Abfragen anzeigen, die von anderen Benutzern ausgeführt wurden, die dieses Warehouse verwenden.

• Wenn Ihrer aktiven Rolle die Datenbankrolle GOVERNANCE_VIEWER für die Datenbank SNOWFLAKE zugewiesen ist, können Sie den Abfrageverlauf für alle Benutzer in Ihrem Konto anzeigen. Siehe SNOWFLAKE-Datenbankrollen.

• Wenn Ihrer aktiven Rolle die Datenbankrolle READER_USAGE_VIEWER für die Datenbank SNOWFLAKE zugewiesen ist, können Sie den Abfrageverlauf für alle Benutzer von Leserkonten anzeigen, die mit Ihrem Konto verbunden sind. Siehe SNOWFLAKE-Datenbankrollen.

Hinweise zur Verwendung des Abfrageverlaufs¶

Wenn Sie den Abfrageverlauf in Query History für Ihr Konto überprüfen, beachten Sie Folgendes:

• Details für Abfragen, die vor mehr als sieben Tagen ausgeführt wurden, enthalten keine User-Informationen aufgrund der Datenaufbewahrungsrichtlinie für Sitzungen. Sie können den Benutzerfilter verwenden, um die von einzelnen Benutzern ausgeführten Abfragen abzurufen. Siehe Abfrageverlaufsfilter.

• Bei Abfragen, die aufgrund von Syntax- oder Parsing-Fehlern fehlgeschlagen sind, wird Ihnen anstelle der ausgeführten SQL-Anweisung <redacted> (Abfragetext ist unkenntlich gemacht) angezeigt. Wenn Sie über eine Rolle mit entsprechenden Berechtigungen verfügen, können Sie den Parameter ENABLE_UNREDACTED_QUERY_SYNTAX_ERROR setzen, um den vollständigen Abfragetext anzuzeigen.

• Für Filter und die Spalten Started und End Time wird Ihre aktuelle Zeitzone verwendet. Sie können diese Einstellung nicht ändern. Die Einstellung des Parameters TIMEZONE für die Sitzung ändert nicht die verwendete Zeitzone.

Abfrageverlaufsfilter¶

Sie können die Abfrageverlaufsliste nach folgenden Kriterien filtern:

• Status der Abfrage, um z. B. Abfragen mit langer Ausführungszeit, fehlgeschlagene Abfragen und Abfragen in der Warteschlange zu identifizieren.

• Benutzer, der die Abfrage ausgeführt hat, einschließlich:

  • All, um alle Benutzer anzuzeigen, für die Sie Zugriff auf den Abfrageverlauf haben.

  • Benutzer, mit dem Sie sich angemeldet haben (Standard)

  • Einzelne Snowflake-Benutzer in Ihrem Konto, wenn Sie mit Ihrer Rolle den Abfrageverlauf von anderen Benutzer einsehen dürfen.

• Zeitraum, in dem die Abfrage ausgeführt wurde, begrenzt auf 14 Tage.

• Weitere Filter, darunter die folgenden:

  • SQL Text, um beispielsweise Abfragen anzuzeigen, die bestimmte Anweisungen verwenden, wie GROUP BY.

  • Query ID, um Details zu einer bestimmten Abfrage anzuzeigen.

  • Warehouse, um Abfragen anzuzeigen, die unter Verwendung eines bestimmten Warehouses ausgeführt wurden.

  • Statement Type, um Abfragen anzuzeigen, die einen bestimmten Anweisungstyp verwenden, z. B. DELETE, UPDATE, INSERT oder SELECT.

  • Duration, um z. B. Abfragen mit besonders langer Ausführungsdauer zu identifizieren.

  • Session ID, um Abfragen anzuzeigen, die während einer bestimmten Snowflake-Sitzung ausgeführt wurden.

  • Query Tag, um Abfragen mit einem bestimmten Abfrage-Tag anzuzeigen, das über den Sitzungsparameter QUERY_TAG festgelegt wurde.

  • Parameterized Query Hash, um Abfragen gruppiert nach der im Filter angegebenen ID des parametrisierten Abfrage-Hashwert anzuzeigen. Weitere Informationen dazu finden Sie unter Verwenden des Hash-Wertes der parametrisierten Abfrage (query_parameterized_hash).

  • Client generated statements, um interne Abfragen anzuzeigen, die von einem Client, Treiber oder einer Bibliothek ausgeführt werden, einschließlich der Weboberfläche. Wenn ein Benutzer beispielsweise in Snowsight zur Seite Warehouses navigiert, führt Snowflake im Hintergrund eine SHOW WAREHOUSES-Anweisung aus. Diese Anweisung wird sichtbar, wenn dieser Filter aktiviert ist. Ihrem Konto werden keine Anweisungen in Rechnung gestellt, die vom Client generiert werden.

  • Queries executed by user tasks, um ausgeführte SQL-Anweisungen oder gespeicherte Prozeduren anzuzeigen, die von Benutzeraufgaben aufgerufen wurden.

  • Show replication refresh history, um Abfragen anzuzeigen, die zum Ausführen von Aktualisierungsaufgaben für die Replikation in Remoteregionen und Remotekonten verwendet werden.

Wenn Sie Ergebnisse nahezu in Echtzeit anzeigen möchten, aktivieren Sie Auto Refresh. Wenn Auto Refresh aktiviert ist, wird die Tabelle alle zehn Sekunden aktualisiert.

In der Tabelle Queries werden standardmäßig die folgenden Spalten angezeigt:

• SQL Text mit dem Text der ausgeführten Anweisung (immer angezeigt).

• Query ID mit der ID der Abfrage (immer angezeigt).

• Status mit dem Status der ausgeführten Anweisung (immer angezeigt).

• User mit dem Benutzernamen, der eine Anweisung ausgeführt hat.

• Warehouse mit dem Warehouse, das zum Ausführen einer Anweisung verwendet wurde.

• Duration mit der Zeitdauer, die zum Ausführen einer Anweisung benötigt wurde.

• Started mit dem Zeitpunkt, zu dem die Ausführung der Anweisung gestartet wurde.

Wenn Sie mehr Ergebnisse haben, können Sie die Tabelle nicht sortieren. Wenn Sie nach dem Sortieren der Tabelle Load More am Anfang der Liste auswählen, werden die neuen Ergebnisse an das Ende der Daten angehängt und die Sortierreihenfolge gilt nicht mehr.

Um spezifischere Informationen anzuzeigen, können Sie durch Auswahl von Columns Spalten zur Tabelle hinzuzufügen oder entfernen, z. B.:

• All, um alle Spalten anzuzeigen.

• User, um den Benutzer anzuzeigen, der die Anweisung ausgeführt hat.

• Warehouse, um den Namen des Warehouse anzuzeigen, das für die Ausführung der Anweisung verwendet wird.

• Warehouse Size, um die Größe des Warehouses anzuzeigen, das zur Ausführung der Anweisung verwendet wurde.

• Duration, um die Zeit anzuzeigen, die für die Ausführung der Anweisung benötigt wurde.

• Started, um die Startzeit der Anweisung anzuzeigen.

• End Time, um den Zeitpunkt anzuzeigen, an dem die Ausführung der Anweisung beendet war.

• Session ID, um den ID der Sitzung anzuzeigen, die die Anweisung ausgeführt hat.

• Client Driver, um den Namen und die Version von Client, Treiber oder Bibliothek anzuzeigen, die zur Ausführung der Anweisung verwendet werden. Bei Anweisungen, die in Snowsight ausgeführt werden, wird Go 1.1.5 angezeigt.

• Bytes Scanned, um die Anzahl der Bytes anzuzeigen, die während der Verarbeitung der Abfrage gescannt wurden.

• Rows, um die Anzahl der von einer Anweisung zurückgegebenen Zeilen anzuzeigen.

• Query Tag, um das auf eine Abfrage gesetzte Tag anzuzeigen.

• Parameterized Query Hash, um Abfragen anzuzeigen, die nach der ID des im Filter angegebenen parametrisierten Abfrage-Hashwerts gruppiert sind. Weitere Informationen dazu finden Sie unter Verwenden des Hash-Wertes der parametrisierten Abfrage (query_parameterized_hash).

• Incident, um Details zu Anweisungen mit Ausführungsstatus „Incident“ (Vorfall) anzuzeigen, die für Problembehandlung oder Debugging verwendet werden können.

Um zusätzliche Details zu einer Abfrage anzuzeigen, wählen Sie die Abfrage in der Tabelle aus, wodurch Query Details geöffnet wird.

So verwenden Sie den gruppierten Abfrageverlauf¶

Gehen Sie wie folgt vor, um die Seite Grouped Query History unter Snowsight aufzurufen:

1. Melden Sie sich bei Snowsight an.

2. Wählen Sie Monitoring » Query History » Grouped Queries aus. Die Seite zeigt Ihnen Abfragen gruppiert nach der gemeinsamen ID ihres parametrisierten Abfrage-Hashwerts.

   Bemerkung

   Die einzelnen Abfragen werden nicht sofort in der Liste Grouped Queries angezeigt. Die Latenzzeit für die Aktualisierung der Liste anhand der Datensätze in der Ansicht AGGREGATE_QUERY_HISTORY kann bis zu 180 Minuten (3 Stunden) betragen, aber die Liste wird oft viel schneller aufgefüllt.

3. Wählen Sie eine beliebige gruppierte Abfrage aus, um Leistungsstatistiken für diesen parametrisierten Abfrage-Hashwert anzuzeigen. Snowsight zeigt die Gesamtzahl der ausgeführten Abfragen, die Anzahl der fehlgeschlagenen Abfragen, die Latenz (p50, p90, p99) und die Ausführungen pro Minute an. Im unteren Abschnitt der Seite finden Sie einige Beispiele für einzelne Abfragen, die im Rahmen dieses Hashwerts ausgeführt wurden. Sie können jede Abfrage auswählen, um ihre spezifischen Details anzuzeigen.

   Während des letzten Tages wurden in dieser Gruppe beispielsweise etwa 35 Mio. Abfragen mit einer Gesamtdauer von 196 Stunden und einer Gesamtwartedauer von 87 ms durchgeführt:

   

   Unten auf der Seite können Sie die Liste der Abfragen nach Status, Dauer und anderen Metriken sortieren.

4. Wählen Sie Monitoring » Query History » Individual Queries, um einzelne Abfragen anzuzeigen.

   Diese Ansicht spiegelt nicht alle Abfragen wider, die von Unistore Workloads ausgeführt werden, angesichts der schieren Menge an Abfragen, die für Hybridtabellen erstellt werden können. Weitere Informationen zu dieser Verhaltensweise finden Sie unter Abfrageverlauf für Hybridtabellen.

   Snowflake empfiehlt, dass alle Benutzer mit Unistore Workloads mit der Ansicht Grouped Queries beginnen.

Sie können die Liste Grouped Queries zwar nicht filtern, aber Sie können selbst aggregierte Abfragen durchführen, die gefilterte Ergebnisse liefern.

Erforderliche Berechtigungen zum Anzeigen des gruppierten Abfrageverlaufs¶

Benutzer können jederzeit den Verlauf der von ihnen durchgeführten Abfragen anzeigen. Die aktive Rolle eines Benutzers beeinflusst, welche anderen Abfragen angezeigt werden. Sie können sowohl Grouped Queries als auch Individual Queries anzeigen, wenn einer der folgenden Punkte zutrifft:

• Ihre aktive Rolle ist ACCOUNTADMIN.

• Ihre aktive Rolle wurde IMPORTED PRIVILEGES in der Datenbank SNOWFLAKE zugewiesen (siehe Ermöglicht anderen Rollen die Verwendung von Schemas in der SNOWFLAKE-Datenbank.).

• Sie haben die GOVERNANCE_VIEWER Datenbankrolle.

Wenn Sie keine dieser Rollen oder Berechtigungen haben, können Sie nur Individual Queries anzeigen. Weitere Informationen über Zugriffsrechte finden Sie unter Abfrageaktivität mit Abfrageverlauf überwachen.

Von einer Snowflake Native App ausgeblendete Query Profile-Daten¶

Das Snowflake Native App Framework maskiert in den folgenden Kontexten die Informationen aus dem Query Profile:

• Abfragen, die ausgeführt werden, wenn die App installiert oder aktualisiert wird.

• Abfragen, die von einer gespeicherten Prozedur stammen, deren Eigentümer die App ist.

• Abfragen, die eine nicht sichere Ansicht oder Funktion enthalten, deren Eigentümer die App ist.

Für jeden dieser Abfragetypen fasst Snowsight die Query Profile-Daten zu einem einzigen leeren Knoten zusammen, anstatt den vollständigen Query Profile-Strukturbaum anzuzeigen.

Abfragedetails überprüfen¶

Um die Details einer bestimmten Abfrage zu überprüfen und die Ergebnisse einer erfolgreichen Abfrage anzuzeigen, öffnen Sie Query Details für eine Abfrage.

Unter Details können Sie Informationen zur Abfrageausführung überprüfen, einschließlich:

• Status der Abfrage

• Zeitpunkt des Beginns der Abfrage, in der lokalen Zeitzone des Benutzers

• Zeitpunkt des Endes der Abfrage, in der lokalen Zeitzone des Benutzers

• Größe des für die Abfrage verwendeten Warehouses

• Dauer der Abfrage

• Abfrage-ID

• Abfrage-Tag für die Abfrage, falls vorhanden

• Treiberstatus. Weitere Details dazu finden Sie unter Anzeigen der verwendeten Snowflake-Clientversionen.

• Namen und Version von Client, Treiber oder Bibliothek, die zur Übermittlung der Abfrage verwendet wurden. Beispiel: Go 1.1.5 für Abfragen, die über Snowsight ausgeführt wurden.

• Sitzung-ID

Über der Registerkarte Query Details wird das Warehouse angezeigt, das zur Ausführung der Abfrage verwendet wurde, sowie der Benutzer, der die Abfrage ausgeführt hat.

Der Bereich SQL Text enthält den eigentlichen Text der Abfrage. Bewegen Sie den Mauszeiger über den SQL-Text, um die Anweisung in einem Arbeitsblatt zu öffnen oder die Anweisung zu kopieren. Wenn die Abfrage fehlgeschlagen ist, können Sie die Fehlerdetails überprüfen.

Der Bereich Results enthält die Ergebnisse der Abfrage. Es werden nur die ersten 10.000 Zeilen eines Ergebnisses angezeigt, und die Ergebnisse können nur von dem Benutzer eingesehen werden, der die Abfrage ausgeführt hat. Wählen Sie Export Results aus, um den vollständigen Satz von Ergebnissen als CSV-formatierte Datei zu exportieren.

Fehlersuche, warum Abfragedetails möglicherweise nicht verfügbar sind¶

Wenn eine Abfrage keine Abfragedetails enthält, kann dies unter anderem folgende Ursachen haben:

• Die Abfrage wird noch ausgeführt. Sobald die Abfrage beendet ist, können Sie die Abfragedetails und das Profil einsehen.

• Ihre Rolle hat keine Berechtigung zum Anzeigen der Abfragedetails.

• Die Abfrage wurde vor mehr als 14 Tagen ausgeführt, sodass Abfragedetails und Profil nicht mehr verfügbar sind.

• Die Abfrage konnte nicht ausgeführt werden und hat daher kein Abfrageprofil.

• Die Snowflake-Plattform ist zwar so konzipiert, dass Auftragsdetails erhalten bleiben, aber die Tiefe der Auftragsabfrage-Details und der Abfrageprofil-Metriken erfolgt auf bestmöglicher Basis und ist nicht für alle Abfragen garantiert.

Query Profile überprüfen¶

Auf der Registerkarte Query Profile können Sie den Ausführungsplan der Abfrage untersuchen und detaillierte Informationen zu den einzelnen Ausführungsschritten abrufen.

Query Profile ist ein leistungsfähiges Tool zum Verständnis der Mechanismen von Abfragen. Es kann verwendet werden, wenn Sie mehr über die Leistung oder das Verhalten einer bestimmten Abfrage erfahren müssen. Das Tool soll Ihnen helfen, typische Fehler in SQL-Abfrageausdrücken zu erkennen, um potenzielle Leistungsengpässe und Verbesserungsmöglichkeiten zu identifizieren.

Dieser Abschnitt gibt einen kurzen Überblick über die Navigation und Verwendung von Query Profile.

• Ausführungsplan von Abfragen

• Operatorknoten

• Query Profile-Navigation

• Informationsbereiche

Schnittstelle	Beschreibung
Ausführungsplan von Abfragen	Der Ausführungsplan von Abfragen wird in der Mitte von Query Profile angezeigt. Der Ausführungsplan von Abfragen besteht aus Operatorknoten, die Rowset-Operatoren repräsentieren. Pfeile zwischen den Operatoren zeigen die Rowsets an, die von einem Operator zu einem anderen weitergegeben werden.
Operatorknoten	Jeder Operatorknoten enthält folgende Informationen: Operatortyp und Operator-ID Die für das Ausführen dieses Operators benötigte Zeit in Prozent der Abfragedauer Vorschau der Operatordetails. Beispielsweise der Name einer Tabelle oder einer Liste von Ausdrücken.
Query Profile-Navigation	Verwenden Sie die Schaltflächen in der linken oberen Ecke von Query Profile für folgende Aktionen: Zwischen Ausführungsschritten wechseln Abfrageausführungsplan in das Fenster einpassen Abfrageausführungsplan vergrößern/verkleinern Bemerkung Schritte werden nur angezeigt, wenn die Abfrage in Schritten ausgeführt wurde.
Informationsbereiche	Query Profile bietet verschiedene Informationsbereiche. Die Bereiche werden im Abfrageausführungsplan angezeigt. Welche Bereiche angezeigt werden, hängt vom Fokus des Abfrageausführungsplans ab. Query Profile enthält die folgenden Informationsbereiche: Profile Overview Statistics Most Expensive Nodes Attributes Weitere Informationen zu den Informationen, die in den Bereichen bereitgestellt werden, finden Sie unter Referenz zum Query Profile.

Von einer Snowflake Native App ausgeblendete Abfrageverlaufsdaten¶

Bei Abfragen, die sich auf eine Snowflake Native App beziehen, werden die Felder query_text und error_message in der Abfragehistorie (Query History) in den folgenden Kontexten ausgeblendet:

• Abfragen, die ausgeführt werden, wenn die App installiert oder aktualisiert wird.

• Abfragen, die von einem untergeordneten Job einer gespeicherten Prozedur stammen, deren Eigentümer die App ist.

In jeder dieser Situationen ist die Zelle des Abfrageverlaufs in Snowsight leer.

Profilübersicht¶

Der Bereich enthält Informationen dazu, welche Verarbeitungsaufgaben Abfragezeit verbraucht haben. Die Ausführungszeit enthält Informationen darüber, wofür die Zeit während der Verarbeitung einer Abfrage verbraucht wurde. Die aufgewendete Zeit kann in folgende Kategorien unterteilt werden:

• Processing – Zeit, die von der CPU für die Datenverarbeitung verbraucht wurde.

• Local Disk IO – Zeit, in der die Verarbeitung durch den Zugriff auf die lokale Festplatte blockiert wurde.

• Remote Disk IO – Zeit, in der die Verarbeitung durch Remote-Festplattenzugriff blockiert wurde.

• Network Communication – Zeit, in der die Verarbeitung auf die Netzwerkdatenübertragung wartete.

• Synchronization – Verschiedene Synchronisationsaktivitäten zwischen den beteiligten Prozessen.

• Initialization – Zeit, die für das Einrichten der Abfrageverarbeitung verbraucht wurde.

• Hybrid Table Requests Throttling – Zeitaufwand Drosselung von Anfragen zum Lesen und Schreiben von Daten, die in Hybridtabellen gespeichert sind.

Statistiken¶

Eine wichtige Informationsquelle im Detailbereich sind die verschiedenen Statistiken, die in folgende Abschnitte unterteilt sind:

• IO – Informationen zu den während der Abfrage ausgeführten Eingabe/Ausgabe-Operationen:

  • Scan progress – Prozentsatz der Daten, die bislang für eine bestimmte Tabelle gescannt wurden.

  • Bytes scanned – Anzahl der bislang gescannten Bytes.

  • Percentage scanned from cache – Prozentsatz der Daten, die vom lokalen Festplattencache gescannt wurden.

  • Bytes written – Geschriebene Bytes (z. B. beim Laden in eine Tabelle).

  • Bytes written to result – Bytes, die in das Ergebnisobjekt geschrieben wurden. So würde beispielsweise select * from . . . eine Menge von Ergebnissen im tabellarischen Format 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 to result – Bytes, die aus dem Ergebnisobjekt gelesen wurden.

  • External Bytes scanned – Bytes, die von einem externen Objekt, z. B. einem Stagingbereich, gelesen wurden.

• DML – Statistiken zu DML–Abfragen (Datenbearbeitungssprache):

  • Number of rows inserted – Anzahl der in eine Tabelle (oder Tabellen) eingefügten Zeilen.

  • Number of rows updated – Anzahl der in einer Tabelle aktualisierten Zeilen.

  • Number of rows deleted – Anzahl der aus einer Tabelle gelöschten Zeilen.

  • Number of rows unloaded – Anzahl der während des Datenexports entladenen Zeilen.

• Pruning – Informationen zu den Auswirkungen der Tabellenverkürzung:

  • Partitions scanned – Anzahl der bisher gescannten Partitionen.

  • Partitions total – Gesamtanzahl der Partitionen einer Tabelle.

• Spilling – Informationen zur Festplattennutzung für Operationen, bei denen Zwischenergebnisse nicht in den Arbeitsspeicher passen:

  • Bytes spilled to local storage – Datenmenge, die auf die lokale Festplatte übertragen wurde.

  • Bytes spilled to remote storage – Datenmenge, die auf die externe Festplatte übertragen wurde.

• Network – Netzwerk-Kommunikation:

  • Bytes sent over the network – Über das Netzwerk gesendete Datenmenge.

• External Functions – Informationen zu Aufrufen externer Funktionen:

  Die folgenden Statistiken werden für jede externe Funktion angezeigt, die von der SQL-Anweisung aufgerufen wird. Wenn dieselbe Funktion mehrmals von derselben SQL-Anweisung aufgerufen wurde, werden die Statistiken aggregiert.

  • Total invocations – Häufigkeit, mit der eine externe Funktion aufgerufen wurde. Der Wert kann sich von der Anzahl der externen Funktionsaufrufe im Text der SQL-Anweisung unterscheiden und zwar aufgrund der Anzahl der Batches, in die Zeilen unterteilt sind, der Anzahl der Wiederholungsversuche (bei vorübergehenden Netzwerkproblemen) usw.

  • Rows sent – Anzahl der an externe Funktionen gesendeten Zeilen.

  • Rows received – Anzahl der von externen Funktionen empfangenen Zeilen.

  • Bytes sent (x-region) – Anzahl der an externe Funktionen gesendeten Bytes. Wenn das Etikett „(x-region)“ enthält, wurden die Daten über Regionen hinweg gesendet (was sich auf die Abrechnung auswirken kann).

  • Bytes received (x-region) – Anzahl der von externen Funktionen empfangenen Bytes. Wenn das Etikett „(x-region)“ enthält, wurden die Daten über Regionen hinweg gesendet (was sich auf die Abrechnung auswirken kann).

  • Retries due to transient errors – Anzahl der Wiederholungen aufgrund vorübergehender Fehler.

  • Average latency per call – Durchschnittliche Zeit pro Aufruf zwischen dem Zeitpunkt, zu dem Snowflake die Daten gesendet hat, und dem Zeitpunkt, zu dem Snowflake die zurückgegebenen Daten empfangen hat.

  • HTTP 4xx errors – Gesamtzahl der HTTP-Anforderungen, die einen 4xx-Statuscode zurückgegeben haben.

  • HTTP 5xx errors – Gesamtzahl der HTTP-Anforderungen, die einen 5xx-Statuscode zurückgegeben haben.

  • Latency per successful call (avg) – Durchschnittliche Latenz von erfolgreichen HTTP-Anforderungen.

  • Avg throttle latency overhead – Durchschnittlicher Overhead pro erfolgreicher Anforderung aufgrund einer durch Drosselung verursachten Verlangsamung (HTTP 429).

  • Batches retried due to throttling – Anzahl der Batches, deren Ausführung aufgrund von HTTP-Fehler 429 erneut versucht wurden.

  • Latency per successful call (P50) – 50. Perzentil-Latenz von erfolgreichen HTTP-Anforderungen. 50 Prozent aller erfolgreichen Anforderungen wurden in weniger als dieser Zeit abgeschlossen.

  • Latency per successful call (P90) – 90. Perzentil-Latenz von erfolgreichen HTTP-Anforderungen. 90 Prozent aller erfolgreichen Anforderungen wurden in weniger als dieser Zeit abgeschlossen.

  • Latency per successful call (P95) – 95. Perzentil-Latenz von erfolgreichen HTTP-Anforderungen. 95 Prozent aller erfolgreichen Anforderungen wurden in weniger als dieser Zeit abgeschlossen.

  • Latency per successful call (P99) – 99. Perzentil-Latenz von erfolgreichen HTTP-Anforderungen. 99 Prozent aller erfolgreichen Anforderungen wurden in weniger als dieser Zeit abgeschlossen.

• Extension Functions – Informationen zu Aufrufen von Erweiterungsfunktionen:

  • Java UDF handler load time – Zeit, die der Java-UDF-Handler zum Laden benötigt.

  • Total Java UDF handler invocations – Anzahl der Aufrufe des Java-UDF-Handlers.

  • Max Java UDF handler execution time – Maximaler Zeitaufwand für die Ausführung des Java-UDF-Handlers.

  • Avg Java UDF handler execution time – Durchschnittlicher Zeitaufwand für die Ausführung des Java-UDF-Handlers.

  • Java UDTF process() invocations – Anzahl der Aufrufe der Java-UDTF-Methode process.

  • Java UDTF process() execution time – Zeitaufwand für die Ausführung des Java-UDTF-Prozesses.

  • Avg Java UDTF process() execution time – Durchschnittlicher Zeitaufwand für die Ausführung des Java-UDTF-Prozesses.

  • Java UDTF’s constructor invocations – Anzahl der Aufrufe des Java-UDTF-Konstruktors.

  • Java UDTF’s constructor execution time – Zeitaufwand für die Ausführung des Java-UDTF-Konstruktors.

  • Avg Java UDTF’s constructor execution time – Durchschnittlicher Zeitaufwand für die Ausführung des Java-UDTF-Konstruktors.

  • Java UDTF endPartition() invocations – Anzahl der Aufrufe der Java-UDTF-Methode endPartition.

  • Java UDTF endPartition() execution time – Zeitaufwand für die Ausführung der Java-UDTF-Methode endPartition.

  • Avg Java UDTF endPartition() execution time – Durchschnittlicher Zeitaufwand für die Ausführung der Java-UDTF-Methode endPartition.

  • Max Java UDF dependency download time – Maximaler Zeitaufwand für das Herunterladen der Java-UDF-Abhängigkeiten.

  • Max JVM memory usage – Spitzenauslastung des Arbeitsspeichers, wie von JVM gemeldet.

  • Java UDF inline code compile time in ms – Kompilierungszeit für den Java-UDF-Inline-Code.

  • Total Python UDF handler invocations – Anzahl der Aufrufe des Python-UDF-Handlers.

  • Total Python UDF handler execution time – Gesamtausführungszeit für den Python-UDF-Handler.

  • Avg Python UDF handler execution time – Durchschnittlicher Zeitaufwand für die Ausführung des Python-UDF-Handlers.

  • Python sandbox max memory usage – Spitzenauslastung des Arbeitsspeichers durch die Python-Sandbox-Umgebung.

  • Avg Python env creation time: Download and install packages – Durchschnittlicher Zeitaufwand für das Erstellen der Python-Umgebung, einschließlich des Herunterladens und Installierens von Paketen.

  • Conda solver time – Zeitaufwand für die Ausführung des Conda-Solvers zur Auflösung von Python-Paketen.

  • Conda env creation time – Zeitaufwand für das Erstellen der Python-Umgebung.

  • Python UDF initialization time – Zeitaufwand für das Initialisieren der Python-UDF.

  • Number of external file bytes read for UDFs – Anzahl der für UDFs gelesenen Bytes für externe Dateien.

  • Number of external files accessed for UDFs – Anzahl der Zugriffe auf externe Dateien für UDFs.

  Wenn der Wert eines Feldes, z. B. „Retries due to transient errors“, null ist, wird das Feld nicht angezeigt.

Die teuersten Knoten¶

Im Bereich werden alle Knoten aufgelistet, die 1 % oder mehr der gesamten Ausführungszeit der Abfrage (oder die Ausführungszeit für den angezeigten Abfrageschritt, wenn die Abfrage in mehreren Verarbeitungsschritten ausgeführt wurde) in Anspruch genommen haben. Der Bereich listet die Knoten nach Ausführungszeit in absteigender Reihenfolge auf, sodass Benutzer die teuersten Operatorknoten in Bezug auf die Ausführungszeit schnell finden können.

Attribute¶

In den folgenden Abschnitten finden Sie eine Liste der häufigsten Operatortypen und ihrer Attribute.

„Explodierende“ Joins¶

Einer der häufigsten Fehler von SQL-Benutzern besteht darin, Tabellen zu verknüpfen, ohne eine Join-Bedingung anzugeben (was zu einem „Kartesischen Produkt“ führt), oder eine Bedingung bereitzustellen, bei der Datensätze einer Tabelle mit mehreren Datensätzen einer anderen Tabelle übereinstimmen. Für solche Abfragen produziert der Operator Join signifikant (oft um Größenordnungen) mehr Tupel, als er verbraucht.

Dies kann beobachtet werden, indem die Anzahl der Datensätze betrachtet wird, die von einem Join-Operator erzeugt wurden. Dies spiegelt sich normalerweise auch in Join-Operatoren wider, die viel Zeit in Anspruch nehmen.

UNION ohne ALL¶

In SQL können zwei Datasets mit UNION- oder UNION ALL-Konstrukten kombiniert werden. Der Unterschied zwischen beiden besteht darin, dass mit UNION ALL die Eingaben einfach verkettet werden, während UNION dasselbe tut, aber auch eine doppelte Löschung durchführt.

Ein häufiger Fehler ist die Verwendung von UNION, wenn die UNION ALL-Semantik ausreicht. Diese Abfragen werden in Query Profile als UnionAll-Operator mit einem zusätzlichen Aggregate-Operator darüber angezeigt (der eine doppelte Löschung vornimmt).

Abfragen, die zu groß für den Arbeitsspeicher sind¶

Bei einigen Operationen (z. B. doppelte Löschung bei einem großen Dataset) reicht die für die Server zur Ausführung der Operation zur Verfügung stehende Speicherkapazität möglicherweise nicht aus, um Zwischenergebnisse zu speichern. Als Ergebnis beginnt das Abfrageverarbeitungsmodul, die Daten auf die lokale Festplatte zu übertragen. Wenn der lokale Speicherplatz nicht ausreicht, werden die Überlaufdaten auf Remote-Festplatten gespeichert.

Dieser Überlauf kann sich erheblich auf die Abfrageleistung auswirken (insbesondere, wenn für den Überlauf ein Remote-Datenträger verwendet wird). Um die Auswirkungen zu reduzieren, empfehlen wir Folgendes:

• Verwenden eines größeren Warehouse (effektives Erhöhen des verfügbaren Arbeitsspeichers bzw. des lokalen Festplattenspeichers für die Operation) und/oder

• Verarbeiten der Daten in kleineren Batches.

Ineffizientes Verkürzen (Pruning)¶

Snowflake sammelt umfangreiche Statistiken zu Daten, sodass basierend auf den Abfragefiltern keine unnötigen Teile einer Tabelle gelesen werden. Um diesen Effekt zu erzielen, muss die Reihenfolge der Datenspeicherung mit den Abfragefilterattributen korreliert werden.

Die Effizienz des Verkürzungsprozesses kann durch Vergleichen der Statistiken Partitions scanned und Partitions total in den TableScan-Operatoren überwacht werden. Wenn ersterer Wert ein kleiner Bruchteil des letzteren Werts ist, dann ist das Verkürzen effizient. Wenn nicht, hatte das Verkürzen keine Wirkung.

Das Verkürzen kann natürlich nur für Abfragen hilfreich sein, bei denen tatsächlich eine erhebliche Datenmenge herausgefiltert wird. Wenn in den Verkürzungsstatistiken keine Datenreduktion angezeigt wird, über TableScan jedoch ein Filter-Operator steht, der eine Anzahl von Datensätzen herausfiltert, könnte dies darauf hindeuten, dass für diese Abfrage eine andere Organisation der Daten von Vorteil ist.

Weitere Informationen zum Verkürzen finden Sie unter Grundlegendes zu Tabellenstrukturen in Snowflake.