CREATE CONNECTION

  • 项目

适用于：勾选“是” Databricks SQL 勾选“是” Databricks Runtime 13.3 LTS 及更高版本 勾选“是” 仅 Unity Catalog

重要

此功能目前以公共预览版提供。

此命令使用提供远程系统位置和身份验证详细信息的系统特定选项创建一个外部连接（或服务器），它代表特定类型的远程数据系统。

外部连接启用联合查询。

语法

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

为了符合标准，还可以使用 SERVER 而不是 CONNECTION。

参数

  • connection_name

    Unity Catalog 元存储级别的连接的唯一标识符。

  • connection_type

    标识连接的类型，并且必须是以下类型之一：

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

  • OPTIONS

    设置建立连接所需的 connection_type 特定参数。

    • option

      属性键。 该键可以由一个或多个以点分隔的标识符或 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'));