ALTER CATALOG

  • [アーティクル]

適用対象:「はい」のチェック マーク Databricks SQL Databricks Runtime 10.3 以上 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 }

パラメーター

  • catalog_name

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

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

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

    適用対象: Databricks SQL 「はい」のチェックマーク Databricks Runtime 11.2 以降

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

  • SET TAGS ( { tag_name = tag_value } [, …] )

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

    適用対象:check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以降

  • UNSET TAGS ( tag_name [, …] )

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

    適用対象:check marked yes Databricks SQL Databricks Runtime 13.3 LTS 以降

  • tag_name

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

  • tag_value

    リテラル STRING。

  • { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION

    適用対象: Databricks SQL 「はい」のチェック マーク Databricks Runtime 12.2 以上

    重要

    この機能はパブリック プレビュー段階にあります。

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

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

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

    予測最適化の対象となるのは、Unity Catalog 内の、Delta Sharing 以外のマネージド カタログのみです。

例

-- 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');

–– 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)