Verbinden über SnowSQL¶

Festlegen von Kennwörtern beim Verbinden¶

Kennwörter können nicht über Verbindungsparameter übergeben werden. Kennwörter müssen auf eine der folgenden Arten angegeben werden:

• Eingabe erfolgt über die interaktive Eingabeaufforderung in SnowSQL (gilt nur für Kennwörter).

• Definiert in der SnowSQL-Konfigurationsdatei mit der Option password. Weitere Details dazu finden Sie unter Konfigurieren der Standardverbindungseinstellungen (unter diesem Thema).

• Angabe unter Verwendung der Umgebungsvariablen SNOWSQL_PWD. Weitere Details dazu finden Sie unter Verwenden von Umgebungsvariablen (unter diesem Thema).

Verwenden von Umgebungsvariablen¶

Derzeit können Umgebungsvariablen nur verwendet werden, um vorab einige Parameterwerte der Befehlszeile wie Kennwort, Host und Datenbank anzugeben. Umgebungsvariablen stehen nicht für die SnowSQL-Variablenersetzung zur Verfügung, es sei denn, sie werden beim Start von SnowSQL explizit auf der Befehlszeile angegeben, entweder mit dem Verbindungsparameter -D oder --variable. Beispiel:

Linux/macOS

$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=$DB_KEY

Copy

Windows

$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=%DB_KEY%

Copy

Im obigen Beispiel wird mit --variable die Snowflake-Variable mit dem Namen db_key auf die Umgebungsvariable DB_KEY eingestellt.

Definieren benannter Verbindungen in der Konfigurationsdatei¶

1. Öffnen Sie die Konfigurationsdatei config in einem Texteditor. Standardmäßig befindet sich die Datei in folgendem Verzeichnis:

   Linux/macOS

   ~/.snowsql/

   Windows

   %USERPROFILE%\.snowsql\

2. Fügen Sie einen separaten [connections]-Abschnitt mit einem eindeutigen Namen für jede benannte Verbindung hinzu.

   Im Folgenden wird beispielsweise eine Verbindung mit dem Namen my_example_connection für ein Snowflake-Konto mit dem Kontobezeichner myorganization-myaccount hinzugefügt:

   [connections.my_example_connection]
   accountname = myorganization-myaccount
   username = jsmith
   password = xxxxxxxxxxxxxxxxxxxx
   dbname = mydb
   schemaname = public
   warehousename = mywh
   

   Copy

Verbinden mit Snowflake mit einer benannten Verbindung¶

Verwenden Sie den Verbindungsparameter -c <Zeichenfolge> (oder --connection <Zeichenfolge>), um eine benannte Verbindung anzugeben, wobei <Zeichenfolge> der Name einer Verbindung ist, die in der Konfigurationsdatei definiert wurde.

Verwenden Sie beispielsweise die my_example_connection-Verbindung, die Sie unter Definieren benannter Verbindungen in der Konfigurationsdatei (unter diesem Thema) erstellt haben:

$ snowsql -c my_example_connection

Copy

-a, --accountname¶

Beschreibung

Erforderlich

Gibt Ihren Kontobezeichner an.

Dieser Verbindungsparameter kann auch in der Konfigurationsdatei eingestellt werden.

Wert

Zeichenfolge

Außerdem kann der Wert eine Umgebungsvariable sein:

Linux/macOS

$SNOWSQL_ACCOUNT

Windows

%SNOWSQL_ACCOUNT%

Beispiel unter Linux oder macOS:

$ export SNOWSQL_ACCOUNT=myorganization-myaccount

$ snowsql -a $SNOWSQL_ACCOUNT

Copy

Standard

Keine

-u, --username¶

Beschreibung

Gibt den Anmeldenamen des Benutzers an, mit dem Sie sich mit dem angegebenen Konto verbinden.

Dieser Verbindungsparameter kann auch in der Konfigurationsdatei eingestellt werden.

Wert

Zeichenfolge

Der Wert kann eine Umgebungsvariable sein:

Linux/macOS

$SNOWSQL_USER

Windows

%SNOWSQL_USER%

Beispiel unter Linux oder macOS:

$ export SNOWSQL_USER=jdoe

$ snowsql -u $SNOWSQL_USER

Copy

Standard

Keine

-d, --dbname¶

Beschreibung

Gibt die Datenbank an, die standardmäßig in der Clientsitzung verwendet werden soll (kann nach der Anmeldung geändert werden).

Wert

Zeichenfolge

