snow helpers import-snowsql-connections¶

Sintaxe¶

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>

Argumentos¶

Nenhum

Opções¶

--snowsql-config-file FILE

Especifica os caminhos de arquivo para a configuração personalizada do SnowSQL. A opção pode ser usada várias vezes para especificar mais de um arquivo.

--default-connection-name TEXT

Especifica o nome que será dado no Snowflake CLI à conexão padrão importada do SnowSQL. Padrão: padrão.

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

Especifica o formato de saída. Padrão: TABLE.

--verbose, -v

Exibe entradas de log para os níveis de log info e superiores. Padrão: falso.

--debug

Exibe entradas de log para níveis de log de depuração e superiores; os logs de depuração contêm informações adicionais. Padrão: falso.

--silent

Desliga a saída intermediária para o console. Padrão: falso.

--enhanced-exit-codes

Diferencia os códigos de erro de saída com base no tipo de falha. Padrão: falso.

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

Exibe o texto de ajuda para este comando.

Notas de uso¶

O comando snow helpers import-snowsql-connections importa as definições de conexão existentes de SnowSQL para o arquivo de configuração config.toml.

Por padrão, o comando lê os arquivos de configuração SnowSQL na ordem descrita no tópico Como configurar o SnowSQL. Se mais de uma dessas configurações definir a mesma conexão, esse comando substituirá a definição de conexão importada anteriormente pela mais recente. Para ilustrar, suponha que a mesma conexão [connections.example] seja definida com parâmetros diferentes nos seguintes locais:

[connections]

[connections.example]
username=user1

[connections]

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

Depois que você executar o comando, o arquivo Snowflake CLI config.toml conterá a seguinte definição [connections.example] (do arquivo com a precedência mais alta):

[connections]

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

Você pode usar a opção --snowsql-config-file para substituir esse comportamento padrão e importar de um ou mais arquivos de configuração específicos do SnowSQL.

O comando snow helpers import-snowsql-connections também importa a conexão padrão de SnowSQL, que não é uma conexão nomeada. Ele é definido diretamente na seção [connections] do arquivo de configuração. Como o Snowflake CLI exige que todas as conexões sejam nomeadas, o comando define uma conexão chamada [default]. Se quiser usar outro nome para a conexão padrão, você pode especificá-lo com a opção --default-connection-name.

Se uma conexão SnowSQL corresponder ao nome de uma conexão Snowflake CLI existente, o prompt de comando perguntará se você deseja substituir a conexão existente ou ignorar a importação dessa conexão SnowSQL.

Exemplos¶

O exemplo a seguir importa conexões SnowSQL dos locais de arquivo de configuração padrão:

snow helpers import-snowsql-connections

À medida que o comando processa os arquivos de configuração SnowSQL, ele mostra o progresso e solicita a confirmação quando uma conexão com o mesmo nome já estiver definida no arquivo 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.