Snowflake Extension for Visual Studio Code¶

Snowflake bietet eine Erweiterung für Visual Studio Code (VS Code), mit der Snowflake-Benutzer Snowflake SQL-Anweisungen direkt in VS Code schreiben und ausführen können. Erweiterungen sind vorgefertigte Funktionen, die meist von Drittanbietern bereitgestellt werden und neue Features und Funktionen zu VS Code hinzufügen.

Unter diesem Thema:

Installieren der Snowflake-Erweiterung für Visual Studio Code
- Installieren über Visual Studio Marketplace
- Installieren über eine VSIX-Datei
Anmelden
Navigieren auf der Benutzeroberfläche der Snowflake-Erweiterung für Visual Studio Code
Verwenden von SQL-Dateien
Ändern des Sitzungskontexts
Navigieren mit dem Datenbank-Explorer
Details zur Erweiterung anzeigen
Deinstallieren der Erweiterung

Installieren der Snowflake-Erweiterung für Visual Studio Code¶

Snowflake-Benutzer können die VS Code-Erweiterung direkt über Visual Studio Marketplace installieren oder die Erweiterung als .xsix-Datei herunterladen und dann installieren.

Installieren über Visual Studio Marketplace¶

Um die Installation direkt über Visual Studio Marketplace vorzunehmen, gehen Sie wie folgt vor:

Öffnen Sie Visual Studio Code.
Wählen Sie Code » Preferences » Extensions aus.

Sie können auch View » Extensions auswählen oder in der VS Code-Aktivitätsleiste auf die Erweiterungsschaltfläche klicken.
Geben Sie im Textfeld Search Extensions den Text „Snowflake“ ein, um nach der Snowflake Visual Studio-Erweiterung zu suchen.
Wählen Sie in der Liste der Erweiterungen die von Snowflake bereitgestellte Erweiterung aus, und klicken Sie auf Install.

Installieren über eine VSIX-Datei¶

Um eine VSIX-Datei herunterzuladen und zu installieren, gehen Sie wie folgt vor:

Laden Sie die Erweiterung herunter.
1. Öffnen Sie die Seite Snowflake Visual Studio Code-Erweiterung.
2. Wählen Sie die Registerkarte Version History aus.
3. Wählen Sie die herunterzuladende Version aus, und klicken Sie auf Download. Achten Sie darauf, in welches Verzeichnis die Datei heruntergeladen wird.
Öffnen Sie Visual Studio Code.
Wählen Sie Code » Preferences » Extensions aus.

Sie können auch View » Extensions auswählen oder in der Aktivitätsleiste auf die Erweiterungsschaltfläche klicken.
Wählen Sie im Menü „Mehr“ (…) die Option Install from VSIX aus.
Suchen Sie die Datei snowflake-x.y.z.vsix auf Ihrem Computer, wählen Sie die Datei aus, und wählen Sie dann Install aus.

Nach erfolgreicher Installation wird die Snowflake-Erweiterung für Visual Studio Code im Abschnitt INSTALLED des Menüs Extensions in VS Code angezeigt.

The Snowflake SQL extension, after being installed in Visual Studio Code.

Anmelden¶

Bevor Sie SQL-Anweisungen ausführen können, müssen Sie sich bei einem Snowflake-Konto anmelden.

Sie können sich bei Snowflake mit Ihrem Snowflake-Kontobezeichner, Ihrem Benutzernamen und Ihrem Kennwort anmelden oder eine Verbundauthentifizierung bei Snowflake mit SAML SSO verwenden.

Wenn Sie sich das erste Mal über die VS Code-Erweiterung bei Snowflake anmelden, müssen Sie Ihr Konto hinzufügen, indem Sie entweder den Kontobezeichner für Ihr Snowflake-Konto oder die URL eingeben, die Sie für die Verbindung zu Snowflake verwenden.

Weitere Informationen zum Ermitteln des Kontobezeichners finden Sie unter Kontobezeichner.

Um sich bei Snowflake über die VS Code-Erweiterung anzumelden, gehen Sie wie folgt vor:

