CREATE CONNECTION

Cria uma nova conexão na conta.

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

Crie uma conexão. Para este exemplo, suponha que você esteja conectado à 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. Substitua seus próprios valores de conta e organização no nome totalmente qualificado usado no parâmetro. Você pode obter o valor totalmente qualificado a ser usado na coluna primary na saída de SHOW CONNECTIONS.

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