Abfragen von Daten über Arbeitsblätter¶

Nach dem Erstellen oder Öffnen eines Arbeitsblatts können Sie das Arbeitsblatt verwalten, Abfragen schreiben und ausführen, Abfrageergebnisse und den Abfrageverlauf untersuchen sowie Filter mit Snowsight einrichten.

Unter diesem Thema:

Schreiben von Abfragen in Arbeitsblättern¶

Nachdem Sie ein Arbeitsblatt geöffnet haben, können Sie SQL-Abfragen und -Anweisungen schreiben.

Arbeitsblattkontext festlegen¶

Wenn Sie eine Datenbank und optional ein Datenbankschema als Arbeitsblattkontext festlegen, können Sie auf Objekte im Schema verweisen, ohne die Objektnamen in de Abfrage vollständig qualifizieren zu müssen.

Abfragen mit Autovervollständigung schreiben¶

Wenn Sie Ihr Skript in den Abfrage-Editor eingeben, schlägt die Autovervollständigung Folgendes vor:

Schlüsselwörter für Abfragesyntax wie SQL-Funktionen oder Aliasse.
Werte, die mit Tabellen- oder Spaltennamen innerhalb eines Schemas übereinstimmen

Wählen Sie eine Funktion aus, um deren Syntax und eine kurze Beschreibung anzuzeigen.

Snowflake verfolgt Tabellenaliasse und schlägt sie als Optionen für die Autovervollständigung vor. Wenn Sie beispielsweise eine Abfrage mit posts as p oder posts p als Alias ausführen, schlägt die Autovervollständigung bei der nächsten Eingabe von p diesen Alias als Option vor.

SQL-Skript an ein bestehendes Arbeitsblatt anhängen¶

Wenn Sie ein SQL-Skript in einer Datei haben, können Sie dieses wie folgt an ein vorhandenes Arbeitsblatt anhängen:

Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Bewegen Sie den Mauszeiger über die Registerkarte des Arbeitsblatts, und wählen Sie und dann Import SQL from File aus.
Navigieren Sie zu der SQL-Datei auf Ihrem Computer.

Der Inhalt der Datei wird an Ihr Arbeitsblatt angehängt.

Auf Datenbankobjektnamen in Arbeitsblättern verweisen¶

Beim Schreiben von Abfragen in Ihrem Arbeitsblatt verweisen Sie auf die Datenbankobjekte, die für die Abfragen im Databases-Explorer relevant sind. Sie können bestimmte Datenbankobjekte aufschlüsseln oder die Suche verwenden, um eine Datenbank, ein Schema oder ein Objekt zu finden, auf das Sie Zugriff haben.

Mit dem Databases-Explorer können Sie Datenbanken und Datenbankobjekte zum schnellen Verweisen anpinnen. Wenn Sie den Mauszeiger über ein Datenbankobjekt bewegen, wählen Sie das Symbol Pin aus, um das Objekt anzupinnen. Angepinnte Objekte werden oben im Databases-Explorer im Bereich Pinned angezeigt. Möglicherweise müssen Sie den Bereich erweitern, um alle angepinnten Objekte zu sehen.

Nachdem Sie ein Datenbankobjekt gefunden haben, können Sie den Namen des Objekts in das Arbeitsblatt einfügen, das Sie gerade bearbeiten:

Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Suchen Sie das Datenbankobjekt im Databases-Explorer.
Bewegen Sie den Mauszeiger über den Objektnamen, und wählen Sie … » Place Name in Editor aus.

Der vollqualifizierte Objektname wird hinter der Cursorposition im Arbeitsblatt angezeigt.

Bei Datenbanktabellen und -ansichten können Sie auch die Spaltennamen zu dem Arbeitsblatt hinzufügen, das Sie gerade bearbeiten:

Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Suchen Sie das Datenbankobjekt im Databases-Explorer.
Bewegen Sie den Mauszeiger über den Objektnamen, und wählen Sie … » Add Columns in Editor aus.

