Abfragen von Daten über Arbeitsblätter¶

Unter diesem Thema wird beschrieben, wie Sie Abfragen mithilfe von Arbeitsblättern in Snowsight, the Snowflake web interface erstellen und ausführen.

Unter diesem Thema:

Verwenden von Arbeitsblättern
Erstellen und Ausführen von Abfragen
Durchsuchen der Ergebnistabelle
Verwenden von Filtern
Kundenspezifische Filter
- Erteilen der Berechtigung zum Erstellen kundenspezifischer Filter
- Erstellen von kundenspezifischen Filtern

Verwenden von Arbeitsblättern¶

Snowflake bietet in Snowsight mehrere Methoden zum Navigieren in und Interagieren mit Arbeitsblättern.

Dieser Abschnitt gibt einen kurzen Überblick über die Navigation und Verwendung von Arbeitsblättern. Dieser Abschnitt enthält Beispiele und Beschreibungen zu den folgenden Elementen der Weboberfläche:

Abfrage-Editor
Datenbankauswahl
Arbeitsblatt-Menü
Arbeitsblatt- und Datenbank-Explorer
Suche in Arbeitsblättern und Datenbanken
Arbeitsblatt-SQL in Vorschau anzeigen
Versionsverlauf
Filter ein- und ausblenden
Kontextauswahl
Arbeitsblatt freigeben
Abfrage ausführen
Ergebnistabelle
Abfragedetails
Abschnitte ein- und ausblenden
Ergebnisse suchen und herunterladen

Schnittstelle	Beschreibung
Abfrage-Editor	Im Abfrage-Editor, der sich in der Mitte des Arbeitsblatts befindet, können Sie SQL-Abfragen erstellen und ändern. Weitere Informationen dazu finden Sie unter Erstellen und Ausführen von Abfragen.
Datenbankauswahl	Mit der Datenbankauswahl, die sich oben im Abfrage-Editor befindet, können Sie eine Datenbank und ein Schema für Ihre Abfrage suchen und auswählen. Wenn Sie eine Datenbank und ein Schema auswählen, können Sie auf Objekte im Schema verweisen, ohne die Objektnamen in Ihrer Abfrage vollständig zu qualifizieren.
Arbeitsblatt-Menü	Das Arbeitsblatt-Menü in der linken oberen Ecke des Arbeitsblatts bietet folgende Optionen: Name des Arbeitsblatts Arbeitsblatt umbenennen Import SQL from File SQL aus einer Datei auf Ihrem Gerät importieren Move to Arbeitsblatt in einen Ordner oder ein Dashboard verschieben Duplicate Arbeitsblatt duplizieren Format query Abfragetext für bessere Lesbarkeit formatieren Delete worksheet Arbeitsblatt löschen Show shortcuts Tastaturkürzel für Arbeitsblatt anzeigen
Arbeitsblatt- und Datenbank-Explorer	Der Arbeitsblatt- und Datenbank-Explorer auf der linken Seite des Arbeitsblatts bietet folgende Optionen: Ordner durchsuchen und Arbeitsblätter öffnen Datenbanken durchsuchen und Objektnamen und Spalten direkt zur SQL-Abfrage hinzufügen
Suche in Arbeitsblättern und Datenbanken	Der Arbeitsblatt- und Datenbank-Explorer enthält ein Suchfeld, das folgende Optionen bietet: Arbeitsblätter nach Namen und Inhalten durchsuchen Datenbanken und Objekte nach Namen durchsuchen Weitere Informationen dazu finden Sie unter Suche in Arbeitsblättern und Datenbanken.
Arbeitsblatt-SQL in Vorschau anzeigen	Wenn ein Arbeitsblatt geöffnet ist, können Sie den Mauszeiger über andere Arbeitsblätter im Explorer bewegen, um eine Vorschau anzuzeigen und die SQL anderer Arbeitsblättern zu kopieren, ohne das geöffnete Arbeitsblatt verlassen zu müssen. Weitere Informationen dazu finden Sie unter Anzeigen von Arbeitsblättern in der Vorschau.
Versionsverlauf	Wenn Sie Änderungen an einem Arbeitsblatt vornehmen und die Abfrage ausführen, bewahrt Snowsight die vorherige Version des Arbeitsblatts auf. Sie können zu historischen Versionen des Arbeitsblatts wechseln, um die Prüfpunkte anzuzeigen und zu ändern. Weitere Informationen dazu finden Sie unter Umschalten zwischen Versionen des Arbeitsblatts.
Filter ein- und ausblenden	Über die Schaltfläche Filter in der linken oberen Ecke der Seite können Sie Ihre kundenspezifischen Filter anzeigen, ausblenden und verwalten. Weitere Informationen dazu finden Sie unter Kundenspezifische Filter.
Kontextauswahl	Mit der Kontextauswahl, die sich in der rechten oberen Ecke der Seite befindet, können Sie Rollen und Warehouses für Ihre Arbeitsblatt-Sitzungen festlegen. Arbeitsblätter bewahren den von Ihnen ausgewählten Kontext für zukünftige Sitzungen auf. Weitere Informationen dazu finden Sie unter Sitzungskontext ändern.
Arbeitsblatt freigeben	Verwenden Sie in der rechten oberen Ecke der Seite die Option Share, um Abfrageergebnisse für andere Snowflake-Benutzer freizugeben. Um das freigegebene Arbeitsblatt auszuführen, muss einem Benutzer die für den Arbeitsblatt-Sitzungskontext verwendete Rolle zugewiesen werden.
Abfrage ausführen	Über die Schaltfläche Ausführen in der rechten oberen Ecke der Seite können Sie Ihre Abfragen ausführen. Wenn sich Ihr Skript geändert hat, wird im Versionsverlauf des Arbeitsblatts ein Prüfpunkt gespeichert. Weitere Informationen dazu finden Sie unter Ausführen von Abfragen.
Ergebnistabelle	Nachdem Sie eine Abfrage ausgeführt haben, wird unten auf dem Arbeitsblatt die Ergebnistabelle angezeigt. Weitere Informationen dazu finden Sie unter Durchsuchen der Ergebnistabelle.
Abfragedetails	Die Query Details rechts neben der Ergebnistabelle liefern Statistiken zur Ausführung der Abfrage. Weitere Informationen dazu finden Sie unter Abfragedetails anzeigen.
Abschnitte ein- und ausblenden	Verwenden Sie die unten im Abfrage-Editor angezeigten Elemente Objects, Query, Results und Chart, um die entsprechenden Abschnitte des Arbeitsblatts ein- und auszublenden. Weitere Informationen zu Diagrammen finden Sie unter Visualisieren von Arbeitsblattdaten.
Ergebnisse suchen und herunterladen	Auf der rechten Seite des Arbeitsblatts können Sie eine Suche ausführen, Ihre Ergebnisse herunterladen und Query Details ein- oder ausblenden.

