次の方法で共有

ALTER CATALOG

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

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

構文

ALTER CATALOG [ catalog_name ]
 { DEFAULT COLLATION default_collation_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 です。

  • デフォルトの照合順序 default_collation_name

    適用対象:はい Databricks SQL チェックが Databricks Runtime 17.1 以降" とマークされているチェック

    カタログ内で定義されている新しいスキーマの既定の照合順序を変更します。 カタログ内の既存のスキーマとオブジェクトの既定の照合順序は変更されません。

  • [ SET ] 所有者を主要

    カタログの所有権を 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定数式でなければなりません。

      たとえば、valueのpasswordでは、リテラル パスワードを入力するのではなく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');

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

-- 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)
  • Last updated on