ALTER CATALOG

2025-07-02

適用対象: 「はい」チェックマークがオン Databricks SQL Databricks Runtime 10.4 LTS 以降 Unity Catalog のみ

カタログの所有権を新しいプリンシパルに転送するか、カタログにタグを適用するか、カタログの予測最適化を有効または無効にします。

構文

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
   OPTIONS (option value [, ...] )}

パラメーター

catalog_name

変更するカタログの名前。名前を指定しない場合、既定値は hive_metastore です。
[ SET ] OWNER TO principal

カタログの所有権を principal に移します。

適用対象: Databricks SQL Databricks Runtime 11.3 LTS 以降

SET は省略可能なキーワードとして使用できます。
SET TAGS ( { tag_name = tag_value } [, …] )

カタログにタグを適用します。カタログにタグを適用するには、USE CATALOG アクセス許可が必要です。 USE CATALOGを参照してください。

適用対象: Databricks SQL Databricks Runtime 13.3 LTS 以降
タグを解除 (タグ名 [, …])

カタログからタグを削除します。カタログにタグを適用するには、USE CATALOG アクセス許可が必要です。

適用対象: Databricks SQL Databricks Runtime 13.3 LTS 以降
tag_name

リテラル STRING です。 tag_name は、カタログ内で一意である必要があります。
tag_value

リテラル STRING です。
{ ENABLE |DISABLE |INHERIT } 予測最適化

適用対象: Databricks SQL Databricks Runtime 12.2 LTS 以降

カタログを目的の予測最適化設定に変更します。既定では、カタログが作成されたときの動作は、アカウントから INHERIT です。既定では、カタログに作成された新しいオブジェクトは、カタログから設定を継承します。

カタログが変更された場合、その動作はすべてのスキーマとそのオブジェクトに連鎖し、予測最適化が継承されます。予測最適化を継承しないスキーマ内のオブジェクト、または予測最適化の ENABLE または DISABLE を明示的に実行するオブジェクトは、カタログの設定の影響を受けません。

カタログの予測最適化を設定するには、カタログに対する CREATE のアクセス許可が必要です。

Unity Catalog の Delta Sharing 以外のマネージドカタログのみが予測最適化の対象となります。
オプション

カタログ固有のパラメーターを設定します。既存のオプションのリストを新しいオプションのリストに置き換えます。

OPTIONSを使用して、Hive メタストアフェデレーションを使用して作成された外部カタログのauthorized pathsを設定します。
- 方法
  
  プロパティキー。キーは、ドットで区切られた 1 つまたは複数の識別子、あるいは STRING リテラルで構成できます。
  
  プロパティキーは一意である必要があり、大文字と小文字が区別されます。
- 価値
  
  プロパティの値。値は、BOOLEAN、STRING、INTEGER、または DECIMAL 定数式にする必要があります。
  
  たとえば、password の value は、リテラルパスワードを入力するのではなく、定数式 secret('secrets.r.us', 'postgresPassword') を使用することがあります。

例

-- Creates a catalog named `some_cat`.
> CREATE CATALOG some_cat;

-- Transfer ownership of the catalog to another user
> ALTER CATALOG some_cat OWNER TO `alf@melmak.et`;

-- Applies three tags to the catalog named `test`.
> ALTER CATALOG test SET TAGS ('tag1' = 'val1', 'tag2' = 'val2', 'tag3' = 'val3');

-- Removes three tags from the catalog named `test`.
> ALTER CATALOG test UNSET TAGS ('tag1', 'tag2', 'tag3');

-- Adds an authorized path to a foreign catalog created using :re[HMS] federation.
> ALTER CATALOG my_federated_catalog OPTIONS (authorized_paths 'path/to/dir1, path/to/dir2');

–– Enables predictive optimization for catalog main
> ALTER CATALOG main ENABLE PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                        value
  ------------------------    ---------
  < other rows of describe extended >
  Predictive Optimization    ENABLE

-- Sets catalog main to inherit setting from parent object (metastore)
> ALTER CATALOG main INHERIT PREDICTIVE OPTIMIZATION;
> DESCRIBE CATALOG EXTENDED main;
  Key                         value
  ------------------------    ----------------------------------------
  < other rows of describe extended >
  Predictive Optimization     ENABLE (inherited from METASTORE metastore_name)

次の方法で共有

ALTER CATALOG

構文

パラメーター

例

関連記事

フィードバック

その他のリソース