snow helpers import-snowsql-connections¶

Syntaxe¶

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>

Arguments¶

Aucun(e)

Options¶

--snowsql-config-file FILE

Spécifie les chemins d’accès à la configuration personnalisée de SnowSQL. L’option peut être utilisée plusieurs fois pour spécifier plusieurs fichiers.

--default-connection-name TEXT

Spécifie le nom qui sera donné dans Snowflake CLI à la connexion par défaut importée de SnowSQL. Défaut : défaut.

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

Spécifie le format de sortie. Par défaut : TABLE.

--verbose, -v

Affiche les entrées de journal pour les niveaux de journalisation info et supérieurs. Par défaut : false.

--debug

Affiche les entrées de journal pour les niveaux de journalisation debug et supérieurs ; les journaux de débogage contiennent des informations supplémentaires. Par défaut : false.

--silent

Désactive la sortie intermédiaire vers la console. Par défaut : false.

--enhanced-exit-codes

Différenciez les codes d’erreur de sortie en fonction du type d’erreur. Par défaut : 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

Affiche le texte d’aide de cette commande.

Notes sur l’utilisation¶

La commande snow helpers import-snowsql-connections importe les définitions de connexions existantes de SnowSQL dans votre fichier de configuration config.toml.

Par défaut, la commande lit les fichiers de configuration SnowSQL dans l’ordre décrit dans la rubrique Configuration SnowSQL. Si plusieurs de ces configurations définissent la même connexion, cette commande remplace la définition de connexion importée précédemment par la plus récente. Pour illustrer, supposons que la même connexion [connections.example] est définie avec différents paramètres aux emplacements suivants :

[connections]

[connections.example]
username=user1

[connections]

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

Après avoir exécuté la commande, votre fichier Snowflake CLI config.toml contient la définition suivante [connexions.exemple] (du fichier ayant la priorité la plus élevée) :

[connections]

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

Vous pouvez utiliser l’option --snowsql-config-file pour ignorer ce comportement par défaut et importer à partir d’un ou plusieurs fichiers de configuration spécifiques SnowSQL à la place.

La commande snow helpers import-snowsql-connections importe également la connexion par défaut de SnowSQL, qui n’est pas une connexion nommée. Elle est définie directement dans la section [connections] du fichier de configuration. Comme Snowflake CLI exige que toutes les connexions soient nommées, la commande définit une connexion nommée [default]. Si vous souhaitez utiliser un autre nom pour la connexion par défaut, vous pouvez le spécifier avec l’option --default-connection-name.

Si une connexion SnowSQL correspond au nom d’une connexion Snowflake CLI existante, l’invite de commande vous demande si vous souhaitez remplacer la connexion existante ou ignorer l’importation de cette connexion SnowSQL.

Exemples¶

L’exemple suivant importe les connexions de SnowSQL à partir des emplacements des fichiers de configuration standard :

snow helpers import-snowsql-connections

Au fur et à mesure que la commande traite les fichiers de configuration SnowSQL, elle affiche la progression et demande une confirmation lorsqu’une connexion portant le même nom est déjà définie dans le fichier Snowflake CLI config.toml.

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.