snow helpers import-snowsql-connections¶

Syntax¶

snow helpers import-snowsql-connections
  --snowsql-config-file <custom_snowsql_config_files>
  --default-connection-name <default_cli_connection_name>
  --format <format>
  --verbose
  --debug
  --silent
  --enhanced-exit-codes
  --decimal-precision <decimal_precision>

Argumente¶

Keine

Optionen¶

--snowsql-config-file FILE

Gibt Dateipfade für die benutzerdefinierte SnowSQL-Konfiguration an. Die Option kann mehrfach verwendet werden, um mehr als eine Datei anzugeben.

--default-connection-name TEXT

Gibt den Namen an, der in der Snowflake-CLI für die von SnowSQL importierte Standardverbindung vergeben wird. Standard: Standard.

--format [TABLE|JSON| JSON_EXT|CSV]

Gibt das Ausgabeformat an. Standard: TABLE.

--verbose, -v

Zeigt Protokolleinträge für die Protokolliergrade info und höher an. Standard: false

--debug

Zeigt Protokolleinträge für die Protokollebenen debug und höher an; Debug-Protokolle enthalten zusätzliche Informationen. Standard: false

--silent

Schaltet Zwischenausgaben auf der Konsole aus. Standard: false

--enhanced-exit-codes

Exit-Fehlercodes nach Art des Fehlers unterscheiden. Standard: false

--decimal-precision INTEGER

Number of decimal places to display for decimal values. Uses Python’s default precision if not specified. [env var: SNOWFLAKE_DECIMAL_PRECISION].

--help

Zeigt den Hilfetext für diesen Befehl an.

Nutzungshinweise¶

Der Befehl snow helpers import-snowsql-connections importiert bestehende Verbindungsdefinitionen aus SnowSQL in Ihre config.toml-Konfigurationsdatei.

Standardmäßig liest der Befehl die SnowSQL Konfigurationsdateien in der Reihenfolge, die im Thema Konfigurieren SnowSQL beschrieben ist. Wenn mehr als eine dieser Konfigurationen dieselbe Verbindung definiert, überschreibt dieser Befehl die zuvor importierte Verbindungsdefinition mit der neuesten. Zur Veranschaulichung nehmen wir an, dass dieselbe [connections.example]-Verbindung mit verschiedenen Parametern an den folgenden Speicherorten definiert ist:

[connections]

[connections.example]
username=user1

[connections]

[connections.example]
username=user2
password=<my-pwd>

Nachdem Sie den Befehl ausgeführt haben, enthält Ihre Snowflake CLI config.toml-Datei die folgende [connections.example]-Definition (aus der Datei mit der höheren Priorität):

[connections]

[connections.example]
username=user2
password=<my-pwd>

Sie können die Option --snowsql-config-file verwenden, um dieses Standardverhalten zu beschreiben und stattdessen aus einer oder mehreren spezifischen SnowSQL-Konfigurationsdateien zu importieren.

Der Befehl snow helpers import-snowsql-connections importiert auch die Standardverbindung von SnowSQL, bei der es sich nicht um eine benannte Verbindung handelt. Sie wird direkt im Abschnitt [connections] der Konfigurationsdatei definiert. Da Snowflake CLI verlangt, dass alle Verbindungen benannt werden, definiert der Befehl eine Verbindung mit dem Namen [default]. Wenn Sie einen anderen Namen für die Standardverbindung verwenden möchten, können Sie ihn mit der Option --default-connection-name angeben.

Wenn eine SnowSQL-Verbindung mit dem Namen einer bestehenden Snowflake CLI-Verbindung übereinstimmt, fragt die Eingabeaufforderung, ob Sie die bestehende Verbindung überschreiben oder den Import dieser SnowSQL-Verbindung überspringen möchten.

Beispiele¶

Im folgenden Beispiel werden SnowSQL-Verbindungen aus den Standardkonfigurationsdateien importiert:

snow helpers import-snowsql-connections

Während der Befehl die SnowSQL-Konfigurationsdateien verarbeitet, zeigt er den Fortschritt an und fordert Sie zur Bestätigung auf, wenn in der Datei Snowflake CLI config.toml bereits eine Verbindung mit demselben Namen definiert ist:

SnowSQL config file [/etc/snowsql.cnf] does not exist. Skipping.
SnowSQL config file [/etc/snowflake/snowsql.cnf] does not exist. Skipping.
SnowSQL config file [/usr/local/etc/snowsql.cnf] does not exist. Skipping.
Trying to read connections from [/Users/<user>/.snowsql.cnf].
Reading SnowSQL's connection configuration [connections.connection1] from [/Users/<user>/.snowsql.cnf]
Trying to read connections from [/Users/<user>/.snowsql/config].
Reading SnowSQL's default connection configuration from [/Users/<user>/.snowsql/config]
Reading SnowSQL's connection configuration [connections.connection1] from [/Users/<user>/.snowsql/config]
Reading SnowSQL's connection configuration [connections.connection2] from [/Users/<user>/.snowsql/config]
Connection 'connection1' already exists in Snowflake CLI, do you want to use SnowSQL definition and override existing connection in Snowflake CLI? [y/N]: Y
Connection 'connection2' already exists in Snowflake CLI, do you want to use SnowSQL definition and override existing connection in Snowflake CLI? [y/N]: n
Connection 'default' already exists in Snowflake CLI, do you want to use SnowSQL definition and override existing connection in Snowflake CLI? [y/N]: n
Saving [connection1] connection in Snowflake CLI's config.
Connections successfully imported from SnowSQL to Snowflake CLI.