ALTER CATALOG

适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime 10.4 LTS 及更高版本 勾选“是” 仅 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 }

parameters

  • catalog_name

    要更改的目录的名称。 如果未提供名称,则默认值为 hive_metastore

  • [ SET ] OWNER TO principal

    将目录的所有权转移给 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

    一个文本 STRINGtag_name 在目录中必须唯一。

  • tag_value

    文本 STRING

  • { 启用 | 禁用 | 继承 } 预测优化

    适用于:勾选“是” Databricks SQL 勾选“是” Databricks Runtime 12.2 LTS 及更高版本

    重要

    此功能目前以公共预览版提供。

    将目录更改为所需的预测优化设置。 默认情况下,创建目录时,行为是从帐户 INHERIT。 默认情况下,在目录中创建的新对象将从目录继承设置。

    如果更改了目录,则行为将级联到所有架构及其对象,这些内容会继承预测优化。 如果架构中的对象不继承预测优化或显式 ENABLEDISABLE 预测优化的对象,则这些对象不受目标设置影响。

    若要为目录设置预测优化,用户必须对目录具有 CREATE 权限。

    Unity Catalog 中只有非增量共享托管目录才有资格进行预测优化。

示例

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