CREATE CONNECTION¶

Cria uma nova conexão na conta. Para obter mais detalhes, consulte Redirecionamento de conexões do cliente.

Consulte também:: ALTER CONNECTION , DROP CONNECTION , SHOW CONNECTIONS

Sintaxe¶

Conexão primária

CREATE CONNECTION [ IF NOT EXISTS ] <name>
  [ COMMENT = '<string_literal>' ]

Conexão secundária

CREATE CONNECTION [ IF NOT EXISTS ] <name>
  AS REPLICA OF <organization_name>.<account_name>.<name>
  [ COMMENT = '<string_literal>' ]

Parâmetros obrigatórios¶

name

Cadeia de caracteres que especifica o identificador (ou seja, nome) da conexão. O identificador deve começar com um caractere alfabético e só pode conter letras, dígitos decimais (0-9) e sublinhados (_).

O nome de cada conexão primária deve ser único entre os nomes das conexões e os nomes das contas na organização.

O nome de cada conexão secundária deve corresponder ao nome de sua conexão primária.

Parâmetros de conexão secundária¶

AS REPLICA OF organization_name.account_name.name

Especifica o identificador para uma conexão primária a partir da qual se cria uma réplica (ou seja, uma conexão secundária).

organization_name: Especifica o identificador da organização.
account_name: Especifica o identificador da conta.
name: Especifica o identificador da conexão primário.

Parâmetros opcionais¶

COMMENT = 'string_literal'

Especifica um comentário para a conexão.

Padrão: sem valor

Requisitos de controle de acesso¶

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

Notas de uso¶

Se Conectividade privada com o serviço Snowflake estiver habilitado para sua conta Snowflake, seu gerente de rede deverá criar e gerenciar um registro DNS CNAME. Para obter mais detalhes, consulte Configuração do registro DNS CNAME 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¶

Criar uma conexão para a conta myaccount1 na organização myorg:

CREATE CONNECTION IF NOT EXISTS myconnection;

Criar uma conexão secundária como uma réplica de sua conexão primária. A coluna primary na saída de SHOW CONNECTIONS exibe a conexão primária:

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