CREATE CONNECTION¶

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. 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 (_).

• Não deve conter mais de 31 caracteres.

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