Redirecionamento de conexões do cliente¶

Exemplo¶

As seguintes instruções SQL passam pelo fluxo de trabalho de redirecionamento do cliente. Cada etapa é explicada em detalhes nas seções que se seguem neste tópico.

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

Pré-requisito¶

Para habilitar o recurso Client Redirect para suas contas, um administrador da organização (um usuário com a função ORGADMIN) deve habilitar a replicação para duas ou mais contas. Para permitir a replicação, consulte Pré-requisito: Habilitar a replicação para contas na organização para obter instruções detalhadas.

Criação de uma conexão primária¶

1. Crie uma nova conexão primária usando CREATE CONNECTION. O nome de cada conexão primária deve ser único em todos os nomes de conexão e conta na organização.

   O nome da conexão está incluído como parte da URL de conexão usada para conectar a contas Snowflake.

   Por exemplo, para criar uma conexão chamada myconnection:

   CREATE CONNECTION myconnection;
   

   Copy

2. Modifique esta conexão primária usando uma instrução ALTER CONNECTION … ENABLE FAILOVER TO ACCOUNTS. Forneça uma lista de contas separadas por vírgula em sua organização que possam armazenar uma opção de failover para esta conexão (ou seja, uma conexão secundária).

   Qualquer conta que armazene uma conexão secundária deve ser hospedada em uma região diferente da conta que armazena a conexão primária. O Redirecionamento do cliente só opera com sucesso em diferentes regiões. Por exemplo, se você tentar redirecionar as conexões do cliente de account1 para account2 na mesma região, o redirecionamento do cliente não funciona.

   Para ver a lista completa das contas em sua organização que estão habilitadas para replicação, execute SHOW REPLICATION ACCOUNTS.

   Por exemplo, permita que cada uma das contas myaccount2 e myaccount3 na organização myorg armazenem uma conexão secundária para a conexão myconnection:

   ALTER CONNECTION myconnection ENABLE FAILOVER TO ACCOUNTS myorg.myaccount2, myorg.myaccount3;
   

   Copy

3. Execute o comando SHOW CONNECTIONS para visualizar os detalhes da conexão.

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

   Copy

Criação de uma conexão secundária¶

Crie uma conexão secundária em uma ou mais contas, vinculada a uma conexão primária usando CREATE CONNECTION … AS REPLICA OF. Note que você só pode criar uma conexão secundária em uma conta especificada na instrução ALTER CONNECTION … ENABLE FAILOVER TO ACCOUNTS em Criação de uma conexão primária.

Execute uma instrução CREATE CONNECTION … AS REPLICA OF em cada conta de destino para criar uma réplica da conexão primária especificada.

Execute as instruções SQL desta seção na conta de destino onde você deseja criar uma conexão secundária.

1. Execute o comando SHOW CONNECTIONS para visualizar todas as conexões. Copie o valor da coluna primary para a conexão primária. Você usará este valor ao criar a conexão secundária na próxima etapa.

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

   Copy

2. Execute o comando CREATE CONNECTION … AS REPLICA OF para criar uma conexão secundária.

   Por exemplo, crie uma conexão secundária chamada myconnection que está vinculada à conexão primária myorg.myaccount1.myconnection. Após AS REPLICA OF, cole o nome totalmente qualificado da conexão primária (o nome que você copiou da saída SHOW CONNECTIONS na etapa anterior).

   CREATE CONNECTION myconnection
     AS REPLICA OF MYORG.MYACCOUNT1.MYCONNECTION;
   

   Copy

3. Execute o comando SHOW CONNECTIONS para verificar se a conexão secundária foi criada.

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

   Copy

Concessão do privilégio FAILOVER a uma função — Opcional¶

Um administrador de conta (um usuário com a função ACCOUNTADMIN) pode conceder o privilégio FAILOVER em um objeto de conexão a uma função de conta. Isso permite que um usuário que não seja o administrador da conta promova uma conexão secundária para servir como conexão primária.

Por exemplo, para conceder à função my_failover_role a capacidade de realizar failover na conexão myconnection, execute a seguinte instrução na conta de destino:

GRANT FAILOVER ON CONNECTION myconnection TO ROLE my_failover_role;

Um usuário com a função my_failover_role agora pode promover a conexão secundária myconnection para servir como conexão primária em caso de failover:

USE ROLE my_failover_role;

ALTER CONNECTION myconnection PRIMARY;

Para obter mais informações sobre como redirecionar conexões de clientes, consulte Redirecionamento de conexões do cliente.

Clientes Snowflake com suporte¶

O Redirecionamento do cliente tem suporte por Snowsight e Console clássico do Snowflake. Além disso, as seguintes versões de clientes Snowflake (e superiores) suportam o Redirecionamento do cliente:

Configuração de clientes Snowflake¶

Use o seguinte nome de host para a URL de conexão quando se conectar ao Snowflake:

Nome do host: organization_name-connection_name.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.

<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 federada e SSO¶

Configure a autenticação federada separadamente em cada conta de destino. Forneça os detalhes do provedor de identidade (IdP) usando as opções de configuração em Configuração do Snowflake para usar a autenticação federada:

OAuth¶

Configure um objeto de integração de segurança para OAuth em cada conta de destino. O objeto de integração de segurança deve ser idêntico ao mesmo objeto na conta de origem. Para instruções, consulte o tópico apropriado:

• OAuth Snowflake

• OAuth externo

Para recuperar as propriedades de integração de segurança, consulte o comando DESCRIBE INTEGRATION para cada integração de segurança na conta de origem. Em seguida, recrie cada integração de segurança em uma conta de destino executando o comando CREATE INTEGRATION.

Promoção de uma conexão secundária para servir como conexão primária¶

Iniciar o redirecionamento envolve a promoção de uma conexão secundária em uma região disponível para servir como conexão primária usando ALTER CONNECTION. Ao mesmo tempo, a conexão primária anterior torna-se uma conexão secundária.

Execute as instruções SQL desta seção na conta de destino que contém a conexão secundária atual que você está promovendo.

Exemplo:

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

Modificação das configurações DNS para conectividade privada com o serviço Snowflake¶

Para redirecionar as conexões do cliente para uma conta secundária, seu administrador de rede deve modificar a configuração DNS criada em Configuração das definições de DNS para conectividade privada com o serviço do Snowflake.

Usando uma ferramenta fornecida por seu provedor de DNS, modifique a configuração DNS para a URL de conexão.

Defina o nome do host de destino como a URL completa da conta Snowflake para a conta que armazena sua nova conexão primária, incluindo os segmentos adicionais que identificam a região e a plataforma de nuvem onde sua conta está hospedada e o suporte para AWS PrivateLink, Azure Private Link ou Google Cloud Private Service Connect. Este é o nome da conta para onde as conexões do cliente com a URL de conexão serão agora redirecionadas. Certifique-se de incluir a URL OCSP de conectividade privada ao atualizar as configurações de DNS.

Por exemplo:

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

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

Verificar se a URL de conexão está atualizada¶

Para verificar se a URL de conexão foi atualizada, você pode confirmar a região de sua conexão atual. Use a URL de conexão para se conectar ao Snowflake e execute a função CURRENT_REGION.

select current_region();