Redirecionamento de conexões do cliente¶

Introdução ao Redirecionamento do cliente¶

O Redirecionamento do cliente é implementado através de um objeto de conexão do Snowflake. O objeto de conexão armazena uma URL de conexão segura que você usa com um cliente Snowflake para se conectar ao Snowflake.

O nome de host na URL da conexão é composto pelo nome de sua organização e o nome do objeto de conexão, além de um nome de domínio comum:

organization_name-connection_name.snowflakecomputing.com

Observe que este nome de host não especifica a conta à qual você está se conectando. Um administrador de conta determina a conta a ser usada designando a conexão nessa conta para servir como a conexão primária. Quando você usa a URL da conexão para conectar-se ao Snowflake, está se conectando à conta que contém a conexão primária.

Se ocorrer uma interrupção em uma região ou plataforma de nuvem e a interrupção afetar a conta com a conexão primária, o administrador pode promover uma conexão em uma conta diferente em uma região ou plataforma de nuvem diferente para servir como a conexão primária.

Durante desta interrupção, você pode continuar a usar a mesma URL de conexão para se conectar ao Snowflake. O Snowflake resolve a URL da conexão à conta com a nova conexão promovida (a conta fora da região ou plataforma de nuvem afetada pela interrupção).

Fluxo do Redirecionamento do cliente¶

1. Complete as etapas em Configuração do Redirecionamento do cliente (neste tópico) para criar uma URL de conexão para conexões de clientes. Isto inclui a criação de uma conexão primária e conexões secundárias vinculadas.

2. Atualize clientes Snowflake para se conectar usando a URL de conexão. Uso de uma URL de conexão (neste tópico) contém uma lista de clientes com suporte e detalhes de conexão.

3. No caso de uma interrupção de serviço na região onde a conexão primária está localizada, complete as etapas em Redirecionamento de conexões do cliente (neste tópico) para atualizar a URL da conexão para redirecionar para uma conexão secundária.

4. Quando a interrupção for resolvida, complete as etapas em Redirecionamento de conexões do cliente para redirecionar as conexões do cliente de volta para a conexão primária original.

Os diagramas a seguir ilustram o fluxo do Redirecionamento do cliente para duas contas na mesma organização mas em regiões diferentes (Region A e Region B) na mesma ou em plataformas de nuvem diferentes.

A conexão primária está em Account 1 em Region A. Clientes Snowflake usando a URL da conexão se conectam a Account 1.

Uma interrupção de serviço em Region A resulta em falhas nas conexões de clientes:

A conexão em Account 2 em Region B é promovida para atuar como a conexão primária. Clientes Snowflake usando a URL da conexão agora se conectam a Account 2.

-- Create a new primary connection
CREATE CONNECTION myconnection;

-- View accounts in your organization that are enabled for replication
SHOW REPLICATION ACCOUNTS;

-- Configure failover accounts for the primary connection
ALTER CONNECTION myconnection
  ENABLE FAILOVER TO ACCOUNTS myorg.myaccount2, myorg.myaccount3;

-- View the details for the connection
SHOW CONNECTIONS;

CREATE CONNECTION myconnection
  AS REPLICA OF myorg.myaccount1.myconnection;

ALTER CONNECTION myconnection PRIMARY;

ALTER CONNECTION myconnection PRIMARY;

Configuração do Redirecionamento do cliente¶

Esta seção descreve como criar uma conexão primária e uma ou mais conexões secundárias em um grupo de conexões.

Configuração das definições de DNS para conectividade privada com o serviço do Snowflake¶

Se a conectividade privada ao serviço Snowflake estiver ativada para sua conta Snowflake, então seu administrador de rede deve criar e gerenciar um registro DNS para sua URL de conexão. O administrador da rede pode usar um registro CNAME, ou um registro de alias, com base na configuração da arquitetura de rede.

Para todas as outras contas, o Snowflake cria e gerencia o registro DNS. Para fins de consistência, o exemplo a seguir usa o registro CNAME.

