CREATE CONNECTION

  • Articolo

Si applica a:segno di spunta sì Solo databricks SQL segno di spunta sì Databricks Runtime 13.3 LTS e versioni successive segno di spunta sì al catalogo Unity

Importante

Questa funzionalità è disponibile in anteprima pubblica.

Questo comando crea una connessione esterna (o un server), che rappresenta un sistema dati remoto di un tipo specifico, usando opzioni specifiche del sistema che forniscono il percorso del sistema remoto e i dettagli di autenticazione.

Le connessioni esterne consentono query federate.

Sintassi

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

Per la conformità agli standard è anche possibile usare SERVER anziché CONNECTION.

Parametri

  • connection_name

    Identificatore univoco della connessione a livello di metastore del catalogo Unity.

  • connection_type

    Identifica il tipo di connessione e deve essere uno dei seguenti:

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

  • OPTIONS

    Imposta connection_type parametri specifici necessari per stabilire la connessione.

    • opzione

      Chiave della proprietà. La chiave può essere costituita da uno o più identificatori separati da un punto o da un STRING valore letterale.

      Le chiavi delle proprietà devono essere univoche e fanno distinzione tra maiuscole e minuscole.

    • value

      Il valore per la proprietà. Il valore deve essere un'espressione BOOLEANcostante , STRINGINTEGER, o DECIMAL . Il valore può anche essere una chiamata alla SECRET funzione SQL. Ad esempio, l'oggetto value for password può includere secret('secrets.r.us', 'postgresPassword') anziché immettere la password letterale.

Esempio

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