ALTER CATALOG

  • Статья

Область применения:флажок Databricks SQL флажок Databricks Runtime 10.4 LTS и более поздней флажок версии каталога Unity

Передает владение каталогом новому субъекту, применяет теги к каталогу или включает или отключает прогнозную оптимизацию для каталога.

Синтаксис

ALTER CATALOG [ catalog_name ]
 { [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) } |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION }

Параметры

  • catalog_name

    Имя каталога, который нужно изменить. Если имя не указано, по умолчанию используется значение hive_metastore.

  • [ SET ] OWNER TO субъект

    Передает владение каталогом субъекту 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.

  • { ENABLE | DISABLE | НАСЛЕДОВАНИЕ } ПРОГНОЗНАЯ ОПТИМИЗАЦИЯ

    Область применения: флажок Databricks SQL флажок Databricks Runtime 12.2 LTS и выше

    Изменяет каталог на нужный параметр прогнозной оптимизации. По умолчанию при создании каталогов поведение выполняется INHERIT из учетной записи. По умолчанию новые объекты, созданные в каталоге, наследуют параметр из каталога.

    Если каталог изменен, поведение будет каскадно для всех схем и их объектов, которые наследуют прогнозную оптимизацию. Объекты в схемах, которые не наследуют прогнозную оптимизацию или объекты, которые явно ENABLE или DISABLE прогнозной оптимизации не влияют на параметр каталога.

    Чтобы задать прогнозную оптимизацию для каталога, пользователь должен иметь CREATE разрешение на каталог.

    Для прогнозной оптимизации можно использовать только управляемые каталоги в каталоге Unity.

Примеры

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