Klicken Sie in der Activity Bar auf das Snowflake-Symbol.

Der Seitenleistenbereich wechselt zur Snowflake-Navigation und zeigt das Dialogfeld Add Account oder Sign in an.
Geben Sie unter Add Account den Kontobezeichner ein, und wählen Sie Continue aus.

Add Account wird nur angezeigt, wenn zuvor kein Konto angegeben wurde.
Geben Sie einen Benutzernamen und ein Kennwort für das ausgewählte Konto ein, und wählen Sie Sign in aus.

Nach erfolgreicher Anmeldung werden in der Seitenleiste der Sitzungskontext (ACCOUNT), DATABASE EXPLORER für den Benutzer in seiner Standardrolle und QUERY HISTORY (Abfrageverlauf) angezeigt.

Navigieren auf der Benutzeroberfläche der Snowflake-Erweiterung für Visual Studio Code¶

Die Snowflake-Erweiterung für Visual Studio Code hat die folgenden Hauptbereiche:

Seitenleistenbereich (1): Der Bereich ganz links ist der Bereich für Konto, Datenbank-Explorer und Abfrageverlauf.

In diesem Bereich können Sie Kontodetails angeben, Datenbankobjekte untersuchen und Abfrageergebnisse prüfen.
Der Snowflake SQL-Bereich (2): Im Snowflake SQL-Bereich werden die Snowflake SQL-Dateien angezeigt.
Abfrageergebnis-Bereich (3): Im Abfrageergebnis-Bereich werden die Ergebnisse von Abfragen angezeigt.

Wählen Sie unter Side Bar » Query History eine Abfrage aus, um dessen Ausführungsergebnis-Bereich (4) anzuzeigen.
Abschnitt „Abfrageverlauf“ von Side Bar (4): Der Abfrageverlauf zeigt die letzten Abfragen.
Aktuelle Sitzung (5): Aktuelle Sitzungsinformationen, einschließlich aktueller Rolle, Datenbank, Schema und aktivem Warehouse.
Snowflake-Symbol (nicht nummeriert): Wählen Sie das Snowflake-Symbol aus, um den Side Bar-Bereich ein- oder auszublenden.

The Snowflake SQL extension in use showing its main areas: the sidebar panel, the sql panel and the query results panel.

Verwenden von SQL-Dateien¶

Sie können die Snowflake-Erweiterung für Visual Studio Code verwenden, um SQL-Dateien zu laden. SQL-Dateien sind einfache Textdateien, die eine oder mehrere SQL-Anweisungen enthalten.

Öffnen von SQL-Dateien¶

Um Snowflake SQL-Dateien zu erstellen oder zu öffnen, gehen Sie wie folgt vor:

Wählen Sie File » Open aus, navigieren Sie zu einer Textdatei, die SQL enthält, und öffnen Sie diese.

Wenn Sie keine vorhandene SQL-Datei haben, können Sie eine neue erstellen. Wählen Sie File » New File aus, und erstellen Sie eine Datei des Typs Snowflake SQL File.

Klicken Sie alternativ auf die Schaltfläche () im Datenbank-Explorer-Bereich, um eine neue SQL-Datei zu erstellen.
Geben Sie eine oder mehrere Snowflake SQL-Anweisungen in die Datei ein.
Wählen Sie eine Zeile aus, und drücken Sie über der Zeile auf die Schaltfläche „Enter“, um den Befehl auszuführen.

Ausführen von Befehlen oder Abfragen¶

Um einen oder mehrere Befehle oder Abfragen auszuführen, gehen Sie wie folgt vor:

Wählen Sie für die ausgewählte SQL-Datei aus, um alle Anweisungen in dieser Datei auszuführen.
Wählen Sie die auszuführende Zeile aus, indem Sie den Cursor auf die auszuführende Anweisung setzen.

Wenn Sie zwei oder mehr Befehle auswählen, werden alle ausgewählten Befehle ausgeführt.
Drücken Sie über dem ersten ausgewählten Befehl auf die Schaltfläche „Enter“.

Wenn Sie mehrere Befehle auswählen, werden die Befehle in der Reihenfolge von oben nach unten ausgeführt.

