ALTER CATALOG

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

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

Important

При установке параметров каталога, которые несут учетные данные, такие как пароль или маркер, чтобы обеспечить их безопасность, укажите значение, используя secret функцию, а не ввод литерального значения непосредственно в предложении OPTIONS . Это позволяет ссылать на секрет, хранящийся в секретной службе Databricks , а не включать значение учетных данных в инструкцию.

Синтаксис

ALTER CATALOG [ catalog_name ]
 { DEFAULT COLLATION default_collation_name |
   [ SET ] OWNER TO principal
   SET TAGS ( { tag_name = tag_value } [, ...] ) |
   UNSET TAGS ( tag_name [, ...] ) |
   { ENABLE | DISABLE | INHERIT } PREDICTIVE OPTIMIZATION |
   OPTIONS (option value [, ...] ) |
   SET MANAGED LOCATION location |
   [ SET ] RETAIN DROPPED TO number { HOUR | HOURS | DAY | DAYS | WEEK | WEEKS } }

Параметры

  • catalog_name

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

  • СОРТИРОВКА ПО УМОЛЧАНИЮ default_collation_name

    Применяется к:check помеченный да флажок Databricks SQL помечен да Databricks Runtime 17.1 и более поздних версий

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

  • [ 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 и выше

  • ОТКЛЮЧИТЬ ТЕГИ ( название_тега [, ...] )

    Удалите теги из каталога. Для применения тега к каталогу необходимо иметь разрешение 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, отличные от OpenSharing, имеют право на прогнозную оптимизацию.

  • ПАРАМЕТРЫ

    Задает параметры, относящиеся к каталогу. Заменяет существующий список параметров новым списком параметров.

    Используйте OPTIONS, чтобы задать authorized paths для внешних каталогов, созданных с помощью федерации хранилища метаданных Hive.

    • Параметр

      Ключ свойства. Ключ может состоять из одного или нескольких идентификаторов, разделенных точкой или STRING литералом.

      Ключи свойств должны быть уникальными и учитывают регистр символов.

    • значение

      Значение свойства. Значение должно быть выражением BOOLEAN, STRINGINTEGERили DECIMALконстантой.

  • SET Расположение УПРАВЛЯЕМОГО РАСПОЛОЖЕНИЯ

    Применяется к:check помечено да проверка Databricks SQL с отметкой yes Databricks Runtime 18.1 и выше отмечена только каталог Unity.

    Изменяет расположение управляемого хранилища для каталога. Новые управляемые таблицы и управляемые тома, созданные в каталоге, используют обновленное расположение. Databricks не перемещает существующие объекты.

    • расположение

      Путь к облачному хранилищу для нового управляемого расположения хранилища. Он должен содержаться во внешнем расположении.

  • [ SET ] СОХРАНИТЬ ОТБРОШЕННОЕ ЧИСЛО { ЧАС | ЧАСЫ | DAY | DAYS | НЕДЕЛЯ | НЕДЕЛИ }

    Применяется к:check помечено да Databricks Runtime 17.3 и выше , чтобы проверить только каталог Unity.

    Important

    Эта функция доступна в общедоступной предварительной версии.

    Задает период восстановления для удаленных управляемых таблиц в каталоге, период, в течение которого удаленные таблицы можно восстановить с помощью UNDROP TABLE команды. Значение по умолчанию — 7 дней. Значение должно составлять 0 часов (для отключения восстановления) или от 7 до 30 дней включительно.

    Установка периода восстановления в 0 означает, что удаленные таблицы недоступны для восстановления, UNDROP а файлы данных удаляются из облачного хранилища в течение 48 часов.

    Если период восстановления также задан в дочерней схеме, параметр уровня схемы имеет приоритет для таблиц в этой схеме. Этот параметр применяется только к таблицам, удаленным после настройки периода восстановления. После окончания периода восстановления файлы данных для управляемых таблиц удаляются из облачного хранилища в течение 48 часов.

    SET разрешено в качестве необязательного ключевого слова. Требуется MANAGE привилегия или владение в каталоге. См. также раздел "Удалить управляемую таблицу".

Примеры

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

-- Change the default collation of a catalog to case sensitive unicode
> ALTER CATALOG test DEFAULT COLLATION UNICODE_CS;

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

-- Change the managed storage location of a catalog
> ALTER CATALOG my_catalog SET MANAGED LOCATION 's3://my-bucket/managed/';

-- Set a 30-day recovery period for dropped managed tables in a catalog
> ALTER CATALOG my_catalog RETAIN DROPPED TO 30 DAYS;

-- Set the recovery period to 0 (tables are not recoverable after drop)
> ALTER CATALOG my_catalog SET RETAIN DROPPED TO 0 DAYS;
  • Last updated on