Estas etapas usam AWS PrivateLink como exemplo, e as etapas são as mesmas se sua conta Snowflake usar o Azure Private Link ou o Google Cloud Private Service Connect:

1. Execute SHOW CONNECTIONS em uma de suas contas na qual o redirecionamento do cliente esteja habilitado. Por exemplo, suponha que AWS PrivateLink esteja habilitado para myaccount1 e myaccount2.

   SHOW CONNECTIONS;
   
   +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
   | snowflake_region   | created_on                    | account_name        | name              | comment         | is_primary    | primary                       | failover_allowed_to_accounts        | connection_url                            | organization_name | account_locator   |
   |--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|
   | AWS_US_WEST_2      | 2020-07-19 14:49:11.183 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
   |--------------------|-------------------------------|---------------------|-------------------|-----------------|---------------|-------------------------------|-------------------------------------|-------------------------------------------|-------------------|-------------------|
   | AWS_US_WEST_2      | 2020-07-19 14:49:11.183 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
   | AWS_US_EAST_1      | 2020-07-22 13:52:04.925 -0700 | MYORG.MYACCOUNT2    | MYCONNECTION      | NULL            | false         | MYORG.MYACCOUNT1.MYCONNECTION |                                     | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR2 |
   +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
   

   Copy

   Observe que a saída deste comando na coluna CONNECTION_URL deve corresponder à lista privatelink-connection-urls ao chamar a função SYSTEM$GET_PRIVATELINK_CONFIG em myaccount1 ou myaccount2. Esta lista já contém a conexão URL formatada com o segmento privatelink (como mostrado na próxima etapa). Opcionalmente, você pode executar o comando nesta etapa ou chamar a função. Se chamar a função, use os URLs como estão sem nenhuma outra modificação.

2. Registre o valor da coluna CONNECTION_URL e crie duas URLs para oferecer suporte à conectividade privada e OCSP.

   1. Adicione um segmento privatelink à URL logo antes de snowflakecomputing.com (myorg-myconnection.privatelink.snowflakecomputing.com, neste exemplo).

   2. Adicione um segmento ocsp ao início da URL (ocsp.myorg-myconnection.privatelink.snowflakecomputing.com, neste exemplo).

3. Usando uma ferramenta fornecida por seu provedor de DNS, crie um registro CNAME para a URL de conexão e o URL OCSP.

   • Defina o domínio (ou alias) usando o valor modificado da coluna CONNECTION_URL.

   • Configure o registro para que a URL da conexão seja resolvida com a URL da conta Snowflake principal. Certifique-se de incluir todos os segmentos de URL para a região da nuvem e AWS PrivateLink com base no formato URL escolhido. Esta é a URL da conta principal e é para onde as conexões do cliente com a URL de conexão serão redirecionadas.

   • Configure o registro para que a URL OCSP resolva o endereço IP do ponto de extremidade privado para uma conta no Azure ou o valor do ID privado do ponto de extremidade para uma conta no AWS.

   • No caso de failover, você deve atualizar manualmente a configuração DNS para que a URL de conexão aponte para a URL da conta secundária conforme mostrado em Modificação das configurações DNS para conectividade privada com o serviço Snowflake. Da mesma forma, você deve atualizar suas configurações OCSP para apontar para o endereço IP do ponto de extremidade privado ou para o valor de ID do ponto de extremidade privado.

     Por exemplo:

     myaccount1.us-west-2.privatelink.snowflakecomputing.com.
     ocsp.myaccount1.us-west-2.privatelink.snowflakecomputing.com.
     

     Copy

     Alternativamente, use a URL da organização e nome da conta.

     Por exemplo:

     myorg-myaccount1.privatelink.snowflakecomputing.com.
     ocsp.myorg-myaccount1.privatelink.snowflakecomputing.com.
     

     Copy

     Observe o ponto final, que deve ser incluído.

Os usuários se conectam ao Snowflake usando o seguinte formato de URL de conexão:

