Связаться с намиПодключиться

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

Статья создана
Улучшена
Обновлена 5 августа 2025 г.
  1. На странице каталога ресурсов выберите сервис Managed Service for Trino.
  2. Нажмите на имя нужного кластера.
  3. На панели слева выберите Каталоги.
  4. В строке с нужным каталогом Trino нажмите на значок и выберите пункт Редактировать.
  5. Измените параметры каталога Trino и нажмите кнопку Обновить.

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

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

  1. Посмотрите описание команды CLI для изменения каталога Trino:

    yc managed-trino catalog update --help

  2. Посмотрите описание команды CLI для изменения каталога Trino c конкретным коннектором:

    yc managed-trino catalog update <тип_коннектора> --help

  3. Чтобы изменить каталог, выполните команду:

    yc managed-trino catalog update <тип_коннектора> <имя_каталога_Trino> \
    --new-name <новое_имя_каталога_Trino>

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

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

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

    О том, как создать такой файл, см. в разделе Создание кластера.

  2. Измените настройки каталога Trino в блоке yandex_trino_catalog:

    resource "yandex_trino_catalog" "<имя_каталога_Trino>" {
  ...
  <тип_коннектора> = {
    <настройки_каталога_Trino>
  }
}

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

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

    2. Выполните команду:

      terraform validate

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

  4. Подтвердите изменение ресурсов.

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

        terraform apply

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"

  2. Воспользуйтесь методом 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 в кластере.

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

  1. Получите IAM-токен для аутентификации в API и поместите токен в переменную среды окружения:

    export IAM_TOKEN="<IAM-токен>"

  2. Клонируйте репозиторий cloudapi:

    cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapi

    Далее предполагается, что содержимое репозитория находится в директории ~/cloudapi/.

  3. Воспользуйтесь вызовом 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 в кластере.

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

Предыдущая
Создание каталога
Следующая
Удаление каталога