Der Wert kann eine Umgebungsvariable sein:

Linux/macOS

$SNOWSQL_DATABASE

Windows

%SNOWSQL_DATABASE%

Dieser Verbindungsparameter kann auch in der Konfigurationsdatei eingestellt werden.

Standard

Keine

-s, --schemaname¶

Beschreibung

Gibt das Datenbankschema an, das standardmäßig in der Clientsitzung verwendet werden soll (kann nach der Anmeldung geändert werden).

Wert

Zeichenfolge

Der Wert kann eine Umgebungsvariable sein:

Linux/macOS

$SNOWSQL_SCHEMA

Windows

%SNOWSQL_SCHEMA%

Dieser Verbindungsparameter kann auch in der Konfigurationsdatei eingestellt werden.

Standard

Keine

-r, --rolename¶

Beschreibung

Gibt die Rolle an, die standardmäßig in der Clientsitzung für den Zugriff auf Snowflake-Objekte verwendet werden soll (kann nach der Anmeldung geändert werden).

Dieser Verbindungsparameter kann auch in der Konfigurationsdatei eingestellt werden.

Wert

Zeichenfolge

Der Wert kann eine Umgebungsvariable sein:

Linux/macOS

$SNOWSQL_ROLE

Windows

%SNOWSQL_ROLE%

Standard

Keine

-w, --warehouse¶

Beschreibung

Gibt das virtuelle Warehouse an, das in der Clientsitzung standardmäßig für Abfragen, Laden usw. verwendet werden soll (kann nach der Anmeldung geändert werden).

Dieser Verbindungsparameter kann auch in der Konfigurationsdatei eingestellt werden.

Wert

Zeichenfolge

Der Wert kann eine Umgebungsvariable sein:

Linux/macOS

$SNOWSQL_WAREHOUSE

Windows

%SNOWSQL_WAREHOUSE%

Standard

Keine

-h, --host – Veraltet¶

Beschreibung

Für Abwärtskompatibilität/interne Verwendung bereitgestellt

Gibt die Adresse des Hosts an, mit dem Sie sich in Snowflake verbinden.

Dieser Parameter wird nicht mehr verwendet, da die Hostadresse automatisch bestimmt wird, indem der von Ihnen angegebene Kontobezeichner (entweder mit -a oder --account) mit der Snowflake-Domäne snowflakecomputing.com verkettet wird.

Wert

Zeichenfolge

Standard

Keine

-p, --port – Veraltet¶

Beschreibung

Für Abwärtskompatibilität/interne Verwendung bereitgestellt

Gibt die Portnummer an, die für die Verbindung verwendet werden soll.

Dieser Parameter wird nicht mehr verwendet, da die Portnummer für Snowflake immer 443 ist.

Wert

Zeichenfolge

Standard

Keine

--region – Veraltet¶

Beschreibung

Für Abwärtskompatibilität/interne Verwendung bereitgestellt

Gibt die ID für die Region an, in der sich Ihr Konto befindet.

Dieser Parameter wird nicht mehr verwendet. Weitere Details dazu finden Sie unter -a, --accountname (unter diesem Thema).

Wert

N/A

Standard

N/A

-m, --mfa-passcode¶

Beschreibung

Gibt das zweite Token für MFA (mehrstufige Authentifizierung) an, wenn Sie die Kennung in der Befehlszeile übergeben.

Wert

Zeichenfolge

Standard

Keine

--mfa-passcode-in-password¶

Beschreibung

Fügt die MFA-Kennung an das Ende des Kennworts an.

Sie können die Kennwortabfrage erzwingen und das Kennwort gefolgt von der MFA-Kennung eingeben. Beispiel, wenn das MFA-Token 123456 war und das Kennwort PASSWORD:

$ snowsql ... -P ...

Password: PASSWORD123456

Copy

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

--abort-detached-query¶

Beschreibung

Bricht eine Abfrage ab, wenn die Verbindung zwischen Client und Server unterbrochen wird.

Wert

Boolesch

Standard

„False“ (d. h. eine aktive Abfrage bricht nicht ab, wenn die Verbindung unterbrochen wird)

--probe-connection¶

Beschreibung

Testen Sie die Konnektivität zu Snowflake, und berichten Sie die Ergebnisse. Beachten Sie, dass es sich hierbei um eine experimentelle Option handelt, die hauptsächlich zum Ausdrucken der TLS-Zertifikatkette verwendet wird.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

--authenticator¶

Beschreibung

