共用方式為

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 |
   OPTIONS (option value [, ...] )}

參數

  • 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 和更新版本

  • 取消標籤（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 的受控目錄才有資格進行預測優化。

  • 選項

    設定目錄特定的參數。 以新的選項清單取代現有的選項清單。

    使用 OPTIONS 來設定使用 Hive metastore 聯合所建立的外部資料目錄的 authorized paths。

    • 選項

      屬性鍵 該鍵可以包含一或多個以點分隔的識別碼，或是 STRING 常值。

      屬性索引鍵必須是唯一的，而且區分大小寫。

    • 值

      屬性的值。 該值必須是 BOOLEAN、STRING、INTEGER 或 DECIMAL 常數運算式。

      例如，valuepassword 可能會使用常數表示式 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)