object-group list-objects#

Получает список объектов, входящих в группу объектов.

Синтаксис#

catalog object-group list-objects --group-name=<objectGroupName>
                                  [--item-id=<itemId>]
                                  [--object-type=<objectType>]
                                  [[--page-size=<pageSize>]
                                  [--page-token=<pageToken>]]

Опции#

--group-name Имя группы объектов.

--item-id Необязательный идентификатор элемента группы объектов для которого нужно получить список объектов.

--object-type Необязательный тип объектов, которые необходимо отобразить. Допустимые значения: table, view, cedrusdata-materialized-view.

--page-size Максимальное количество возвращаемых записей.

--page-token Идентификатор страницы, начиная с которой необходимо возвращать записи.

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

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

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

  • является владельцем каталога ИЛИ

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

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

Для группы объектов:

  • является владельцем группы объектов ИЛИ

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

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

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

  • является владельцем namespace ИЛИ

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

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

Для объекта:

  • является владельцем объекта ИЛИ

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

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

Примеры#

Получить список объектов группы объектов в табличном формате:

catalog object-group list-objects --group-name my_group
+--------------+----------------+-------------+-------------+
| catalog-name | namespace-name | object-name | object-type |
+--------------+----------------+-------------+-------------+
| local        | tpch           | nation      | table       |
| local        | tpch           | region      | table       |
+--------------+----------------+-------------+-------------+

Получить список объектов группы объектов в формате JSON:

catalog --json object-group list-objects --group-name my_group
{
  "items" : [ {
    "catalog-name" : "local",
    "namespace-name" : "tpch",
    "object-name" : "nation",
    "object-type" : "table"
  }, {
    "catalog-name" : "local",
    "namespace-name" : "tpch",
    "object-name" : "region",
    "object-type" : "table"
  } ],
  "next-page-token" : null
}