ALTER CONNECTION¶

Sintaxe¶

ALTER CONNECTION <name> ENABLE FAILOVER TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ]
                        [ IGNORE EDITION CHECK ]

ALTER CONNECTION <name> DISABLE FAILOVER [ TO ACCOUNTS <organization_name>.<account_name> [ , <organization_name>.<account_name> ... ] ]

ALTER CONNECTION <name> PRIMARY

ALTER CONNECTION [ IF EXISTS ] <name> SET COMMENT = '<string_literal>'

ALTER CONNECTION [ IF EXISTS ] <name> UNSET COMMENT

Parâmetros¶

name

Identificador da conexão a ser alterada.

ENABLE FAILOVER TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ]

Especifica uma lista de contas separadas por vírgula em sua organização onde uma conexão secundária para esta conexão primária pode ser promovida para servir como a conexão primária. Inclua o nome de sua organização para cada conta na lista.

Cada conta da lista deve estar localizada em uma região diferente da conta com a conexão primária. Caso contrário, o comando falhará.

DISABLE FAILOVER [ TO ACCOUNTS organization_name.account_name [ , organization_name.account_name ... ] ]

Desativa o failover para esta conexão primária, o que significa que nenhuma conexão secundária para esta conexão primária pode ser promovida para servir como conexão primária.

Para desativar o failover para contas selecionadas (em vez de todas as contas), especifique uma lista delimitada por vírgulas dessas contas.

PRIMARY

Promover a conexão para servir como conexão primária.

SET ...

Especifica as propriedades a serem definidas para a conexão:

COMMENT = 'string'

Adiciona um comentário ou substitui um comentário existente para a conexão.

UNSET ...

Especifica as propriedades a serem desmarcadas para a conexão, o que as restabelece aos padrões.

Atualmente, a única propriedade que você pode desmarcar é COMMENT, o que remove o comentário, se existir, para a conexão.

Notas de uso¶

• Somente administradores de conta (usuários com a função ACCOUNTADMIN) podem executar este comando SQL.

• Se a conectividade privada ao serviço Snowflake estiver ativado para sua conta Snowflake, seu administrador de rede deve atualizar o registro DNS CNAME para seu URL de conexão quando uma conexão for promovida para servir como conexão primária. Para obter mais informações, consulte Configuração das definições de DNS para conectividade privada com o serviço do Snowflake.

• Em relação aos metadados:

  Atenção

  Os clientes devem garantir que nenhum dado pessoal (exceto para um objeto do usuário), dados sensíveis, dados controlados por exportação ou outros dados regulamentados sejam inseridos como metadados ao usar o serviço Snowflake. Para obter mais informações, consulte Campos de metadados no Snowflake.

Exemplos¶

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

Adicionar um comentário para uma conexão:

ALTER CONNECTION myconnection SET COMMENT = 'New comment for connection';

Promover uma conexão secundária à conexão primária:

ALTER CONNECTION myconnection PRIMARY;