Создать каталог

Статья создана

Обновлена 2 июля 2026 г.

Если у вас есть проект, вы можете создать в нем каталог Iceberg REST Catalog.

Перед созданием каталога убедитесь, что бакет, на который ссылается параметр spec.stacklandStorage.bucketRef, уже существует. Чтобы создать бакет, воспользуйтесь инструкцией Создать бакет.

CLI

Консоль управления

Если проект еще не создан, то создайте его: kubectl create namespace <название проекта>.
Создайте файл ресурса RestCatalog. Например, с помощью команды touch restcatalog.yaml.

Откройте файл и вставьте конфигурацию ниже:

apiVersion: restcatalog.stackland.yandex.cloud/v1alpha1
kind: RestCatalog
metadata:
  name: analytics                    # Имя каталога; уникально в пределах кластера
spec:
  allowedLocations:                  # Разрешенные пути хранения данных таблиц (минимум один)
    - "s3://analytics-bucket/wh/"
  stacklandStorage:
    bucketRef: analytics-bucket      # Ссылка на существующий бакет (Bucket CR)
  defaultBaseLocation: "s3://analytics-bucket/wh/"   # Опционально; входит в allowedLocations
  defaultNamespace:                  # Опционально; массив сегментов пространства имен
    - analytics
    - reporting
  properties:                        # Опционально; дополнительные параметры каталога
    some-key: some-value
  declaredPrincipalRoles:            # Опционально; группы пользователей каталога
    - name: analytics-admin
  catalogRoles:                      # Опционально; роли каталога с привилегиями
    - name: analytics-admin-all
      principalRoles:
        - analytics-admin
      catalog:                       # Одна из веток: catalog, namespace, table или view
        privileges:
          - CATALOG_MANAGE_CONTENT

Примените манифест: kubectl apply -f restcatalog.yaml -n <название проекта>. При необходимости можно прописать название проекта в параметр ресурса metadata.namespace и не использовать в команде.

Если вы еще не открыли проект, выберите проект.
В левом меню выберите Iceberg REST Catalog.
На вкладке Каталоги нажмите Создать каталог.
Заполните поля:
- Имя — имя каталога. После создания имя не меняется.
- Имя бакета — выберите существующий бакет из списка или создайте новый.
- Разрешенные пути хранения — укажите хотя бы один путь вида s3://<имя бакета>/.... При необходимости добавьте несколько путей.
- Базовый путь по умолчанию — выберите один из разрешенных путей или оставьте поле пустым.
- Пространство имен по умолчанию — укажите сегменты пути при необходимости.
- Дополнительные параметры — задайте пары «ключ — значение» при необходимости.
В блоке Группы пользователей добавьте имена групп пользователей каталога.
В блоке Роли каталога при необходимости добавьте роли. Для каждой роли укажите имя, группы пользователей, тип охвата (Каталог, Пространство имен, Таблица или Представление) и привилегии.
Нажмите Создать.

Создать каталог

Была ли статья полезна?