共用方式為

CREATE CONNECTION

  • 發行項

適用於：標示為是 Databricks SQL 標示為是 Databricks Runtime 13.3 LTS 和更新版本 標示為是 Unity Catalog 限定

重要

這項功能處於公開預覽狀態。

此命令會使用提供遠端系統和驗證詳細資料之位置的系統特定選項，建立外部連線（或伺服器），代表特定類型的遠端資料系統。

外部 啟用 同盟查詢。

語法

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

針對標準合規性，您也可以使用 SERVER 而非 CONNECTION。

Parameters

  • connection_name

    Unity Catalog 中繼存放區層級之連線的唯一 identifier。

  • connection_type

    識別連線的類型，而且必須是下列其中一項：

    • DATABRICKS
    • MYSQL
    • POSTGRESQL
    • REDSHIFT
    • SNOWFLAKE
    • SQLDW （Synapse）
    • SQLSERVER

  • OPTIONS

    設定 connection_type 以提供建立連線所需的特定 parameters。

    • 選項

      屬性索引鍵。 該鍵可以包含一或多個以點分隔的識別碼，或是 STRING 常值。

      屬性索引鍵必須是唯一的，而且區分大小寫。

    • value

      屬性的值。 該值必須是 BOOLEAN、STRING、INTEGER 或 DECIMAL 常數運算式。 此值也可能是 SECRET SQL 函式的呼叫。 例如，value 的 password 可能會包含 secret('secrets.r.us', 'postgresPassword')，無需輸入常值密碼。

範例

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