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>' ]
Copy

Conexão secundária

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

Parâmetros obrigatórios

name

Cadeia de caracteres que especifica o identificador (ou seja, nome) da conexão. Ele deve estar em conformidade com o seguinte:

  • Deve começar com um caractere alfabético e só pode conter letras, dígitos decimais (0-9) e sublinhados (_).

  • Para a conexão primária, o nome deve ser único entre os nomes das conexões e os nomes das contas na organização.

  • Para uma conexão secundária, o nome 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 a conectividade privada ao serviço Snowflake estiver habilitada para sua conta Snowflake, seu gerente de rede deverá criar e gerenciar um registro DNS CNAME. Para obter mais detalhes, 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

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

CREATE CONNECTION IF NOT EXISTS myconnection;
Copy

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;
Copy
Linguagem: Português