Die durch Kommas getrennten Spaltennamen werden hinter der Cursorposition im Arbeitsblatt angezeigt.

Abfragen formatieren¶

Wenn ein Arbeitsblatt geöffnet ist, können Sie den Namen des Arbeitsblatts auswählen, um die Abfragen in Ihrem Arbeitsblatt zu formatieren, und die Tastaturkürzel anzeigen.

Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Bewegen Sie den Mauszeiger über die Registerkarte des Arbeitsblatts, und wählen Sie aus.
Wählen Sie in der Dropdown-Liste die Option Format query aus, um den Abfragetext zur besseren Lesbarkeit zu formatieren.

Daten in eine Tabelle laden¶

Wenn Sie ein Arbeitsblatt verwenden und einige Daten hinzufügen möchten, können Sie Daten in eine Tabelle laden, ohne Ihr Arbeitsblatt zu verlassen zu müssen:

Melden Sie sich bei Snowsight an.
Wählen Sie im Navigationsmenü die Option Projects » Worksheets aus.
Öffnen Sie das Arbeitsblatt.
Wählen Sie Objects aus, um den Objekt-Explorer anzuzeigen.
Suchen Sie eine bestimmte Tabelle über die Suche oder durch Browsen.
Bewegen Sie den Mauszeiger über einen spezifischen Tabellennamen, und wählen Sie » Load Data aus.
Folgen Sie den Anweisungen, um eine oder mehrere strukturierte oder unstrukturierte Dateien von maximal 50 MB hochzuladen.

Weitere Informationen dazu finden Sie unter Laden von Daten mithilfe der Weboberfläche.

Ausführen von Abfragen¶

Sie können eine einzelne Abfrage oder mehrere Abfragen sequenziell in demselben Arbeitsblatt ausführen.

Um eine einzelne Abfrage auszuführen, platzieren Sie im Abfrage-Editor den Cursor in der Abfrage, und wählen Sie dann die Schaltfläche Run aus.
Um das gesamte Arbeitsblatt auszuführen, wählen Sie im Dropdown-Menü More options neben der Schaltfläche Run die Option Run All aus.

Ausführen von Arbeitsblättern in Ordnern¶

Ordnern ist keine Rolle mehr zugewiesen. Ein Eigentümer oder Bearbeiter eines Arbeitsblatts in einem Ordner kann das Arbeitsblatt so ändern, dass es mit einer beliebigen Rolle ausgeführt wird. Sie können auch USE ROLE zu einem Arbeitsblatt in einem Ordner hinzufügen, um verschiedene Anweisungen in dem Arbeitsblatt mit verschiedenen Rollen auszuführen.

Wenn Sie ein Arbeitsblatt innerhalb eines Ordners erstellen, wird das Arbeitsblatt mit der Rolle Ihrer aktuellen Sitzung erstellt.

Bemerkung

Um ein Arbeitsblatt in einem Ordner auszuführen, der für Sie freigegeben wurde, müssen Sie dieselbe Rolle wie das Arbeitsblatt verwenden, auch wenn Sie über die Berechtigungen View and Run oder Edit für den Ordner verfügen. Wenn Sie nicht dieselbe Rolle haben, duplizieren Sie das Arbeitsblatt, und führen Sie es mit einer Ihrer eigenen Rollen aus.

Untersuchen der Arbeitsblattergebnisse¶

Wenn Sie eine Abfrage oder alle Abfragen in einem Arbeitsblatt ausführen, werden die Abfrageergebnisse angezeigt.

Die Abfrageergebnisse werden in einer Tabelle mit bis zu 10.000 Zeilen angezeigt. Wenn Ihre Abfrage mehr als 10.000 Zeilen liefert, können Sie mit der Option Download results alle Ergebnisse anzeigen.

Sie können in den Abfrageergebnissen mit den Pfeiltasten Ihrer Tastatur navigieren, wie Sie es von einer Tabelle gewohnt sind. Wählen Sie in der Ergebnistabelle Spalten, Zellen, Zeilen oder Bereiche aus. Jede Auswahl kann kopiert und an anderer Stelle eingefügt werden.

