Conexão às suas contas

Este tópico fornece os formatos de URL e identificador de conta que você usa para se conectar às contas Snowflake em sua organização.

Nota

Se você for administrador de uma organização e quiser excluir URLs antigos de uma conta que foi alterada, consulte Gerenciamento dos URLs de conta.

Neste tópico:

Conexão com a interface da Web do Snowflake

Para conectar-se a Snowsight usando seu navegador da web, consulte Como fazer login no Snowsight.

Conexão com uma URL

O Snowflake oferece suporte a múltiplos formatos de URL ao conectar-se a uma conta Snowflake sem um navegador. Por exemplo, um provedor de identidade pode usar uma URL direta para se comunicar com o Snowflake.

URLs de contas padrão

O formato de URL padrão pode ser usado na maioria dos casos em que uma URL de conta Snowflake é necessária, inclusive:

  • Conexões SSO (exceto Okta)

  • URL de base SCIM (exceto Okta)

  • Conexões OAuth com provedores de identidade terceirizados (exceto Okta)

  • URL de base OAuth para um servidor de autorização Snowflake

Os formatos padrão de URL são:

  • Nome da conta: https://<nomeorg>-<nome_conta>.snowflakecomputing.com

  • Nome da conexão: https://<nomeorg>-<nomedaconexão>.snowflakecomputing.com

  • Localizador de contas (herdado): https://<localizadorconta>.<região>.<nuvem>.snowflakecomputing.com

URLs de conectividade privada

Ao se conectar com o Snowflake usando a conectividade privada ao serviço Snowflake (por exemplo, AWS PrivateLink), o privatelink da cadeia de caracteres deve ser anexado ao identificador da conta na URL da conta Snowflake.

  • Nome da conta: https://<nomeorg>-<nome_conta>.privatelink.snowflakecomputing.com

  • Nome da conexão: https://<nomeorg>-<nomedaconexão>.privatelink.snowflakecomputing.com

  • Localizador de contas (herdado): https://<localizador_conta>.<região>.privatelink.snowflakecomputing.com

Observe que usar a conectividade privada requer atualização dos registros DNS para incluir a URL de conectividade privada. Para obter mais informações, consulte:

URLs do Okta

Ao usar o Okta para SSO, SCIM ou OAuth, você deve usar um formato especial de nome de conta se o nome da conta contiver um sublinhado. Como o Okta não oferece suporte a sublinhados em URLs, o sublinhado no nome da conta deve ser convertido em um hífen.

  • Nome da conta: https://<nomeorg>-<nome-conta>.snowflakecomputing.com

  • Nome da conexão: use a URL padrão

  • Localizador de contas (herdado): use a URL padrão

Conexão com clientes, conectores e drivers

Os clientes, conectores e drivers usam uma variedade de sintaxes para se conectar ao Snowflake. Em geral, deve-se usar a variação que inclui o nome da organização (orgname) e o nome da conta (account_name), com as seguintes exceções:

  • Se você usar o recurso Redirecionamento do 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.

  • Atualmente, não há suporte para a conectividade privada com o serviço Snowflake usando o formato de nome de conta. Como alternativa, anexe privatelink à sintaxe do localizador de conta. Para verificar 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.

SnowSQL:
  • Nome da conta: snowsql -a <nomeorg>-<nome_conta>

  • Localizador de conta: snowsql -a <localizador_de_conta>

JDBC:
  • Nome da conta: jdbc:snowflake://<nomeorg>-<nome_conta>.snowflakecomputing.com/?<params_conexão>

  • Localizador de conta: jdbc:snowflake://<localizador_de_conta>.snowflakecomputing.com/?<params_conexão>

ODBC:
  • Nome da conta:

    • Servidor: <nomeorg>-<nome_conta>.snowflakecomputing.com

  • Localizador de conta:

    • Servidor: <localizador_de_conta>.snowflakecomputing.com

Python:
  • Nome da conta:

    • Defina o valor do parâmetro ACCOUNT como <nomeorg>-<nome_da_conta>.

  • Localizador de conta:

    • Defina o valor do parâmetro ACCOUNT como <localizador_de_conta>.<id_região>.<nuvem>.

.Net:
  • Nome da conta:

    • Defina o valor do parâmetro ACCOUNT como <nomeorg>-<nome_da_conta>.

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

  • Localizador de conta:

    • Defina o valor do parâmetro ACCOUNT como <localizador_de_conta>.

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

Golang:
  • Nome da conta: db, err := sql.Open("snowflake", "jsmith:mypassword@<nomeorg>-<nome_conta>/mydb/testschema?warehouse=mywh")

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

node.js:
  • Nome da conta: defina o valor do parâmetro ACCOUNT como <nomeorg>-<nome_da_conta>.

  • Localizador de conta: defina o valor do parâmetro ACCOUNT como <localizador_de_conta>.<id_região>.<nuvem>.

Spark (conector):
  • Nome da conta: o mesmo que JDBC

  • Localizador de conta: o mesmo que JDBC

Spark (Databricks):
  • Nome da conta: <URL de conta para a conta Snowflake>

  • Localizador de conta: <URL do localizador de conta para a conta Snowflake>

Spark (Qubole):
  • Nome da conta: defina o valor do campo Host Address como <nomeorg>-<nome_da_conta>.snowflakecomputing.com.

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

PHP:
  • Nome da conta:

    • Defina o valor do parâmetro ACCOUNT como <nomeorg>-<nome_da_conta>.

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

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

SQLAchemy:
  • Nome da conta: snowflake://<nome_de_login_de_usuário>:<senha>@<nomeorg>-<nome_da_conta>

  • Localizador de conta: snowflake://<nome_login_usuário>:<senha>@<localizador_de_conta>.<id_região>.<nuvem>

Compatibilidade reversa

O uso do localizador de conta herdado em um identificador de conta ou URL de conta ainda tem suporte, mas não é recomendado.