Udostępnij za pośrednictwem

CREATE CONNECTION

  • Artykuł

Dotyczy:oznaczone jako Databricks SQL oznaczone jako Databricks Runtime 13.3 LTS i nowsze oznaczone jako tylko Unity Catalog

Ważne

Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

To polecenie tworzy połączenie obce (lub serwer), które reprezentuje zdalny system danych określonego typu, przy użyciu opcji specyficznych dla systemu, które zapewniają lokalizację systemu zdalnego i szczegóły uwierzytelniania.

Zewnętrzne połączenia umożliwiają zapytania federacyjne .

Składnia

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

W przypadku zgodności ze standardami SERVERmożna również użyć funkcji CONNECTION zamiast .

Parametry

  • connection_name

    Unikatowy identyfikator połączenia na poziomie metastore wykazu Unity Catalog.

  • connection_type

    Określa typ połączenia i musi być jednym z następujących elementów:

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

  • OPTIONS

    Ustawia konkretne parametry connection_type potrzebne do nawiązania połączenia.

    • opcja

      Klucz właściwości. Klucz może składać się z co najmniej jednego identyfikatora oddzielonego kropką lub literałem STRING .

      Klucze właściwości muszą być unikatowe i uwzględniane są wielkość liter.

    • wartość

      Wartość właściwości . Wartość musi być wyrażeniem BOOLEANstałym , STRING, INTEGERlub DECIMAL . Wartość może być również wywołaniem SECRET funkcji SQL. Na przykład element value for password może składać się secret('secrets.r.us', 'postgresPassword') w przeciwieństwie do wprowadzania hasła literału.

Przykład

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