Изменение каталога Trino

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

Yandex Cloud

Улучшена

mmerihsesh

Обновлена 3 марта 2026 г.

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

CLI

Terraform

REST API

gRPC API

Перейдите на страницу каталога ресурсов.
Перейдите в сервис Managed Service for Trino.
Нажмите на имя нужного кластера.
На панели слева выберите Каталоги.
В строке с нужным каталогом Trino нажмите на значок и выберите пункт Редактировать.
Измените параметры каталога Trino и нажмите кнопку Обновить.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Посмотрите описание команды CLI для изменения каталога Trino:
```
yc managed-trino catalog update --help
```
Посмотрите описание команды CLI для изменения каталога Trino c конкретным коннектором:
```
yc managed-trino catalog update <тип_коннектора> --help
```
Чтобы изменить каталог, выполните команду:
```
yc managed-trino catalog update <тип_коннектора> <имя_каталога_Trino> \
    --new-name <новое_имя_каталога_Trino>
```
Имя каталога Trino можно запросить со списком каталогов Trino в кластере.

В команде также можно передать настройки каталога Trino, которые зависят от типа коннектора. Подробнее о настройках для разных типов коннекторов.

Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

О том, как создать такой файл, см. в разделе Создание кластера.
Измените настройки каталога Trino в блоке yandex_trino_catalog:
```
resource "yandex_trino_catalog" "<имя_каталога_Trino>" {
  ...
  <тип_коннектора> = {
    <настройки_каталога_Trino>
  }
}
```
Подробнее о настройках каталога Trino для разных типов коннекторов.
Проверьте корректность настроек.
1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
2. Выполните команду:
```
terraform validate
```
  Если в файлах конфигурации есть ошибки, Terraform на них укажет.
Подтвердите изменение ресурсов.
1. Выполните команду для просмотра планируемых изменений:
```
terraform plan
```
  Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
2. Если вас устраивают планируемые изменения, внесите их:
  1. Выполните команду:
```
terraform apply
```
  2. Подтвердите изменение ресурсов.
  3. Дождитесь завершения операции.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Воспользуйтесь методом Catalog.Update и выполните запрос, например с помощью cURL:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask (одной строкой через запятую).
```
curl \
    --request PATCH \
    --header "Authorization: Bearer $IAM_TOKEN" \
    --header "Content-Type: application/json" \
    --url 'https://trino.api.cloud.yandex.net/managed-trino/v1/clusters/<идентификатор_кластера>/catalogs/<идентификатор_каталога_Trino>' \
    --data '{
              "updateMask": "catalog.name,catalog.connector.<тип_коннектора>.<путь_к_настройке>.<настройка_1>,catalog.connector.<тип_коннектора>.<путь_к_настройке>.<настройка_2>,...,catalog.connector.<тип_коннектора>.<путь_к_настройке>.<настройка_N>",
              "catalog": {
                "name": "<новое_имя_каталога_Trino>",
                "connector": {
                  "<тип_коннектора>": {
                    <изменяемые_настройки_каталога_Trino>
                  }
                }
              }
            }'
```
Где updateMask — перечень изменяемых параметров в одну строку через запятую.

Подробнее о настройках каталога Trino для разных типов коннекторов.

Идентификатор кластера можно запросить со списком кластеров в каталоге, идентификатор каталога — со списком каталогов Trino в кластере.
Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:
```
export IAM_TOKEN="<IAM-токен>"
```
Клонируйте репозиторий cloudapi:
```
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi
```
Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

Воспользуйтесь вызовом CatalogService.Update и выполните запрос, например с помощью gRPCurl:

Важно

Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре update_mask (в виде массива строк paths[]).

Формат перечисления настроек

"update_mask": {
    "paths": [
        "<настройка_1>",
        "<настройка_2>",
        ...
        "<настройка_N>"
    ]
}

grpcurl \
    -format json \
    -import-path ~/cloudapi/ \
    -import-path ~/cloudapi/third_party/googleapis/ \
    -proto ~/cloudapi/yandex/cloud/trino/v1/catalog_service.proto \
    -rpc-header "Authorization: Bearer $IAM_TOKEN" \
    -d '{
          "cluster_id": "<идентификатор_кластера>",
          "catalog_id": "<идентификатор_каталога_Trino>",
          "update_mask": {
            "paths": [
              "catalog.name",
              "catalog.connector.<тип_коннектора>.<путь_к_настройке>.<настройка_1>",
              "catalog.connector.<тип_коннектора>.<путь_к_настройке>.<настройка_2>",
              ...
              "catalog.connector.<тип_коннектора>.<путь_к_настройке>.<настройка_N>"
            ]
          },
          "catalog": {
            "name": "<новое_имя_каталога_Trino>",
            "connector": {
              "<тип_коннектора>": {
                <изменяемые_настройки_каталога_Trino>
              }
            }
          }
        }' \
    trino.api.cloud.yandex.net:443 \
    yandex.cloud.trino.v1.CatalogService.Update

Где update_mask — перечень изменяемых параметров в виде массива строк paths[].

Подробнее о настройках каталога Trino для разных типов коннекторов.

Идентификатор кластера можно запросить со списком кластеров в каталоге, идентификатор каталога — со списком каталогов Trino в кластере.

Убедитесь, что запрос был выполнен успешно, изучив ответ сервера.

Изменение каталога Trino

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