organization_name-connection_name.privatelink.snowflakecomputing.com

Onde:

organization_name

Nome de sua organização no Snowflake. As contas Snowflake a que seus usuários se conectam estão contidas nesta organização.

connection_name

Nome do objeto de conexão.

Para obter mais informações, consulte:

• Uso de uma URL de conexão (neste tópico).

• Modificação das configurações DNS para conectividade privada com o serviço Snowflake (neste tópico).

Uso de uma URL de conexão¶

Esta seção fornece instruções para fazer referência à URL de conexão na configuração de vários clientes Snowflake.

<organization-name>-<connection-name>

myorg-myconnection

https://<organization_name>-<connection_name>.snowflakecomputing.com/

https://myorg-myconnection.snowflakecomputing.com/

accountname = <organization_name>-<connection_name>
username = <username>
password = <password>

accountname = myorg-myconnection
username = jsmith
password = mySecurePassword

con = snowflake.connector.connect (
      account = <organization_name>-<connection_name>
      user = <username>
      password = <password>
)

con = snowflake.connector.connect (
      account = myorg-myconnection
      user = jsmith
      password = mySecurePassword
)

jdbc:snowflake://<organization_name>-<connection_name>.snowflakecomputing.com/?user=<username>&password=<password>

jdbc:snowflake://myorg-myconnection.snowflakecomputing.com/?user=jsmith&password=mySecurePassword

[ODBC Data Sources]
<account_name> = SnowflakeDSIIDriver

[<dsn_name>]
Description     = SnowflakeDB
Driver          = SnowflakeDSIIDriver
Locale          = en-US
SERVER          = <organization_name>-<connection_name>.snowflakecomputing.com

[ODBC Data Sources]
myaccount = SnowflakeDSIIDriver

[client_redirect]
Description     = SnowflakeDB
Driver          = SnowflakeDSIIDriver
Locale          = en-US
SERVER          = myorg-myconnection.snowflakecomputing.com

var configuration = {
  username: '<username>',
  password: '<password>',
  account: <organization_name>-<connection_name>.
}

var connection = snowflake.createConnection(configuration)

var configuration = {
  username: 'jsmith',
  password: 'mySecurePassword',
  account: myorg-myconnection.
}

var connection = snowflake.createConnection(configuration)

cfg := &Config{
  Account: "<organization_name>-<connection_name>",
  User: "<username>",
  Password: "<password>"
}

dsn, err := DSN(cfg)

cfg := &Config{
  Account: "myorg-myconnection",
  User: "jsmith",
  Password: "mySecurePassword"
}

dsn, err := DSN(cfg)

connection_parameters = {
  "account": "<organization_name>-<connection_name>",
  "user": "<snowflake_user>",
  "password": "<snowflake_password>"
}

connection_parameters = {
  "account": "myorg-myconnection",
  "user": "jsmith",
  "password": "mySecurePassword"
}

# Properties file (a text file) for establishing a Snowpark session
URL = https://<organization_name>-<connection_name>.snowflakecomputing.com

# Properties file (a text file) for establishing a Snowpark session
URL = https://myorg-myconnection.snowflakecomputing.com

# Properties file (a text file) for establishing a Snowpark session
URL = https://<organization_name>-<connection_name>.snowflakecomputing.com

# Properties file (a text file) for establishing a Snowpark session
URL = https://myorg-myconnection.snowflakecomputing.com

Autenticação e redirecionamento do cliente¶

Os usuários devem ser provisionados na conta de origem e em cada conta de destino se as integrações de segurança não estiverem replicadas.

Redirecionamento de conexões do cliente¶

No caso de uma interrupção de serviço na região onde a conexão primária está localizada, redirecione a conexão do cliente para uma conta que armazena uma conexão secundária.

-- view all connections
SHOW CONNECTIONS;

