变更目录

适用于:勾选“是” 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 |
   OPTIONS (option value [, ...] )}

parameters

  • catalog_name

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

  • [ SET ] OWNER TO principal

    将目录的所有权转移给 principal

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

    允许使用 SET 作为可选关键字。

  • 设置标签 ( { 标签名 = 标签值 } [, …] )

    将标记应用于目录。 你需要有 USE CATALOG 权限将标记应用于目录。 请参阅 USE CATALOG

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

  • 取消设置标记 ( 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 中只有非增量共享托管目录才有资格进行预测优化。

  • 选项

    设置特定于目录的参数。 将现有选项列表替换为新的选项列表。

    使用 OPTIONS 为使用 Hive 元存储联合创建的外部目录设置 authorized paths

    • 选项

      属性键。 该键可以由一个或多个以点分隔的标识符STRING 文本组成。

      属性键必须唯一,且区分大小写。

    • 价值

      属性的值。 值必须是 BOOLEANSTRINGINTEGERDECIMAL 常数表达式。

      例如,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)