ALTER CATALOG

  • 發行項

適用於：檢查標示為是Databricks SQL 檢查標示為是 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 ]OWNER TO 主體

    將目錄的擁有權轉移至 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 目錄中只有非差異共用的受控目錄才有資格進行預測優化。

範例

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