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;

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¶

Você pode criar uma conexão primária na conta de origem usando Snowsight ou SQL.

Criação de uma conexão secundária em cada conta de destino¶

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

1. Faça login na conta de destino em uma região disponível com a conexão secundária a ser promovida para servir como conexão primária.

2. Execute as instruções SQL nesta seção.

   • Visualize todas as conexões na conta:

     SHOW CONNECTIONS;
     

     Copy

     A instrução retorna a seguinte saída:

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

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

     ALTER CONNECTION myconnection PRIMARY;
     

     Copy

   • Verifique se a conexão secundária anterior foi promovida com sucesso:

     SHOW CONNECTIONS;
     

     Copy

     A instrução retorna a seguinte saída:

     +--------------------+-------------------------------+---------------------+-------------------+-----------------+---------------+-------------------------------+-------------------------------------+-------------------------------------------+-------------------+-------------------+
     | 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 de 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 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.)

Confirmação da atualização da URL de conexão¶

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

Modificação das contas de destino para uma conexão usando Snowsight¶

Você pode modificar a conta de destino de uma conexão após criá-la, mas não pode alterar o nome da conexão.

1. Entre em Snowsight e navegue até Admin » Accounts.

2. Selecione Client Redirect.

3. Localize a conexão que você deseja editar. Selecione o menu More (…) na última coluna da linha.

Modificação das contas de destino para uma conexão usando SQL¶

Você pode adicionar mais de uma conta de destino para uma conexão primária usando o comando ALTER CONNECTION. Para obter um exemplo, consulte Exemplos.

Descarte de uma conexão usando o Snowsight¶

Para excluir uma conexão, você deve fazer login como usuário com a função ACCOUNTADMIN na conta de origem com a conexão principal.

1. Entre em Snowsight e navegue até Admin » Accounts.

2. Selecione Client Redirect.

3. Localize a conexão que deseja excluir. Selecione o menu More (…) na última coluna da linha.

4. Selecione Drop e depois selecione Drop Connection.

Descarte de uma conexão usando SQL¶

Você pode usar o comando DROP CONNECTION para excluir uma conexão.

1. Exclua todas as conexões secundárias nas contas de destino.

2. Exclua a conexão primária na conta de origem.

Para obter um exemplo, consulte Exemplos.

Monitoramento do redirecionamento de cliente usando Snowsight¶

Para visualizar os detalhes da conexão do redirecionamento de cliente, conclua as etapas a seguir:

1. Entre em Snowsight e navegue até Admin » Accounts.

2. Selecione Replication e depois selecione Client Redirect.

3. Se não houver nenhum warehouse ativo para a sessão, você será solicitado a selecionar um warehouse.

Monitore uma conexão específica usando pesquisa e filtros.

• Você pode pesquisar pelo nome da conexão. Na caixa (pesquisa), insira o nome da conexão para filtrar os resultados.

• Escolha Redirecting para filtrar os resultados por conexão primária (To) ou secundária (From).

• Escolha o menu (contas) para filtrar os resultados por nome da conta.

Você pode revisar as seguintes informações sobre cada conexão:

Monitoramento do redirecionamento de cliente usando SQL¶

Você pode visualizar detalhes da conexão e monitorar o uso usando o comando SHOW CONNECTIONS e a função LOGIN_HISTORY.

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;