ALTER CONNECTION

  • [アーティクル]

適用対象:check marked yes 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 [, ...] )

パラメーター

  • 接続名

    変更する接続の名前。

  • [ SET ] OWNER TO プリンシパル

    接続の所有権を principal に移します。

  • RENAME TO new_connection_name

    接続の新しい名前を指定します。 名前は、Unity Catalog メタストア内で一意である必要があります。

  • OPTIONS

    接続の確立に必要な connection_type 固有のパラメーターを設定します。

    既存のオプションのリストを新しいオプションのリストに置き換えます。

    • option

      プロパティ キー。 キーは、ドットで区切られた 1 つまたは複数の識別子、あるいは STRING リテラルで構成できます。

      プロパティ キーは一意である必要があり、大文字と小文字が区別されます。

    • value

      プロパティの値。 値は、BOOLEAN、STRING、INTEGER、または DECIMAL 定数式である必要があります。

      たとえば、value の password は、リテラル パスワードを入力するのではなく、定数式 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');