Wenn Sie Ihre Ergebnisse in einem Diagramm anzeigen möchten, wählen Sie Chart. Weitere Informationen zu Diagrammen finden Sie unter Visualisieren von Arbeitsblattdaten.

Die Ergebnisse umfassen auch generierte Statistiken, die kontextbezogene Informationen für jede Auswahl sowie Gesamtstatistiken für alle Ergebnisse anzeigen. Auch wenn Ihre Abfrage mehr als 10.000 Zeilen zurückgibt, beziehen sich die Statistiken auf das gesamte Resultset.

Weitere Informationen zu Arbeitsblattergebnissen und Versionsverlauf finden Sie unter Verwalten von Arbeitsblattverlauf und Versionen.

Automatische Kontextstatistik¶

Wählen Sie Spalten, Zellen, Zeilen oder Bereiche in der Ergebnistabelle aus, um relevante Informationen zu den ausgewählten Daten im Inspektorbereich (rechts neben der Ergebnistabelle) anzuzeigen. Kontextstatistiken werden automatisch für alle Spaltentypen generiert. Statistiken sollen Ihnen helfen, Ihre Daten auf einen Blick zu verstehen.

In der Spaltenübersicht wird eine Vorschau der Statistik jeder Spalte angezeigt. Wählen Sie im Inspektor oder über die Spaltenüberschrift eine Spalte aus, um deren detaillierte Spaltenstatistik anzuzeigen.

Der Statistikbereich generiert unterschiedliche Kennzahlen für verschiedene Typen von Spalten. Sie können mit den Elementen im Statistikbereich interagieren und diese filtern.

Zähler für gefüllte/leere Zeilen

Für alle Spalten wird angezeigt, wie viele Zeilen gefüllt bzw. leer sind. Spalten, in denen bestimmte Datentypen wie E-Mail und JSON angezeigt werden, geben auch die Anzahl der ungültigen Zeilen an.

Histogramme

Histogramme werden für alle Datums-, Uhrzeit- und numerischen Spalten angezeigt.

Das Histogramm zeigt die Zeilen an, die in einen bestimmten Bereich fallen. Klicken Sie auf eine Leiste, oder ziehen Sie über das Histogramm, um einen Bereich auszuwählen. Sie können Ihre Auswahl optimieren, indem Sie über dem Histogramm auf die Wertbeschriftungen klicken, um bestimmte Werte einzugeben.

Häufigkeitsverteilungen

Wird für alle kategorialen Spalten angezeigt. Kategoriale Spalten sind Textspalten, in denen dieselben Werte mehrmals verwendet werden.

E-Mail-Domain-Verteilungen

Wird für E-Mail-Spalten angezeigt. Die E-Mail-Domänenverteilung zeigt die Häufigkeitsverteilung des Auftretens von Domänennamen an.

Schlüsselverteilungen

Wird für JSON-Spalten angezeigt. Die Schlüsselverteilung zeigt die Häufigkeit der am häufigsten im Resultset auftretenden Schlüssel an, wenn alle Zeilen JSON-Objekte enthalten. Wenn die Spalte JSON-Arrays enthält, zeigt die Schlüsselverteilung die relativen Typen von JSON -Werten in der Spalte an.

Details zu Abfragen anzeigen¶

Das Abfrageprofil (Query Details) enthält Informationen zur Ausführung einer Abfrage, einschließlich:

Dauer der Abfrageausführung
Anzahl der Zeilen im Ergebnis
Beendigung der Ausführung
Menge der von der Abfrage gescannten Daten
Zur Ausführung der Abfrage verwendete Rolle
Zur Ausführung der Abfrage verwendetes Warehouse

Einige Abfragedetails sind nur 14 Tage lang verfügbar.

Query Profile anzeigen¶

Um auf ein detailliertes Profil Ihrer Abfrage zuzugreifen, wählen Sie im Bereich Query Details die Option … » View Query Profile aus.

