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
。
参数
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.cn-north-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.cn-north-2.rds.amazonaws.com',
port '5432',
user secret('secrets.r.us', 'postgresUser'),
password secret('secrets.r.us', 'postgresPassword'));