Sie können Anweisungen auch über Tastenkombinationen ausführen. Nach Auswahl der SQL-Anweisungen, die Sie ausführen möchten, drücken Sie + Eingabetaste auf einer Mac-Tastatur bzw. + Eingabetaste auf einer Windows-Tastatur.

Die Ergebnisse der SQL-Anweisung werden in der Tabelle SNOWFLAKE:QUERY RESULTS des Output-Bereichs angezeigt.

Tipp

Laufende Abfragen können abgebrochen werden. Um eine laufende Abfrage abzubrechen, suchen Sie die Abfrage in QUERY HISTORY und drücken Sie auf die Schalfläche zum Abbrechen der Abfrage ().

Abfrageverlauf verwenden¶

Die Abfrageergebnisse werden in QUERY HISTORY verfolgt.

Um Abfrageergebnisse anzuzeigen, gehen Sie wie folgt vor:

Erweitern Sie Query History.
Wählen Sie eine Anweisung aus.
Untersuchen Sie das Ergebnis auf der Registerkarte SNOWFLAKE:QUERY RESULTS des Bereichs Output.

Example of executing a statement with result highlighted.

Tipp

Über Query History können Sie eine Abfrage erneut ausführen (), den Abfragetext in die Zwischenablage kopieren () oder eine Abfrage löschen ().

Ändern des Sitzungskontexts¶

Im Abschnitt Account des Side Bar-Bereichs können Sie Rollen, Datenbanken, Schemas und Warehouses auswählen. Verwenden Sie das jeweilige Dropdown-Menü, um die gewünschte Option auszuwählen.

Tipp

Verwenden Sie das Dropdown-Menü für Konten, um sich anzumelden oder zwischen verschiedenen Konten zu wechseln.

Navigieren mit dem Datenbank-Explorer¶

Im Abschnitt DATABASE EXPLORER des Side Bar-Bereichs können Sie die Eigenschaften von Datenbankobjekten untersuchen und anzeigen.

Um ein Datenbankobjekt zu untersuchen, gehen Sie wie folgt vor:

Melden Sie sich bei einem Konto an.
Erweitern Sie im Sidebar-Bereich den Abschnitt DATABASE EXPLORER.
Wählen Sie eine Datenbank aus, und erweitern Sie diese.
Wählen Sie ein Schema aus, und erweitern Sie dieses.
Wählen Sie eine beliebige untergeordnete Komponente aus.
Wählen Sie ein beliebiges Element aus, um dessen Eigenschaften auf der Registerkarte SNOWFLAKE:OBJECT DETAILS des Output-Bereichs anzuzeigen.

Tipp

Verwenden Sie die Schaltfläche zum Anzeigen der Objektdetails (), um die Details des zugeordneten Objekts anzuzeigen.

Details zur Erweiterung anzeigen¶

Sie können jederzeit Informationen zur Snowflake SQL-Erweiterung für Visual Studio Code anzeigen.

Folgende Informationen zu der Erweiterung werden angezeigt:

Versionsinformationen: Die derzeit installierte Version der Erweiterung.
Änderungsprotokoll (Changelog): Informationen zu den hinzugefügten, geänderten oder aktualisierten Features je nach Version.
Erläuterungen zu den Features.

Darüber hinaus können Sie die Erweiterung über das Dropdown-Menü aktivieren/deaktivieren.

Gehen Sie wie folgt vor, um Informationen zur Erweiterung anzuzeigen:

Wählen Sie Code » Preferences » Extensions aus.
Wählen Sie die Snowflake SQL-Erweiterung für VS Code aus.

Sie können auch View » Extensions auswählen oder auf der Activities-Leiste auf die Erweiterungsschaltfläche klicken.

Deinstallieren der Erweiterung¶

Um die Erweiterung zu deaktivieren oder zu deinstallieren, gehen Sie wie folgt vor:

Wählen Sie Code » Preferences » Extensions aus.
Wählen Sie die Erweiterung aus.
Klicken Sie mit der rechten Maustaste, und wählen Sie Disable oder Uninstall auf.