Freigeben über


CREATE CONNECTION

Gilt für: Häkchen ja Databricks SQL durch Häkchen mit „Ja“ markiert Databricks Runtime 13.3 LTS und höher durch Häkchen mit „Ja“ markiert Nur Unity Catalog

Wichtig

Dieses Feature befindet sich in der Public Preview.

Dieser Befehl erstellt eine Fremdverbindung (oder einen Server), die ein Remotedatensystem eines bestimmten Typs darstellt, wobei systemspezifische Optionen verwendet werden, die den Speicherort des Remotesystems und Authentifizierungsdetails angeben.

Fremdverbindungen ermöglichen Verbundabfragen.

Syntax

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

Zur Einhaltung von Standards können Sie auch SERVER anstelle von CONNECTION verwenden.

Parameter

  • connection_name

    Ein eindeutiger Bezeichner der Verbindung auf Unity Catalog-Metastoreebene.

  • connection_type

    Gibt den Typ der Verbindung an und muss einen der folgenden Typen aufweisen:

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

    Legt connection_type-spezifische Parameter fest, die zum Herstellen der Verbindung erforderlich sind.

    • Option

      Der Eigenschaftenschlüssel. Der Schlüssel kann aus einem oder mehreren Bezeichnern bestehen, die durch einen Punkt oder ein STRING-Literal getrennt sind.

      Eigenschaftenschlüssel müssen eindeutig sein, und die Groß-/Kleinschreibung muss beachtet werden.

    • value

      Der Wert für die Eigenschaft. Der Wert muss ein konstanter Ausdruck vom Typ BOOLEAN, STRING, INTEGER oder DECIMAL sein. Der Wert kann auch ein Aufruf der SQL-Funktion SECRET sein. Beispielsweise kann value für password anstelle der Eingabe des Literalkennworts secret('secrets.r.us', 'postgresPassword') enthalten.

Beispiel

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