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 [, ...] )
パラメーター
-
変更する接続の名前。
[ 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');