ALTER CONNECTION

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

将连接的所有权转让给新主体、重命名连接或更改连接选项。

若要对连接设置注释,请使用 COMMENT ON CONNECTION

语法

ALTER CONNECTION connection_name
 { [ SET ] OWNER TO principal |
   RENAME TO new_connection_name |
   OPTIONS ( option value [, ...] )

参数

  • connection_name

    要更改的连接的名称。

  • [ SET ] OWNER TO principal

    将连接的所有权转让给 principal

  • RENAME TO new_connection_name

    为连接指定一个新名称。 该名称在 Unity Catalog 元存储中必须唯一。

  • OPTIONS

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

    将现有选项列表替换为新的选项列表。

    • option

      属性键。 该键可以由一个或多个以点分隔的标识符STRING 文本组成。

      属性键必须唯一,且区分大小写。

    • value

      属性的值。 值必须是 BOOLEANSTRINGINTEGERDECIMAL 常数表达式。

      例如, passwordvalue 可能使用常量表达式 secret('secrets.r.us', 'postgresPassword'),而不是输入文本密码。

示例

> ALTER CONNECTION mysql_connection SET OWNER TO `alf@melmak.et`;

> ALTER CONNECTION mysql_connection RENAME TO `other_mysql_connection`;

> ALTER CONNECTION mysql_connection OPTIONS (host 'newmysqlhost.cn-north-2.amazonaws.com', port '3306');