ALTER CONNECTION

  • 项目

适用于：check marked yesDatabricks SQLcheck marked yes Databricks Runtime 13.1 及更高版本check marked yes仅 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

      属性的值。 值必须是 BOOLEAN、STRING、INTEGER 或 DECIMAL 常数表达式。

      例如， password 的 value 可能使用常量表达式 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.us-west-2.amazonaws.com', port '3306');