Поделиться через

ALTER CATALOG

  • Статья

применимо:отмечен Databricks SQL отмечен Databricks Runtime 10.4 LTS и выше отмечен Unity Catalog

Передает право собственности catalog новому лицу, назначает теги к catalogили включает или отключает прогнозную оптимизацию для 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

  • catalog_name

    Имя catalog для изменения. Если имя не указано, по умолчанию используется значение hive_metastore.

  • [ SET ] СОБСТВЕННИК ДЛЯ главный

    Передает права владения catalog на principal.

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

    SET разрешено в качестве необязательного ключевого слова.

  • теги SET ( { tag_name = tag_value } [, ...] )

    Примените теги к catalog. Для применения тега к catalogнеобходимо иметь разрешение use_catalog. См. USE CATALOG.

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

  • UNSET TAGS ( tag_name [, ...] )

    Remove теги из catalog. Для применения тега к catalogнеобходимо иметь разрешение use_catalog.

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

  • tag_name

    Литерал STRING. tag_name должен быть уникальным в catalog.

  • tag_value

    Литерал STRING.

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

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

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

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

    Для прогнозной оптимизации set для catalogпользователь должен иметь разрешение CREATE на catalog.

    Для предиктивной оптимизации подходят только управляемые данные, не связанные с Delta Sharing, в Unity catalogsCatalog.

Примеры

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