Configuração de um cliente, driver, biblioteca ou aplicativo de terceiros para se conectar ao Snowflake¶

Usando o Snowsight para obter as configurações de conexão¶

Para obter as configurações que você pode usar para configurar um cliente, driver, biblioteca ou aplicativo de terceiros:

1. Faça login para Snowsight.

2. Abra o menu do usuário selecionando seu nome de usuário.

   

3. No menu do usuário, selecione Connect a tool to Snowflake para exibir a caixa de diálogo Account Details.

   Dica

   Você também pode exibir os detalhes da conta no seletor de contas.

4. Selecione uma das guias a seguir:

   • Se seu cliente, driver, biblioteca ou aplicativo de terceiros oferecer suporte ao uso de um arquivo de configuração TOML (por exemplo, Snowflake CLI, Snowflake Python APIs, ou Snowflake Connector para Python:

     1. Selecione a guia Config file.

     2. Para especificar um warehouse no arquivo de configuração, selecione o warehouse no menu Warehouse.

     3. Para especificar um banco de dados e um esquema no arquivo de configuração, use o menu Database para selecionar o banco de dados e o esquema.

     4. No menu Connection Method, selecione o método que você planeja usar para autenticar:

        • Para usar o login único baseado em navegador (SSO), selecione Web Browser.

        • Para usar uma senha, selecione Password.

        Nota

        Clientes, drivers, bibliotecas e aplicativos de terceiros oferecem suporte a métodos de autenticação adicionais não listados no menu. Para obter mais informações, consulte Proteção do Snowflake.

     5. Selecione o ícone de cópia () para copiar o conteúdo do arquivo de configuração.

     Nota

     Para as APIs Python Snowflake, os sublinhados não são compatíveis com a configuração account. Se o identificador da conta incluir sublinhados, substitua-os por traços.

   • Se seu cliente, driver, biblioteca ou aplicativo de terceiros oferecer suporte à especificação de uma cadeia de caracteres de conexão (por exemplo, o driver ODBC, o driver JDBC, o driver Go Snowflake ou o driver .NET):

     1. Selecione a guia Connectors/Drivers.

     2. No menu Select Connector or Driver, selecione o driver que deseja usar.

     3. Para especificar um warehouse na cadeia de caracteres de conexão, selecione o warehouse no menu Warehouse. (Observe que esse menu não está presente em ODBC e .NET.)

     4. Para especificar um banco de dados e um esquema na cadeia de caracteres de conexão, use o menu Database para selecionar o banco de dados e o esquema.

     5. No menu Connection Method, selecione o método que você planeja usar para autenticar:

        • Para usar o login único baseado em navegador (SSO), selecione Web Browser.

        • Para usar uma senha, selecione Password.

        Nota

        Clientes, drivers, bibliotecas e aplicativos de terceiros oferecem suporte a métodos de autenticação adicionais não listados no menu. Para obter mais informações, consulte Proteção do Snowflake.

     6. Selecione o ícone de cópia () para copiar a cadeia de caracteres de conexão resultante.

   • Para executar os comandos SQL para obter informações de configuração:

     1. Selecione a guia SQL Commands.

     2. Selecione o ícone de cópia () ao lado do comando que fornece as informações de que você precisa, cole o comando em uma planilha e execute o comando.

Usando os comandos SQL para obter as configurações de conexão¶

Você pode executar os comandos SQL para obter as seguintes informações necessárias para configurar seu cliente, driver, biblioteca ou aplicativo:

SELECT CURRENT_USER();

SELECT CURRENT_ROLE();

SELECT CURRENT_REGION();

SELECT CURRENT_WAREHOUSE();

SELECT CURRENT_DATABASE();

SELECT CURRENT_SCHEMA();

Formatos de conta usados por clientes e drivers¶

Para clientes e drivers diferentes, você usa sintaxes diferentes para especificar sua conta.

Em geral, você deve usar a variação que inclui o nome da organização (orgname) e o nome da conta (account_name).

Uma exceção a essa regra é quando você está usando o recurso Redirecionamento de cliente. Se você estiver usando esse recurso, substitua o nome da conta (account_name) pelo nome da conexão (connection_name). Para exemplos dessa sintaxe, consulte Uso de uma URL de conexão.

Para configurar uma conexão privada com o serviço Snowflake, adicione .privatelink ao nome da conta ou à sintaxe do localizador de conta. Para determinar qual valor você deve usar para se conectar ao Snowflake ao usar a conectividade privada, chame a função SYSTEM$GET_PRIVATELINK_CONFIG em sua conta Snowflake.

Se precisar usar o localizador de contas, talvez também precise especificar o ID da região da nuvem, a nuvem e o nível de conformidade governamental como segmentos adicionais após o localizador de contas. Para saber o formato a ser usado, consulte Formato 2: Localizador de conta em uma região.. Nos exemplos abaixo, account_locator_with_additional_segments representa o local da conta com todos os segmentos adicionais necessários.

SnowSQL:

• Nome de conta: snowsql -a orgname-account_name

• Localizador de conta: snowsql -a account_locator_with_additional_segments

Para obter informações adicionais, consulte Sintaxe de conexão.

JDBC:

• Nome de conta: jdbc:snowflake://orgname>-<account_name.snowflakecomputing.com/?connection_paramsr

• Localizador de conta: jdbc:snowflake://account_locator_with_additional_segments.snowflakecomputing.com/?connection_params

Para obter informações adicionais, consulte Cadeia de conexão do driver JDBC.

ODBC:

• Nome da conta:

  • Servidor: orgname-account_name.snowflakecomputing.com

• Localizador de conta:

  • Servidor: account_locator_with_additional_segments.snowflakecomputing.com}

