maintenance expire-snapshots#

Запускает maintenance операцию expire-snapshots.

Синтаксис#

catalog maintenance expire-snapshots [--older-than=<olderThan>]
                                     [--retain-last=<retainLast>]
                                     ([--target-object-group=<objectGroupName>] | 
                                     [--target-catalog=<catalogName> 
                                     --target-namespace=<namespaceName>
                                     --target-object=<objectName>])

Опции#

--older-than Файлы старше скольки дней можно удалять. Значение по умолчанию: 5

--retain-last Сколько последних snapshot необходимо сохранить вне зависимости от значения параметра older-than. Значение по умолчанию: 1

--target-object-group Целевая группа объектов, над которой необходимо выполнить операцию. Параметр не может быть использован совместно с target-catalog, target-namespace и target-object.

--target-catalog Каталог, которому принадлежит целевой объект. Если параметр задан, вы также должны задать параметры target-namespace и target-object. Параметр не может быть использован совместно с target-object-group.

--target-namespace Namespace, которому принадлежит целевой объект. Если параметр задан, вы также должны задать параметры target-catalog и target-object. Параметр не может быть использован совместно с target-object-group.

--target-object Целевой объект, над которым необходимо выполнить операцию. Если параметр задан, вы также должны задать параметры target-catalog и target-namespace. Параметр не может быть использован совместно с target-object-group.

Права доступа#

Ниже приведен список требований для пользователя, выполняющего операцию.

Для каталога, которому принадлежит целевой объект или группа объектов:

быть владельцем каталога ИЛИ
иметь встроенную роль builtin.iceberg.admin ИЛИ
иметь встроенную роль builtin.admin

Для файловой системы, с которой работает каталог:

быть владельцем файловой системы ИЛИ
иметь встроенную роль builtin.iceberg.admin ИЛИ
иметь встроенную роль builtin.admin

Для группы объектов (если указана):

быть владельцем namespace ИЛИ
иметь встроенную роль builtin.iceberg.admin ИЛИ
иметь встроенную роль builtin.admin

Для namespace, которому принадлежит объект (если указан):

быть владельцем namespace ИЛИ
иметь встроенную роль builtin.iceberg.admin ИЛИ
иметь встроенную роль builtin.admin

Для объекта (если указан):

быть владельцем объекта ИЛИ
иметь встроенную роль builtin.iceberg.admin ИЛИ
иметь встроенную роль builtin.admin

Для запуска maintenance операции:

иметь встроенную роль builtin.iceberg.admin ИЛИ
иметь встроенную роль builtin.admin

Примеры#

Запустить операцию для группы объектов my_group:

catalog maintenance expire-snapshots --target-object-group my_group

+--------------------------------------+
| operation-id                         |
+--------------------------------------+
| 304ae154-a2ee-4df5-b63b-70830bf30e83 |
+--------------------------------------+

Запустить операцию для объекта prod.sales.nation:

catalog maintenance expire-snapshots --target-catalog prod --target-namespace sales --target-object nation

+--------------------------------------+
| operation-id                         |
+--------------------------------------+
| ff986598-9f62-40de-89a1-f699926329ff |
+--------------------------------------+

Запустить аналогичную операцию с отображением результата в формате JSON:

catalog --json maintenance expire-snapshots --target-catalog prod --target-namespace sales --target-object nation

{
  "operation-id" : "bada728b-02c8-411c-87ec-e98ebd60c93a"
}