Compartilhar via


CRIAR CONEXÃO

Aplica-se a: verificação marcada como sim SQL do Databricks verificação marcada como sim Databricks Runtime 13.3 LTS e superior marca de seleção positiva Somente Catálogo do Unity

Importante

Esse recurso está em uma versão prévia.

Esse comando cria uma conexão estrangeira (ou servidor), que representa um sistema de dados remoto de um tipo específico, usando opções específicas do sistema que fornecem o local do sistema remoto e detalhes de autenticação.

As conexões estrangeiras habilitam consultas federadas.

Sintaxe

CREATE CONNECTION [IF NOT EXISTS] connection_name
  TYPE connection_type
  OPTIONS ( option value [, ...] )
  [ COMMENT comment ]

Para conformidade com padrões, você também pode usar SERVER em vez de CONNECTION.

Parâmetros

  • connection_name

    Um identificador exclusivo da conexão no nível do metastore do Catálogo do Unity.

  • connection_type

    Identifica o tipo da conexão e deve ser um dos seguintes:

    • DATABRICKS
    • MYSQL
    • POSTGRESQL
    • REDSHIFT
    • SNOWFLAKE
    • SQLDW (Synapse)
    • SQLSERVER
  • OPTIONS

    Define parâmetros de connection_type específicos necessários para estabelecer a conexão.

    • option

      A chave da propriedade. A chave pode consistir de um ou mais identificadores separados por um ponto ou uma literal de STRING.

      As chaves de propriedade devem ser exclusivas e diferenciar maiúsculas de minúsculas.

    • value

      O valor para a propriedade. O valor deve ser uma expressão de constante BOOLEAN, STRING, INTEGER ou DECIMAL. O valor também pode ser uma chamada para a função SQL SECRET. Por exemplo, o value para a password pode ser composto de secret('secrets.r.us', 'postgresPassword') em vez de inserir a senha literal.

Exemplo

-- Create a postgresql connection
> CREATE CONNECTION postgresql_connection
    TYPE POSTGRESQL
    OPTIONS (
      host 'qf-postgresql-demo.xxxxxx.us-west-2.rds.amazonaws.com',
      port '5432',
      user 'postgresql_user',
      password 'password123');

-- Create a postgresql connection with secret scope
> CREATE CONNECTION postgresql_connection
    TYPE POSTGRESQL
    OPTIONS (
       host 'qf-postgresql-demo.xxxxxx.us-west-2.rds.amazonaws.com',
       port '5432',
       user secret('secrets.r.us', 'postgresUser'),
       password secret('secrets.r.us', 'postgresPassword'));