Arbeitsblätter mit Tastaturkürzeln aktualisieren¶

Snowsight bietet Tastenkombinationen, mit denen Sie in Arbeitsblättern schnell in Abfragen navigieren und die Abfragen bearbeiten können. So können Sie beispielsweise mithilfe der Tastaturkürzel den Cursor innerhalb des Arbeitsblatts bewegen, „Suchen und Ersetzen“ ausführen, Zeilen kopieren, Abfragen formatieren und vieles mehr.

Um alle verfügbaren Tastaturkürzel anzuzeigen, öffnen Sie ein Arbeitsblatt und drücken Sie [CMD] + [SHIFT] + [?] auf einer Mac-Tastatur bzw. [STRG] + [SHIFT] + [?] auf einer Windows-Tastatur.

Untersuchen von Arbeitsblättern und Datenbankobjekten¶

In diesem Abschnitt wird die Verwendung des worksheet and database explorer für die Arbeit mit Arbeitsblättern und Datenbanken beschrieben.

Arbeitsblätter durchsuchen¶

Um ein Arbeitsblatt zu öffnen, wählen Sie im worksheet and database explorer das Arbeitsblatt aus, das Sie öffnen möchten.

Jedes Arbeitsblatt im Arbeitsblatt- und Datenbank-Explorer hat ein entsprechendes Optionsmenü (). Über das Optionen-Menü können Sie Folgendes tun:

Arbeitsblatt umbenennen
Arbeitsblatt duplizieren
Arbeitsblatt löschen
Arbeitsblatt in Ordner oder Dashboard verschieben

Durchsuchen von Datenbanken¶

Um Datenbankobjekte anzuzeigen, wählen Sie im worksheet and database explorer die entsprechende Datenbank aus.

Folgende Aufgaben können ausgeführt werden:

Datenbanken durchsuchen, um Datenbankobjekte zu untersuchen
Durch Bewegen des Mauszeigers über Tabellen und Ansichten können Sie eine Vorschau anzeigen und Objekte anheften ().

Jedes Objekt im Arbeitsblatt- und Datenbank-Explorer hat ein entsprechendes Optionsmenü (). Über das Optionen-Menü können Sie Folgendes tun:

Arbeitsblattkontext festlegen (nur Datenbanken und Schemas)
Name des Objekts in SQL platzieren
Spalten aus Objekt zu SQL hinzufügen (nur Tabellen und Ansichten)
Objektdefinition anzeigen (nur Tabellen und Ansichten)

Suche in Arbeitsblättern und Datenbanken¶

Um Ihre Arbeitsblätter und Datenbanken zu durchsuchen, geben Sie in das Suchfeld des worksheet and database explorer den Suchbegriff ein.

Anzeigen von Arbeitsblättern in der Vorschau¶

Um ein Arbeitsblatt in der Vorschau anzuzeigen, bewegen Sie den Mauszeiger im worksheet and database explorer über das Arbeitsblatt.

Um den SQL-Code des Arbeitsblatts zu kopieren, müssen Sie den Mauszeiger über die Vorschau bewegen und dann auf Copy () klicken.

Umschalten zwischen Versionen des Arbeitsblatts¶

Um zu einer anderen Version eines Arbeitsblatts zu wechseln, wählen Sie oben im Arbeitsblatt den Zeitstempel und dann die gewünschte Version des Arbeitsblatts aus.