Das Abfrageprofil (Query Profile) wird auf einer neuen Browser-Registerkarte geöffnet.

Abfrageergebnisse herunterladen¶

Um Ihre Abfrageergebnisse als CSV- oder TSV-formatierte Datei herunterzuladen, wählen Sie Download results aus.

Die Größe der Datei richtet sich nach der Menge der von der Abfrage zurückgegebenen Daten. Snowflake hat keine Größenbegrenzung für Dateien mit exportierten Abfrageergebnissen.

Abfrageverlauf anzeigen¶

Nachdem Sie SQL-Anweisungen in einem Arbeitsblatt ausgeführt haben, können Sie den Verlauf der im Arbeitsblatt ausgeführten Abfragen überprüfen, um beispielsweise die Ergebnisse verschiedener Abfrageausführungen zu vergleichen. Sie müssen die gleiche Rolle wie das Arbeitsblatt verwenden, um den Abfrageverlauf für das Arbeitsblatt anzuzeigen.

Wenn der Bereich Results sichtbar ist, wählen Sie (Query history) aus, um die Abfragen, die im Arbeitsblatt ausgeführt wurden, sowie die Ergebnisse dieser Abfragen zu überprüfen. Der Abfrageverlauf enthält bis zu 25 Abfragen, die in diesem Arbeitsblatt während der aktuellen Sitzung und in den letzten 90 Tagen in früheren Sitzungen ausgeführt wurden.

Folgende Informationen werden angezeigt:

Status einer in Ausführung befindlichen Abfrage
Uhrzeit, zu der die Abfrageausführung gestartet wurde
Dauer der Abfrageausführung in Millisekunden oder Sekunden
Ausgeführte Abfrage
Abfrage-ID

Wählen Sie eine Zeile aus, um die Ergebnisse für diese Abfrageausführung im Results-Bereich anzuzeigen. Wenn Sie nicht über die Primärrolle verfügen, die zum Ausführen der Abfrage verwendet wurde, die Sie in Query history anzeigen, können Sie die Ergebnisse dieser Abfrage nicht einsehen. Unterabfragen, die von gespeicherten Prozeduren oder Python-Arbeitsblättern erzeugt wurden, werden nicht angezeigt.

So filtern Sie den Abfrageverlauf für das Arbeitsblatt nach Status, Warehouse oder anderen Aspekten:

Filtern Sie die Abfrageausführungen nach Status. Überprüfen Sie zum Beispiel Abfragen, die sich noch im Status Running oder Queued befinden und noch keine Ergebnisse anzeigen.
Wählen Sie aus, um nach Warehouse, SQL-Text der Abfrage, einer bestimmten Abfrage-ID oder einer Dauer größer als ein bestimmter Zeitraum zu filtern.

Bewegen Sie den Mauszeiger über eine Abfrageausführungszeile, um eine vollständige Vorschau der ausgeführten SQL-Anweisung anzuzeigen, die Abfrage-ID zu kopieren und optional die Abfragedetails für die Abfrageausführung zu öffnen. Weitere Informationen zu den Abfragedetails finden Sie unter Abfrageverlauf mit Snowsight überprüfen.

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.

Verwenden von Filtern in Arbeitsblättern¶

Die folgenden Systemfilter stehen allen Rollen zur Verfügung:

:daterange

Ermöglicht das Anwenden eines Datumsbereichs auf Spalten
:datebucket

Ermöglicht das Gruppieren aggregierter Daten nach einer Zeiteinheit (z. B. nach Tag)

Darüber hinaus können Administratoren kundenspezifische Filter zur Verwendung in Ihrem Konto erstellen. Weitere Informationen dazu finden Sie unter Kundenspezifische Filter.

Betrachten Sie das folgende Beispiel:

SELECT
    COUNT(O_ORDERDATE) as orders, O_ORDERDATE as date
FROM
    SNOWFLAKE_SAMPLE_DATA.TPCH_SF1.ORDERS
