maintenance remove-orphan-files#

Запускает maintenance операцию remove-orphan-files.

Синтаксис#

catalog maintenance remove-orphan-files [--older-than=<olderThan>]
                                        ([--target-object-group=<objectGroupName>] | 
                                        [--target-catalog=<catalogName> 
                                        --target-namespace=<namespaceName>
                                        --target-object=<objectName>])

Опции#

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

--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-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 remove-orphan-files --target-object-group my_group

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

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

catalog maintenance remove-orphan-files --target-catalog prod --target-namespace sales --target-object nation

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

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

catalog --json maintenance remove-orphan-files --target-catalog prod --target-namespace sales --target-object nation

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