共用方式為

ALTER CATALOG

  • 發行項

適用於：檢查標示為 yes Databricks SQL 檢查標示為 yes Databricks Runtime 10.4 LTS 和更新版本，檢查標示為 [是 Unity 目錄]

將目錄的擁有權轉移至新的 主體、將標籤套用至目錄，或啟用或停用目錄 預測優化。

語法

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 ] 擁有者至 主要

    將目錄的擁有權轉移至 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 和更新版本

  • UNSET TAGS （tag_name [， ...] ）

    從目錄中移除標籤。 您必須擁有 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 的受控目錄才有資格進行預測優化。

範例

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