ALTER EXTERNAL LOCATION

  • [アーティクル]

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

外部の場所のプロパティを変更するか、場所の名前を変更します。

構文

ALTER EXTERNAL LOCATION location_name
   { RENAME TO to_location_name |
     SET URL url_str [ FORCE ] |
     SET STORAGE CREDENTIAL credential_name |
     [ SET ] OWNER TO principal }

ハイフン (-) などの特殊文字を含むオブジェクト名は、バッククォート (` `) で囲む必要があります。 アンダースコア (_) を含むオブジェクト名にはバッククォートは必要ありません。 「名前」と「例」を参照してください。

パラメーター

  • location_name

    変更する外部の場所を識別します。

  • RENAME TO to_location_name

    場所の名前を変更します。 名前は、メタストア内のすべての場所で一意にする必要があります。

  • SET URL url_str [ FORCE ]

    url_str は、絶対 URL として記述されたクラウド ストレージの場所を持つ STRING リテラルである必要があります。

    FORCE を指定しない限り、場所が現在使用されている場合、ステートメントは失敗します。

  • SET STORAGE CREDENTIAL credential_name

    この場所へのアクセスに使用される名前付き資格情報を更新します。 資格情報が存在しない場合、Databricks SQL でエラーが発生します。

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

    ストレージの場所の所有権を principal に転送します。

    適用対象:check marked yes Databricks SQL 「はい」のチェックマーク Databricks Runtime 11.3 LTS 以降

    SET は省略可能なキーワードとして使用できます。

例

次の例では、ハイフン (-) などの特殊文字を含まない場所の名前を使用します。 特殊文字を含むオブジェクト名は、バッククォート (` `) で囲む必要があります。 「名前」を参照してください。

-- Rename a location
> ALTER EXTERNAL LOCATION descend_loc RENAME TO decent_loc;

-- Redirect the URL associated with the location
> ALTER EXTERNAL LOCATION best_loc SET URL 'abfss://container@storageaccount.dfs.core.windows.net/best_location' FORCE;

-- Change the credentials used to access the location
> ALTER EXTERNAL LOCATION best_loc SET STORAGE CREDENTIAL street_cred;

-- Change ownership of the external location
> ALTER EXTERNAL LOCATION best_loc OWNER TO `alf@melmak.et`