适用于: 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 [, ...] )}
-
要更改的目录的名称。 如果未提供名称,则默认值为
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
一个文本
STRING
。tag_name
在目录中必须唯一。tag_value
一个文本
STRING
。{ 启用 | 禁用 | 继承 } 预测优化
适用于:
Databricks SQL
Databricks Runtime 12.2 LTS 及更高版本
将目录更改为所需的预测优化设置。 默认情况下,创建目录时,行为是从帐户
INHERIT
。 默认情况下,在目录中创建的新对象将从目录继承设置。如果更改了目录,则行为将级联到所有架构及其对象,这些内容会继承预测优化。 如果架构中的对象不继承预测优化或显式
ENABLE
或DISABLE
预测优化的对象,则这些对象不受目标设置影响。若要为目录设置预测优化,用户必须对目录具有
CREATE
权限。Unity Catalog 中只有非增量共享托管目录才有资格进行预测优化。
选项
设置特定于目录的参数。 将现有选项列表替换为新的选项列表。
使用
OPTIONS
为使用 Hive 元存储联合创建的外部目录设置authorized paths
。选项
属性键。 该键可以由一个或多个以点分隔的标识符或
STRING
文本组成。属性键必须唯一,且区分大小写。
价值
属性的值。 值必须是
BOOLEAN
、STRING
、INTEGER
或DECIMAL
常数表达式。例如,
value
的password
可能使用常数表达式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)