Gibt den Authentifikator an, der für die Überprüfung der Anmeldeinformationen des Benutzers verwendet werden soll.

Wert

Zeichenfolge (Konstante):

• snowflake verwendet den internen Snowflake-Authentifikator.

• externalbrowser verwendet für die Authentifizierung Ihren Webbrowser und Okta, AD FS oder einen anderen SAML 2.0-kompatiblen Identitätsanbieter (IdP), der für Ihr Konto definiert wurde.

• https://<Name_des_Okta-Kontos>.okta.com (d. h. der URL-Endpunkt für Okta), um sich über das native Okta zu authentifizieren (nur unterstützt, wenn Ihr IdP Okta ist).

• oauth zum Authentifizieren mit OAuth. Wenn OAuth als Authentifikator angegeben ist, müssen Sie auch den Parameter --token festlegen, um das OAuth-Token anzugeben (siehe unten).

Weitere Informationen dazu finden Sie unter Verwenden und Verwalten der Verbundauthentifizierung und Clients, Treiber und Konnektoren.

Standard

snowflake

Bemerkung

Der externalbrowser-Authentifikator wird nur in Terminalfenstern unterstützt, die Zugriff auf einen Webbrowser haben. So kann beispielsweise für ein Terminalfenster auf einem Remotecomputer, auf das über eine SSH (Secure Shell)-Sitzung zugegriffen wird, ein zusätzliches Setup zum Öffnen eines Webbrowsers erforderlich sein.