+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
| snowflake_region   | created_on                    | account_name        | name              | comment         | is_primary    | primary                       | failover_allowed_to_accounts        | connection_url                            | organization_name | account_locator   |
|--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|
| AWS_US_WEST_2      | 2020-07-19 14:49:11.183 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
| AWS_US_EAST_1      | 2020-07-22 13:52:04.925 -0700 | MYORG.MYACCOUNT2    | MYCONNECTION      | NULL            | false         | MYORG.MYACCOUNT1.MYCONNECTION |                                     | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR2 |
+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+

-- promote the secondary connection to serve as the primary connection
ALTER CONNECTION myconnection PRIMARY;

-- verify that the former secondary connection was promoted successfully
SHOW CONNECTIONS;

+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
| snowflake_region   | created_on                    | account_name        | name              | comment         | is_primary    | primary                       | failover_allowed_to_accounts        | connection_url                            | organization_name | account_locator   |
|--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|
| AWS_US_WEST_2      | 2020-07-19 14:49:11.183 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | false         | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
| AWS_US_EAST_1      | 2020-07-22 13:52:04.925 -0700 | MYORG.MYACCOUNT2    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION |                                     | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR2 |
+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+

myaccount1.us-east-1.privatelink.snowflakecomputing.com.
ocsp.myaccount1.us-east-1.privatelink.snowflakecomputing.com.

SELECT CURRENT_REGION();

Modificação de uma conexão¶

Você pode editar as contas de destino de uma conexão depois de criá-la usando Snowsight ou SQL.

Descarte de uma conexão¶

Você pode descartar uma conexão usando Snowsight ou SQL.

Monitoramento do redirecionamento do cliente¶

Você pode monitorar conexões e uso do redirecionamento de cliente para contas em uma organização usando Snowsight ou SQL.

SHOW CONNECTIONS;

+--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
| snowflake_region   | created_on                    | account_name        | name              | comment         | is_primary    | primary                       | failover_allowed_to_accounts        | connection_url                            | organization_name | account_locator   |
|--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|
| AWS_US_WEST_2      | 2023-07-05 08:57:11.143 -0700 | MYORG.MYACCOUNT1    | MYCONNECTION      | NULL            | true          | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
| AWS_US_EAST_1      | 2023-07-08 09:15:11.143 -0700 | MYORG.MYACCOUNT2    | MYCONNECTION      | NULL            | false         | MYORG.MYACCOUNT1.MYCONNECTION | MYORG.MYACCOUNT2, MYORG.MYACCOUNT3  | myorg-myconnection.snowflakecomputing.com | MYORG             | MYACCOUNTLOCATOR1 |
|--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------|

SELECT event_timestamp, user_name, client_ip, reported_client_type, is_success, connection
  FROM TABLE(INFORMATION_SCHEMA.LOGIN_HISTORY(
    DATEADD('HOURS',-72,CURRENT_TIMESTAMP()),
    CURRENT_TIMESTAMP()))
  ORDER BY EVENT_TIMESTAMP;

Limitações atuais do redirecionamento do cliente¶

• As conexões de clientes usando um URL de conexão e integração OAuth exigem a reautenticação quando o URL de conexão é atualizado para apontar para uma conta diferente se a integração de segurança OAuth não for replicada para aquela conta. Para obter mais informações, consulte Comportamento de redirecionamento do OAuth.

• Os navegadores podem levar vários minutos para serem redirecionados devido ao cache do navegador.

  Se você precisar verificar se o redirecionamento funciona, você pode se conectar ao Snowflake com um cliente diferente.

  Como alternativa, abra uma nova janela privada do navegador (por exemplo, modo incógnito no Google Chrome) para evitar problemas de cache do navegador. Observe que alguns navegadores em modo privado ou incógnito ainda podem armazenar dados. Para evitar o uso do cache do navegador, feche quaisquer janelas e abas dos navegadores privados abertos antes de abrir uma nova janela de navegador privado.

• Você só pode adicionar uma conta de destino usando Snowsight. Para adicionar mais de uma conta de destino à lista de contas de failover permitidas, use o comando ALTER CONNECTION … ENABLE FAILOVER TO ACCOUNTS.