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 }
Параметры
-
Имя каталога, который необходимо изменить. Если имя не указано, по умолчанию используется значение
hive_metastore
. [ SET ] СОБСТВЕННИК ДЛЯ главный
Передает права владения каталогом на
principal
.Область применения:
Databricks SQL
Databricks Runtime 11.3 LTS и выше
SET
разрешено в качестве необязательного ключевого слова.теги SET ( { 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
.{ ENABLE | DISABLE | НАСЛЕДОВАНИЕ } ПРОГНОЗНАЯ ОПТИМИЗАЦИЯ
Область применения:
Databricks SQL
Databricks Runtime 12.2 LTS и выше
Изменяет каталог на нужный параметр прогнозной оптимизации. По умолчанию при создании каталогов поведение заключается в том, чтобы
INHERIT
из учетной записи. По умолчанию новые объекты, созданные в каталоге, наследуют параметр из каталога.Если каталог изменен, поведение будет каскадно для всех схем и их объектов, которые наследуют прогнозную оптимизацию. Объекты в схемах, которые не наследуют предсказательную оптимизацию, или объекты, которые явно отключают (
ENABLE
) или включают (DISABLE
) предсказательную оптимизацию, не затрагиваются настройками каталога.Чтобы задать прогнозную оптимизацию для каталога, пользователь должен иметь
CREATE
разрешение на каталог.Только управляемые каталоги в Unity Catalog, не использующие Delta Sharing, подходят для прогнозной оптимизации.
Примеры
-- 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)