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

Especificação da conta a ser usada¶

Os clientes, conectores e drivers usam uma variedade de sintaxes para se conectar ao Snowflake. Em geral, você deve usar a variação que inclui o nome da organização (orgname) e o nome da conta (account_name), com a seguinte exceção: se você usar o recurso de redirecionamento de cliente, 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.

SQLAchemy:

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

Usando instruções SQL para encontrar seu identificador de conta¶

Para obter o formulário organization_name-account_name de seu identificador de conta, execute o seguinte comando SQL:

SELECT CURRENT_ORGANIZATION_NAME() || '-' || CURRENT_ACCOUNT_NAME();

Para obter o localizador de conta do identificador de conta, execute o seguinte comando SQL:

SELECT CURRENT_ACCOUNT();

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