ALTER CONNECTION

適用対象:check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以上 Unity Catalog のみ

接続の所有権を新しいプリンシパルに転送するか、接続の名前を変更するか、接続オプションを変更します。

接続にコメントを設定するには、COMMENT ON CONNECTIONを使用します。

Important

接続オプションを変更する場合は、OPTIONS句にリテラル値を直接入力するのではなく、secret関数を使用してパスワードやトークンなどの資格情報を指定します。 これにより、ステートメントに資格情報の値を含めるのではなく、 Databricks シークレット サービス に格納されているシークレットを参照できます。

構文

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

パラメーター

  • 接続名

    変更する接続の名前。

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

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

  • new_connection_name に名前を変更する

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

  • OPTIONS

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

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

    • option

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

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

    • value

      プロパティの値。 値は、BOOLEAN、STRING、INTEGER、またはDECIMAL定数式でなければなりません。

      パスワードやトークンなど、資格情報を保持するオプションの場合は、値を直接入力する代わりに、 secret 関数を使用します。 たとえば、リテラル パスワードを入力するのではなく、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');
  • Last updated on