WHERE
    O_ORDERDATE = :daterange
GROUP BY
    :datebucket(O_ORDERDATE), O_ORDERDATE
ORDER BY
    O_ORDERDATE

Copy

Weiteres Beispiel:

Fügen Sie den Systemfilter :daterange in Ihre WHERE-Klausel ein.
Fügen Sie den Systemfilter :datebucket in Ihre GROUP BY-Klausel ein.

Wenn Sie die Filter in Ihre Abfrage einbeziehen, werden oben im Arbeitsblatt die entsprechenden Filter-Schaltflächen angezeigt.

In diesem Beispiel wird angenommen, dass Sie der Filter Date bucket auf day und der Filter Date range auf All time gesetzt sind.

Wenn Sie die Abfrage ausführen, werden die Ergebnisse nach Tagen gruppiert. Sie können einen neuen Datumsbereich auswählen, um die Ergebnisse weiter zu filtern.

Die Ergebnistabelle in diesem Beispiel enthält zwei Spalten: Aufträge und Datum. Die Auftragsspalte enthält die aggregierte Anzahl der Aufträge zu einem bestimmten Datum.

Kundenspezifische Filter¶

Mit kundenspezifischen Filtern können Sie die Ergebnisse einer Abfrage oder Visualisierung ändern, ohne die Abfrage direkt bearbeiten zu müssen. Filter sind als spezielle Schlüsselwörter implementiert, die als Unterabfrage oder Liste von Werten aufgelöst werden und dann bei der Ausführung Ihrer Abfrage verwendet werden.

Über die Schaltfläche Show or Hide Filter in der linken oberen Ecke der Seite können Sie Ihre kundenspezifischen Filter anzeigen, ausblenden und verwalten.

Erteilen der Berechtigung zum Erstellen kundenspezifischer Filter¶

Ein Kontoadministrator (d. h. ein Benutzer mit der Rolle ACCOUNTADMIN) muss jeder Rolle, einschließlich der Rolle ACCOUNTADMIN selbst, die Berechtigung zum Erstellen von kundenspezifischen Filtern erteilen.

So erteilen Sie einer Rolle die Berechtigung, kundenspezifische Filter zu erstellen:

Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Klicken Sie auf die Schaltfläche Show or Hide Filter, und wählen Sie die Aktion Manage Filters aus.
Wählen Sie im angezeigten Dialogfeld Edit Permission aus.
Wählen Sie im Dialogfeld Filter Permissions die Rollen aus, denen Sie die Berechtigung zum Erstellen von Filtern erteilen möchten.
Wählen Sie Save aus.

Erstellen von kundenspezifischen Filtern¶

So erstellen Sie einen kundenspezifischen Filter:

Melden Sie sich bei Snowsight an.
Wählen Sie Projects » Worksheets aus, um die Liste der Arbeitsblätter zu öffnen.
Öffnen Sie das Arbeitsblatt.
Klicken Sie auf die Schaltfläche Show or Hide Filter, und wählen Sie die Aktion Manage Filters aus.
Wählen Sie im angezeigten Dialogfeld + Filter aus.
Um einen Filter hinzuzufügen, gehen Sie wie folgt vor:

Display Name
Name des Filters, der anderen Benutzern intern angezeigt wird.

SQL Keyword
Eindeutiges Schlüsselwort zum Einfügen in Abfragen. Verwenden Sie das Format :<Zeichenfolge> ohne Leerzeichen. Beispiel: :myfilter.

Description
Beschreibung des Filters.

Role
Rolle, die beim Aktualisieren von Filterwerten verwendet wird, die aus einer Abfrage abgeleitet wurden.

Warehouse
Warehouse, das beim Aktualisieren von Filterwerten verwendet wird, die aus einer Abfrage abgeleitet wurden.

Options via
Gibt an, ob die Filterwerte aus einer Abfrage oder einer aufgeschlüsselten Liste abgeleitet werden.
Fügen Sie dem Filter Optionen hinzu.
Wählen Sie Save aus.