Erstellen und Ausführen von Abfragen¶

Snowsight macht das Schreiben von Abfragen so einfach wie möglich und gibt Ihnen Hilfe, wo diese benötigt wird, ohne im Weiteren aber störend zu wirken.

Sitzungskontext ändern¶

Um die Rolle und das Warehouse für die Arbeitsblatt-Sitzung auszuwählen oder zu ändern, verwenden Sie die context selector. Die aktuelle Rolle bestimmt anhand der Zugriffssteuerungsrechte, die der Rolle erteilt wurden, welche Operationen auf Snowflake-Objekten ausgeführt werden dürfen. Wählen Sie zuerst eine Rolle aus, und wählen Sie dann ein Warehouse aus, für das die Rolle Berechtigungen hat.

Beachten Sie, dass Sie nicht mehrere Rollen auswählen können. Das heißt, das Kontext-Dropdownmenü unterstützt keine Sekundärrollen.

Klicken Sie in der linken oberen Ecke des Abfrage-Editors auf das Dropdown-Menü für die Datenbank, um die aktuelle Datenbank für ein Arbeitsblatt auszuwählen (oder zu ändern).

Bemerkung

Jedes Arbeitsblatt hat eine eigene Sitzung und kann andere Rollen verwenden als die, die Sie im user menu festgelegt haben (Ihre aktive Rolle). Wenn Sie Ihre aktive Rolle ändern, ändert dies nicht die Rolle, die dem Arbeitsblatt mit der context selector zugewiesen wurde.

Abfragen erstellen¶

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¶

Um ein SQL-Skript an ein bestehendes Arbeitsblatt anzuhängen, wählen Sie im worksheet menu die Option Import SQL from File aus.

Anhalten und Fortsetzen von Warehouses¶

Verwenden Sie in der rechten oberen Ecke Ihres Arbeitsblatts das Symbol context selector, um Ihre Warehouse anzuzeigen.

Um die Größe und den Status Ihres aktiven Warehouses zu ändern, wählen Sie in context selector die Option Show Warehouse Details () aus.

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 query editor den Cursor in der Abfrage, und wählen Sie dann das Feld run button () aus.

Um das gesamte Arbeitsblatt auszuführen, markieren Sie alle Abfragen im query editor, und wählen Sie dann run button () aus.

Durchsuchen der Ergebnistabelle¶

Die Ergebnistabelle unterstützt interaktive Features, einschließlich generierter Statistiken, die zu jeder Auswahl Kontextinformationen anzeigen.

Verwenden Sie die Pfeiltasten auf Ihrer Tastatur, um wie in einer Tabelle durch die Auswahl zu navigieren.

Wählen Sie Spalten, Zellen, Zeilen oder Bereiche in der Ergebnistabelle aus. Jede Auswahl kann kopiert und eingefügt werden.

In den Ergebnissen können bis zu 10.000 Zeilen angezeigt werden. Auch wenn Ihre Abfrage mehr als 10.000 Zeilen zurückgibt, spiegeln die Statistiken immer noch das gesamte Resultset wider.

Bemerkung

Wenn Sie die Ergebnisse als CSV-Datei herunterladen, sind die vollständigen Ergebnisse enthalten, auch wenn die Ergebnisse mehr als 10.000 Zeilen umfassen.

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¶

Die Query Details enthalten Informationen zur Ausführung der Abfrage, einschließlich:

Dauer der Abfrageausführung
Die Anzahl der Zeilen.
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.

Anzeigen von Query Profile¶

Um auf ein detailliertes Profil Ihrer Abfrage zuzugreifen, wählen Sie im options menu () von Query Details die Option View Query Profile aus.

Ergebnisse herunterladen¶

Um Ihre Ergebnisse als CSV-Datei herunterzuladen, wählen Sie in der rechten oberen Ecke der Ergebnistabelle die Option Download as CSV () aus.

Snowflake erzwingt keine Größenbeschränkung für CSV-Dateien, die für Ergebnisse generiert werden. Die Größe Ihrer CSV-Datei richtet sich nach der Menge der von Ihrer Abfrage zurückgegebenen Daten.

Gespeicherte Ergebnisse von früheren Arbeitsblattversionen¶

Ergebnisse der in Arbeitsblättern ausgeführten Abfragen werden bis zu 1 Jahr lang zwischengespeichert. Dieser Cache ist in der Datenspeichernutzung für Ihr Konto enthalten.

Verwenden von Filtern¶

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

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.

The results table in this example includes two columns, orders and date. The orders column contains the aggregated number of orders on a given date.

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.

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:

Wählen Sie filter button und dann Manage Filters aus.

Das Dialogfenster Filters wird geöffnet.
Wählen Sie in der rechten oberen Ecke die Option Edit Permission aus.

Das Dialogfenster Filter Permissions wird geöffnet.
Wählen Sie 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:

Wählen Sie filter button und dann Manage Filters aus.

Das Dialogfenster Filters wird geöffnet.
Wählen Sie in der rechten oberen Ecke die Option Filter aus.

Das Dialogfenster Add Filter wird geöffnet.
Geben Sie Folgendes an:

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.