Para obter informações adicionais, consulte Parâmetros de configuração e conexão do ODBC.

Python:

• Nome da conta:

  • Defina o valor do parâmetro ACCOUNT como orgname-account_name.

• Localizador de conta:

  • Defina o valor do parâmetro ACCOUNT como account_locator_with_additional_segments.

Para obter informações adicionais, consulte Conexão ao Snowflake com o conector Python.

.Net:

• Nome da conta:

  • Defina o valor do parâmetro ACCOUNT como orgname-account_name.

  • Defina o valor do parâmetro HOST como o padrão (.snowflakecomputing.com).

• Localizador de conta:

  • Defina o valor do parâmetro ACCOUNT como account_locator_with_additional_segments.

  • Defina o valor do parâmetro HOST como o padrão .snowflakecomputing.com. Especifique se sua conta Snowflake não está na região us-west.

Para obter informações adicionais, consulte como se conectar.

Golang:

• Nome de conta: db, err := sql.Open("snowflake", "jsmith:mypassword@orgname-account_name/mydb/testschema?warehouse=mywh")

• Localizador de conta: sql.Open("snowflake", "jsmith:mypassword@account_locator_with_additional_segments/mydb/testschema?warehouse=mywh")

Para obter mais informações, consulte Cadeia de caracteres de conexão.

node.js:

• Nome de conta: defina o valor do parâmetro ACCOUNT como orgname-account_name.

• Localizador de conta: defina o valor do parâmetro ACCOUNT como account_locator_with_additional_segments.

Para obter informações adicionais, consulte Gerenciamento de conexões.

Spark (conector):

• Nome da conta: o mesmo que JDBC

• Localizador de conta: o mesmo que JDBC

Para obter informações adicionais, consulte Definição das opções de configuração para o conector.

Spark (Databricks):

• Nome de conta: Account URL for Snowflake account

• Localizador de conta: Account Locator URL for Snowflake account

Para obter informações adicionais, consulte Configuração do Snowflake para Spark no Databricks.

Spark (Qubole):

• Nome da conta: defina o valor do campo Host Address como orgname-account_name.snowflakecomputing.com.

• Localizador de conta: defina o valor do campo Host Address como account_locator_with_additional_segments.snowflakecomputing.com.

Para obter informações adicionais, consulte Configuração do Snowflake para Spark no Qubole.

PHP:

• Nome da conta:

  • Defina o valor do parâmetro ACCOUNT como orgname-account_name.

  • Deixe o valor do parâmetro REGION em branco para todas as regiões.

• Localizador de conta:

  • Defina o valor do parâmetro ACCOUNT como account_locator.

  • Defina o valor do parâmetro REGION se sua conta Snowflake não for da região us-west.

Para obter mais informações, consulte Como se conectar ao banco de dados Snowflake.

SQLAlchemy:

• Nome de conta: snowflake://user_login_name:password@orgname-account_name

• Localizador de conta: snowflake://user_login_name:password@account_locator_with_additional_segments

Para obter informações adicionais, consulte Uso do Snowflake SQLAlchemy Toolkit com o conector Python.

Etapas adicionais de configuração¶

Os próximos tópicos abordam áreas específicas da configuração de uma conexão:

• Permissão de nomes de host

• Configuração do OCSP