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

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:

  1. Öffnen Sie Visual Studio Code.

  2. 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 vsc-extensions-button klicken.

  3. Geben Sie im Textfeld Search Extensions den Text „Snowflake“ ein, um nach der Snowflake Visual Studio-Erweiterung zu suchen.

  4. 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:

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

  2. Öffnen Sie Visual Studio Code.

  3. Wählen Sie Code » Preferences » Extensions aus.

    Sie können auch View » Extensions auswählen oder in der Aktivitätsleiste auf die Erweiterungsschaltfläche vsc-extensions-button klicken.

  4. Wählen Sie im Menü „Mehr“ (…) die Option Install from VSIX aus.

    In the Extensions page, select more and then Install from VSIX file.
  5. 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:

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

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

    The Snowflake select account dialog.
  3. 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.

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:

  1. 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 (vsc-new-sql-file-button) im Datenbank-Explorer-Bereich, um eine neue SQL-Datei zu erstellen.

    The Snowflake SQL extension database explorer panel with new SQL file button highlighted.
  2. Geben Sie eine oder mehrere Snowflake SQL-Anweisungen in die Datei ein.

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

  1. Wählen Sie vsc-execute-all-button für die ausgewählte SQL-Datei aus, um alle Anweisungen in dieser Datei auszuführen.

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

  3. 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 Apple OSX Command key. + Eingabetaste auf einer Mac-Tastatur bzw. Generic control key. + 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 (vsc-cancel-query-button).

Abfrageverlauf verwenden

Die Abfrageergebnisse werden in QUERY HISTORY verfolgt.

Um Abfrageergebnisse anzuzeigen, gehen Sie wie folgt vor:

  1. Erweitern Sie Query History.

  2. Wählen Sie eine Anweisung aus.

  3. 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 (vsc-query-rerun-button), den Abfragetext in die Zwischenablage kopieren (vsc-query-copy-button) oder eine Abfrage löschen (vsc-query-delete-button).

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

The Snowflake sign in dialog.

Tipp

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

Sign in to, or switch between accounts.

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:

  1. Wählen Sie Code » Preferences » Extensions aus.

  2. 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 vsc-extensions-button klicken.

Deinstallieren der Erweiterung

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

  1. Wählen Sie Code » Preferences » Extensions aus.

  2. Wählen Sie die Erweiterung aus.

  3. Klicken Sie mit der rechten Maustaste, und wählen Sie Disable oder Uninstall auf.