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
-
要更改的目录的名称。 如果未提供名称,则默认值为
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
一个文本
STRING
。tag_name
在目录中必须唯一。tag_value
文本
STRING
。{ 启用 | 禁用 | 继承 } 预测优化
适用于: Databricks SQL Databricks Runtime 12.2 LTS 及更高版本
将目录更改为所需的预测优化设置。 默认情况下,创建目录时,行为是从帐户
INHERIT
。 默认情况下,在目录中创建的新对象将从目录继承设置。如果更改了目录,则行为将级联到所有架构及其对象,这些内容会继承预测优化。 如果架构中的对象不继承预测优化或显式
ENABLE
或DISABLE
预测优化的对象,则这些对象不受目标设置影响。若要为目录设置预测优化,用户必须对目录具有
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)