Compartir a través de

CREATE CONNECTION

  • Artículo

Se aplica a: casilla marcada como sí Databricks SQL casilla marcada como Sí Databricks Runtime 13.3 LTS y versiones posteriores casilla marcada como Sí solo a Unity Catalog

Importante

Esta característica está en versión preliminar pública.

Este comando crea una conexión externa (o servidor), que representa un sistema de datos remoto de un tipo específico, utilizando opciones específicas del sistema que proporcionan la ubicación del sistema remoto y los detalles de autenticación.

Las conexiones externas habilitan las consultas federadas.

Sintaxis

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

Para el cumplimiento de estándares, también puede usar SERVER en lugar de CONNECTION.

Parámetros

  • connection_name

    Identificador único de la conexión en el nivel de metastore del catálogo de Unity.

  • connection_type

    Identifica el tipo de conexión y debe ser uno de los siguientes:

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

  • OPTIONS

    Establece connection_type los parámetros específicos necesarios para establecer la conexión.

    • option

      Clave de propiedad. La clave puede constar de uno o más identificadores separados por un punto o un literal de STRING.

      Las claves de propiedad deben ser únicas y distinguen mayúsculas de minúsculas.

    • value

      El valor de la propiedad. El valor debe ser una expresión constante BOOLEAN, STRING, INTEGER o DECIMAL. El valor también puede ser una llamada a la función SQL SECRET. Por ejemplo, el value para password puede incluir secret('secrets.r.us', 'postgresPassword') en lugar de escribir la contraseña literal.

Ejemplo

-- 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'));