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

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:

Schnittstelle

Beschreibung

The text area for editing queries.

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.

For assistive technology, the database selector is a button labeled with the currently-selected database and schema. The label changes based on the selected database and schema.

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.

For assistive technology, the worksheet menu is a button labeled with the name of the currently-selected worksheet. By default, the name of the worksheet is the date and time when the worksheet was created.

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

For assistive technology, the worksheet and database explorer contains the worksheet and database tabs.

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

For assistive technology, text inputs for search are included on both tabs. On the databases tab, the search input has the button role.

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.

Because the sql preview feature requires you to hover over other worksheets in the explorer, the feature might not be usable by some assistive technology.

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.

For assistive technology, the history button is usually labeled with a date range description, such as updated 3 days ago.

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.

For assistive technology, the filter button is labeled show and hide filters.

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.

For assistive technology, the context selector button is usually labeled with the currently-selected role and warehouse.

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.

Use the share button to share worksheets with other users.

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.

For assistive technology, use the button labeled run-button to run your query.

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.

Due to way the results table is rendered, the feature might not be usable by some assistive technology. To explore the results locally, download the results as a .csv file.

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.

The query details contain various metrics.

Abfragedetails

Die Query Details rechts neben der Ergebnistabelle liefern Statistiken zur Ausführung der Abfrage.

Weitere Informationen dazu finden Sie unter Abfragedetails anzeigen.

Use the buttons labeled objects, query, results, and chart to show and hide worksheet sections.

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.

Use the search input to explore results. Use the download as csv button to download the results as a .csv file. Use the toggle query statistics button to hide or show query details.

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ü (For assistive technology, the options button.). Ü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 (For assistive technology, the pin button.).

Jedes Objekt im Arbeitsblatt- und Datenbank-Explorer hat ein entsprechendes Optionsmenü (For assistive technology, the options button.). Ü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 (For assistive technology, the copy button.) 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 (For assistive technology, the show warehouse details button.) 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 (For assistive technology, use the button labeled run-button to run your query.) aus.

Um das gesamte Arbeitsblatt auszuführen, markieren Sie alle Abfragen im query editor, und wählen Sie dann run button (For assistive technology, use the button labeled run-button to run your query.) 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 (For assistive technology, the options button.) 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 (For assistive technology, the download as csv button.) 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.

For assistive technology, when the filter buttons appear, they follow the show and hide filters button in the tab order.

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:

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

    Das Dialogfenster Filters wird geöffnet.

  2. Wählen Sie in der rechten oberen Ecke die Option Edit Permission aus.

    Das Dialogfenster Filter Permissions wird geöffnet.

  3. Wählen Sie die Rollen aus, denen Sie die Berechtigung zum Erstellen von Filtern erteilen möchten.

  4. Wählen Sie Save aus.

Erstellen von kundenspezifischen Filtern

So erstellen Sie einen kundenspezifischen Filter:

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

    Das Dialogfenster Filters wird geöffnet.

  2. Wählen Sie in der rechten oberen Ecke die Option Filter aus.

    Das Dialogfenster Add Filter wird geöffnet.

  3. 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.

  4. Fügen Sie dem Filter Optionen hinzu.

  5. Wählen Sie Save aus.