Wenn Sie keinen Zugriff auf einen Webbrowser haben, Ihr IdP aber Okta ist, können Sie natives Okta verwenden (d. h. den Authentifikator auf https://<Name_des_Okta-Kontos>.okta.com einstellen).

--token¶

Beschreibung

Gibt das OAuth-Token an, das für die Authentifizierung verwendet werden soll. Dieser Parameter ist nur erforderlich, wenn Sie --authenticator=oauth angeben.

Wert

Zeichenfolge

Standard

Keine

-v, --version¶

Beschreibung

Verwendet die angegebene SnowSQL-Version oder zeigt, wenn keine Version angegeben ist, die zuletzt installierte SnowSQL-Version an.

Wert

Zeichenfolge

Standard

Keine

--versions¶

Beschreibung

Listet alle verfügbaren Versionen von SnowSQL auf, die installiert und ausgeführt werden können. Um eine frühere SnowSQL-Version aus der Liste zu installieren, verwenden Sie die Option -v. Geben Sie die Version an, die Sie installieren möchten.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

--noup¶

Beschreibung

Deaktiviert das automatische Upgrade für diese Ausführung. Wenn diese Option nicht enthalten ist und eine neuere Version verfügbar ist, lädt SnowSQL die neue Version automatisch herunter und installiert sie. Wenn Sie SnowSQL das nächste Mal ausführen, wird die neue Version verwendet.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

-D, --variable¶

Beschreibung

Definiert SnowSQL-Variablen über die Befehlszeile. Diese Option kann verwendet werden, um bestimmte Variablen für die Verwendung in Snowflake festzulegen.

Wert

Zeichenfolge

Beispiel:

$ snowsql ... -D tablename=CENUSTRACKONE --variable db_key=$DB_KEY ...

Copy

Standard

Keine

-o, --option¶

Beschreibung

Definiert SnowSQL-Konfigurationsoptionen über die Befehlszeile. Diese Optionen überschreiben alle Optionen, die in der SnowSQL-Konfigurationsdatei eingestellt wurden. Eine Beschreibung der Optionen, die Sie einstellen/überschreiben können, finden Sie unter Übersicht der SnowSQL-Konfigurationsoptionen.

Wert

Zeichenfolge

Standard

Keine

-f, --filename¶

Beschreibung

Gibt eine SQL-Datei an, die im Batchmodus ausgeführt werden soll.

Der Wert kann ein Dateiname (ggf. mit Verzeichnispfad) oder eine URL zu der Datei sein.

Wert

Zeichenfolge

Standard

Keine

-q, --query¶

Beschreibung

Gibt eine SQL-Abfrage an, die ausgeführt werden soll.

Der Wert kann eine einzelne SQL-Abfrage oder eine durch Semikolons getrennte Liste der auszuführenden Abfragen sein (z. B. 'select current_user(); select current_role()').

Sie können auch mehrere Abfragen zur asynchronen Ausführung angeben, indem Sie die Abfragen mit ;> trennen. Im folgenden Beispiel wird SnowSQL gestartet, und dann werden alle vier Abfragen asynchron ausgeführt:

snowsql -o log_level=DEBUG -q "select * from SNOWSQLTABLE;> insert into table table1 values(2);> select 5;>select count(*) from testtable;"

Wert

Zeichenfolge

Standard

Keine

--config¶

Beschreibung

Gibt den Speicherort (d. h. den Verzeichnispfad) für die SnowSQL-Konfigurationsdatei an. Fügen Sie diesen Konnektorparameter hinzu, wenn Sie die Konfigurationsdatei vom Standardspeicherort verschieben oder kopieren möchten.

Wert

Zeichenfolge

Standard

OS-spezifisch:

Linux/macOS

~/.snowsql/

Windows

%USERPROFILE%\.snowsql\

-P, --prompt¶

Beschreibung

Erzwingt eine interaktive Kennwortabfrage.

Standardmäßig verwendet SnowSQL das in der Umgebungsvariablen $SNOWSQL_PWD gespeicherte Kennwort. Mit dieser Option können Sie das in $SNOWSQL_PWD definierte Kennwort außer Kraft setzen.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

-M, --mfa-prompt¶

Beschreibung

Erzwingt eine Eingabeaufforderung für das zweite Token für MFA. Alternativ können Sie für die Übergabe an die Befehlszeile --mfa-passcode <Zeichenfolge> verwenden.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

-c, --connection¶

Beschreibung

Gibt eine zu verwendende Verbindung an, wobei die angegebene Zeichenfolge der Name einer in der SnowSQL-Konfigurationsdatei definierten Verbindung ist. Weitere Details dazu finden Sie unter Verwenden benannter Verbindungen (unter diesem Thema).

Wert

Zeichenfolge

Standard

Keine

--single-transaction¶

Beschreibung

In Kombination mit --filename, --query oder Standard-Eingabebefehlen umschließt diese Option die Anweisungen mit BEGIN/COMMIT, um sicherzustellen, dass alle Befehle erfolgreich abgeschlossen werden oder keine Änderung vorgenommen wird.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

Bemerkung

Beachten Sie, dass bei Verwendung der Eingabebefehle BEGIN, COMMIT oder ROLLBACK diese Option nicht korrekt funktioniert. Wenn innerhalb eines Transaktionsblocks kein Befehl ausgeführt werden kann, führt diese Option auch zum Fehlschlagen des Befehls.

--private-key-path¶

Beschreibung

Pfad zur Datei des privaten Schlüssels.

Vorsicht

Unverschlüsselte private Schlüssel werden zwar unterstützt, Snowflake empfiehlt jedoch dringend die Verwendung verschlüsselter privater Schlüssel für die Verbindung zu Snowflake.

Weitere Informationen dazu finden Sie unter Verwenden von Schlüsselpaar-Authentifizierung und Schlüsselpaar-Rotation.

Dieser Verbindungsparameter kann auch in der Konfigurationsdatei eingestellt werden.

Wert

Zeichenfolge

Standard

Keine

--disable-request-pooling¶

Beschreibung

Standardmäßig verwendet snowsql Verbindungspooling. Verbindungspooling verringert normalerweise die Verzögerungszeit beim Herstellen einer Verbindung. Es kann jedoch das Client-Failover auf ein alternatives DNS verlangsamen, wenn ein DNS-Problem auftritt. Mit diesem Parameter können Sie das Verbindungspooling deaktivieren.

Dieser Parameter gilt nur für Kunden, bei denen die Replikation aktiviert ist.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

-U, --upgrade¶

Beschreibung

Erzwingt ein Upgrade von SnowSQL auf die neueste Version, wenn diese nicht in das lokale Verzeichnis heruntergeladen wird.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

Bemerkung

Erfordert die ausführbare Bootstrap-Datei von SnowSQL 1.1.63 oder einer neueren Version. Laden Sie diese über die Weboberfläche herunter.

-K, --client-session-keep-alive¶

Beschreibung

Snowflake hält die Sitzung unbegrenzt aktiv, auch wenn der Benutzer inaktiv ist.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

--include_connector_version¶

Beschreibung

Zeigt die Version der Software des Snowflake-Konnektors für Python an, die in der SnowSQL-Binärdatei enthalten ist.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A

-?, --help¶

Beschreibung

Zeigt die Kurzanleitung zur Verwendung der Befehlszeile an.

Wert

N/A (Parameter nimmt keinen Wert an)

Standard

N/A