Создание кластера Yandex MPP Analytics for PostgreSQL

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

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

Чтобы создать кластер Yandex MPP Analytics for PostgreSQL:

1. Проверьте, есть ли в каталоге подсети для хостов кластера:

   yc vpc subnet list
   

   Если ни одной подсети в каталоге нет, создайте нужные подсети в сервисе VPC.

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

   yc managed-greenplum cluster create --help
   

3. Укажите параметры кластера в команде создания (в примере приведены не все доступные параметры):

   yc managed-greenplum cluster create <имя_кластера> \
      --greenplum-version=<версия_СУБД> \
      --environment=<окружение> \
      --network-name=<имя_сети> \
      --user-name=<имя_пользователя> \
      --user-password=<пароль_пользователя> \
      --master-config resource-id=<класс_хоста>,`
                     `disk-size=<объем_хранилища_ГБ>,`
                     `disk-type=<network-ssd|network-ssd-nonreplicated|local-ssd> \
      --segment-config resource-id=<класс_хоста>,`
                     `disk-size=<объем_хранилища_ГБ>,`
                     `disk-type=<network-ssd-nonreplicated|local-ssd> \
      --zone-id=<зона_доступности> \
      --subnet-id=<идентификатор_подсети> \
      --assign-public-ip=<разрешить_публичный_доступ_к_хостам_кластера> \
      --security-group-ids=<список_идентификаторов_групп_безопасности> \
      --deletion-protection
   

   Примечание

   Имя кластера должно быть уникальным в каталоге. Оно может содержать латинские буквы, цифры, дефис и подчеркивание. Максимальная длина имени 63 символа.

   Где:

   • --greenplum-version — версия СУБД: 6.28 или 6.29, Cloudberry 2.

   • --environment — окружение:

     • PRODUCTION — для стабильных версий ваших приложений.
     • PRESTABLE — для тестирования. Prestable-окружение аналогично Production-окружению и на него также распространяется SLA, но при этом на нем раньше появляются новые функциональные возможности, улучшения и исправления ошибок. В Prestable-окружении вы можете протестировать совместимость новых версий с вашим приложением.

   • --network-name — имя сети.

   • --user-name — имя пользователя. Может содержать латинские буквы, цифры, дефис и подчеркивание, но должно начинаться с буквы, цифры или подчеркивания. Длина от 1 до 32 символов.

   • --user-password — пароль. Длина от 8 до 128 символов.

   • --master-config и --segment-config — конфигурация хостов-мастеров и хостов-сегментов:

     • resource-id — класс хоста.

       Класс хостов-сегментов и количество сегментов на хост влияют на максимальный объем памяти, выделенный на каждый серверный процесс Yandex MPP Analytics for PostgreSQL. Если выбран класс хостов с небольшим объемом оперативной памяти и указано большое число сегментов, то может возникнуть ошибка.

     • disk-size — объем хранилища в гигабайтах.

     • disk-type — тип диска:

       • network-ssd (только для хостов-мастеров);
       • local-ssd;
       • network-ssd-nonreplicated.

   • --zone-id — зона доступности.

   • --subnet-id — идентификатор подсети. Необходимо указывать, если в выбранной зоне доступности создано 2 и больше подсетей.

   • --assign-public-ip — флаг, который указывается, если для хостов нужен публичный доступ: true или false.

   • --security-group-ids — список идентификаторов групп безопасности.

   • --deletion-protection — защита кластера от непреднамеренного удаления: true или false.

     Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

4. Чтобы задать время начала резервного копирования, передайте нужное значение в формате HH:MM:SS в параметре --backup-window-start:

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --backup-window-start=<время_начала_резервного_копирования>
   

5. (Опционально) Чтобы создать кластер, размещенный на группах выделенных хостов, укажите через запятую их идентификаторы в параметрах --master-host-group-ids и --segment-host-group-ids:

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --master-host-group-ids=<идентификаторы_групп_выделенных_хостов_для_хостов-мастеров> \
      --segment-host-group-ids=<идентификаторы_групп_выделенных_хостов_для_хостов-сегментов>
   

   Вы можете назначить группы на один из видов хостов Yandex MPP Analytics for PostgreSQL либо сразу на оба.

   Группа выделенных хостов должна быть предварительно создана в сервисе Yandex Compute Cloud.

   Эту настройку нельзя изменить после создания кластера.

   При использовании выделенных хостов стоимость использования кластера складывается из цены за вычислительные ресурсы Yandex Compute Cloud и наценки Yandex MPP Analytics for PostgreSQL.

6. Чтобы настроить время технического обслуживания (в т. ч. для выключенных кластеров), передайте нужное значение в параметре --maintenance-window при создании кластера:

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --maintenance-window type=<тип_технического_обслуживания>,`
                          `day=<день_недели>,`
                          `hour=<час_дня> \
   

   Где type — тип технического обслуживания:

   • anytime (по умолчанию) — в любое время.
   • weekly — по расписанию. Для этого значения дополнительно укажите:

     • day — день недели: MON, TUE, WED, THU, FRI, SAT или SUN.

     • hour — порядковый номер часового интервала по UTC: от 1 до 24.

       Например, 1 соответствует интервалу с 00:00 до 01:00, 5 — с 04:00 до 05:00.

7. Чтобы разрешить доступ к кластеру из разных сервисов, передайте значение true в соответствующих параметрах при создании кластера:

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --datalens-access=<разрешить_доступ_из_DataLens> \
      --yandexquery-access=<разрешить_доступ_из_Yandex_Query> \
      --websql-access=<разрешить_доступ_из_WebSQL>
   

   Доступные сервисы:

   • --datalens-access — Yandex DataLens;
   • --yandexquery-access — Yandex Query;
   • --websql-access — Yandex WebSQL.

8. Чтобы включить передачу логов в сервис Yandex Cloud Logging, укажите параметры при создании кластера:

   yc managed-greenplum cluster create <имя_кластера> \
      ...
      --service-account <идентификатор_сервисного_аккаунта> \
      --log-enabled \
      --log-command-center-enabled \
      --log-greenplum-enabled \
      --log-pooler-enabled \
      --log-folder-id <идентификатор_каталога>
   

   Где:

   • --service-account — идентификатор сервисного аккаунта.

   • --log-enabled — включает механизм передачи логов. Обязателен для работы других флагов, отвечающих за передачу конкретных логов, например, --log-greenplum-enabled.

   • --log-command-center-enabled — передача логов командного центра.

   • --log-greenplum-enabled — передача логов СУБД.

   • --log-pooler-enabled — передача логов менеджера подключений.

   • --log-folder-id — идентификатор каталога, лог-группу которого нужно использовать.

   • --log-group-id — идентификатор лог-группы, в которую будут записываться логи.

     Укажите только одну из настроек: --log-folder-id либо --log-group-id.

Terraform позволяет быстро создать облачную инфраструктуру в Yandex Cloud и управлять ею с помощью файлов конфигураций. В файлах конфигураций хранится описание инфраструктуры на языке HCL (HashiCorp Configuration Language). При изменении файлов конфигураций Terraform автоматически определяет, какая часть вашей конфигурации уже развернута, что следует добавить или удалить.

Terraform распространяется под лицензией Business Source License, а провайдер Yandex Cloud для Terraform — под лицензией MPL-2.0.

Подробную информацию о ресурсах провайдера смотрите в документации на сайте Terraform или в зеркале.

Чтобы создать кластер Yandex MPP Analytics for PostgreSQL:

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

2. Если у вас еще нет Terraform, установите его и настройте провайдер Yandex Cloud.

3. Создайте конфигурационный файл с описанием облачной сети и подсетей.

   Кластер размещается в облачной сети. Если подходящая сеть у вас уже есть, описывать ее повторно не нужно.

   Хосты кластера размещаются в подсетях выбранной облачной сети. Если подходящие подсети у вас уже есть, описывать их повторно не нужно.

   Пример структуры конфигурационного файла, в котором описывается облачная сеть с одной подсетью:

   resource "yandex_vpc_network" "<имя_сети_в_Terraform>" { name = "<имя_сети>" }
   resource "yandex_vpc_subnet" "<имя_подсети_в_Terraform>" {
     name           = "<имя_подсети>"
     zone           = "<зона_доступности>"
     network_id     = yandex_vpc_network.<имя_сети_в_Terraform>.id
     v4_cidr_blocks = ["<подсеть>"]
   }
   

4. Создайте конфигурационный файл с описанием кластера и его хостов.

   Пример структуры конфигурационного файла:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера_в_Terraform>" {
     name                = "<имя_кластера>"
     environment         = "<окружение>"
     network_id          = yandex_vpc_network.<имя_сети_в_Terraform>.id
     zone                = "<зона_доступности>"
     subnet_id           = yandex_vpc_subnet.<имя_подсети_в_Terraform>.id
     assign_public_ip    = <разрешить_публичный_доступ_к_хостам_кластера>
     deletion_protection = <защитить_кластер_от_удаления>
     version             = "<версия_СУБД>"
     master_host_count   = <количество_хостов_мастеров>
     segment_host_count  = <количество_хостов_сегментов>
     segment_in_host     = <количество_сегментов_на_хост>
     master_subcluster {
       resources {
         resource_preset_id = "<класс_хоста>"
         disk_size          = <объем_хранилища_ГБ>
         disk_type_id       = "<тип_диска>"
       }
     }
     segment_subcluster {
       resources {
         resource_preset_id = "<класс_хоста>"
         disk_size          = <объем_хранилища_ГБ>
         disk_type_id       = "<тип_диска>"
       }
     }
   
     access {
       data_lens    = <разрешить_доступ_из_DataLens>
       yandex_query = <разрешить_доступ_из_Yandex_Query>
     }
   
     user_name     = "<имя_пользователя>"
     user_password = "<пароль>"
   
     security_group_ids = ["<список_идентификаторов_групп_безопасности>"]
   }
   

   Где:

   • assign_public_ip — публичный доступ к хостам кластера: true или false.

   • deletion_protection — защита кластера от непреднамеренного удаления: true или false.

     Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

   • version — версия СУБД.

   • master_host_count — количество хостов-мастеров: 2.

   • segment_host_count — количество хостов-сегментов: от 2 до 32.

   • segment_in_host — количество сегментов на хост. Максимальное значение этого параметра зависит от класса хостов.

     Класс хостов-сегментов и количество сегментов на хост влияют на максимальный объем памяти, выделенный на каждый серверный процесс Yandex MPP Analytics for PostgreSQL. Если выбран класс хостов с небольшим объемом оперативной памяти и указано большое число сегментов, то может возникнуть ошибка.

   • access.data_lens — доступ к кластеру из сервиса Yandex DataLens: true или false.

   • access.yandex_query — доступ к кластеру из сервиса Yandex Query: true или false.

   Более подробную информацию о ресурсах, которые вы можете создать с помощью Terraform, см. в документации провайдера.

5. (Опционально) Чтобы разместить хосты-мастеры или хосты-сегменты на выделенных хостах, укажите группы выделенных хостов:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера_в_Terraform>" {
     ...
     master_host_group_ids = [<идентификаторы_групп_выделенных_хостов_для_хостов-мастеров>]
     segment_host_group_ids = [<идентификаторы_групп_выделенных_хостов_для_хостов-сегментов>]
     ...
   }
   

   Вы можете назначить группы на один из двух видов хостов Yandex MPP Analytics for PostgreSQL либо сразу на оба.

   Группа выделенных хостов должна быть предварительно создана в сервисе Yandex Compute Cloud.

   Эту настройку нельзя изменить после создания кластера.

   При использовании выделенных хостов стоимость использования кластера складывается из цены за вычислительные ресурсы Yandex Compute Cloud и наценки Yandex MPP Analytics for PostgreSQL.

6. Чтобы включить передачу логов в сервис Yandex Cloud Logging, укажите параметры:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера_в_Terraform>" {
     ...
     service_account_id="<идентификатор_сервисного_аккаунта>"
     logging {
       enabled                = <включить_передачу_логов>
       command_center_enabled = <передавать_логи_Yandex_Command_Center>
       greenplum_enabled      = <передавать_логи_СУБД>
       pooler_enabled         = <передавать_логи_менеджера_подключений>
       folder_id              = "<идентификатор_каталога>"
     }
   }
   

   Где:

   • service_account_id — идентификатор сервисного аккаунта.

   • logging — настройки передачи логов:

     • enabled — управляет механизмом передачи логов: true или false. Для работы параметров, отвечающих за передачу конкретных логов, передайте значение true.

     • command_center_enabled — передача логов командного центра: true или false.

     • greenplum_enabled — передача логов СУБД: true или false.

     • pooler_enabled — передача логов менеджера подключений: true или false.

     • folder_id — идентификатор каталога, лог-группу которого нужно использовать.

     • log_group_id — идентификатор лог-группы, в которую будут записываться логи.

       Укажите только одну из настроек: folder_id либо log_group_id.

7. Проверьте корректность файлов конфигурации Terraform:

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

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

      terraform validate
      

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

8. Создайте кластер:

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

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

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

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

2. Создайте файл body.json и добавьте в него следующее содержимое:

   {
     "folderId": "<идентификатор_каталога>",
     "name": "<имя_кластера>",
     "environment": "<окружение>",
     "config": {
       "version": "<версия_СУБД>",
       "access": {
         "dataLens": <разрешить_доступ_из_DataLens>,
         "yandexQuery": <разрешить_доступ_из_Yandex_Query>
       },
       "zoneId": "<зона_доступности>",
       "subnetId": "<идентификатор_подсети>",
       "assignPublicIp": <разрешить_публичный_доступ_к_хостам_кластера>
     },
     "masterConfig": {
       "resources": {
         "resourcePresetId": "<класс_хостов>",
         "diskSize": "<размер_хранилища_в_байтах>",
         "diskTypeId": "<тип_диска>"
       }
     },
     "segmentConfig": {
       "resources": {
         "resourcePresetId": "<класс_хостов>",
         "diskSize": "<размер_хранилища_в_байтах>",
         "diskTypeId": "<тип_диска>"
       }
     },
     "masterHostCount": "<количество_хостов-мастеров>",
     "segmentHostCount": "<количество_хостов-сегментов>",
     "segmentInHost": "<количество_сегментов_на_хост>",
     "userName": "<имя_пользователя>",
     "userPassword": "<пароль_пользователя>",
     "networkId": "<идентификатор_сети>",
     "securityGroupIds": [
         "<идентификатор_группы_безопасности_1>",
         "<идентификатор_группы_безопасности_2>",
         ...
         "<идентификатор_группы_безопасности_N>"
     ],
     "deletionProtection": <защитить_кластер_от_удаления>,
     "configSpec": {
       "pool": {
         "mode": "<режим_работы>",
         "size": "<количество_клиентских_соединений>",
         "clientIdleTimeout": "<время_ожидания_клиента>",
         "idleInTransactionTimeout": "<время_ожидания_клиента_в_транзакции>"
       }
     },
     "cloudStorage": {
       "enable": <использовать_гибридное_хранилище>
     },
     "masterHostGroupIds": [
       "string"
     ],
     "segmentHostGroupIds": [
       "string"
     ],
     "serviceAccountId": "<идентификатор_сервисного_аккаунта>",
     "logging": {
       "enabled": "<включить_передачу_логов>",
       "commandCenterEnabled": "<передавать_логи_Yandex_Command_Center>",
       "greenplumEnabled": "<передавать_логи_СУБД>",
       "poolerEnabled": "<передавать_логи_менеджера_подключений>",
       "folderId": "<идентификатор_каталога>"
     }
   }
   

   Где:

   • folderId — идентификатор каталога. Его можно запросить со списком каталогов в облаке.

   • name — имя кластера.

   • environment — окружение кластера: PRODUCTION или PRESTABLE.

   • config — настройки кластера:

     • version — версия СУБД.

     • access — настройки доступа к кластеру из следующих сервисов Yandex Cloud:

       • dataLens — Yandex DataLens: true или false.
       • yandexQuery — Yandex Query: true или false.

     • zoneId — зона доступности.

     • subnetId — идентификатор подсети.

     • assignPublicIp — публичный доступ к хостам кластера: true или false.

   • masterConfig.resources, segmentConfig.resources — конфигурация хостов-мастеров и хостов-сегментов кластера:

     • resourcePresetId — класс хостов;
     • diskSize — размер диска в байтах;
     • diskTypeId — тип диска.

   • masterHostCount — количество хостов-мастеров: 1 или 2.

   • segmentHostCount — количество хостов-сегментов: от 2 до 32.

   • segmentInHost — количество сегментов на хост. Максимальное значение этого параметра зависит от класса хостов.

     Класс хостов-сегментов и количество сегментов на хост влияют на максимальный объем памяти, выделенный на каждый серверный процесс Yandex MPP Analytics for PostgreSQL. Если выбран класс хостов с небольшим объемом оперативной памяти и указано большое число сегментов, то может возникнуть ошибка.

   • userName — имя пользователя.

   • userPassword — пароль пользователя.

   • networkId — идентификатор сети, в которой будет размещен кластер.

   • securityGroupIds — идентификаторы групп безопасности.

   • deletionProtection — защита кластера от непреднамеренного удаления: true или false.

     Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

   • configSpec.pool — настройки менеджера подключений:

     • mode — режим работы: SESSION или TRANSACTION.
     • size — количество клиентских соединений.
     • clientIdleTimeout — время неактивности клиентского соединения в секундах, после которого соединение разрывается.
     • idleInTransactionTimeout — время неактивности клиентского соединения с открытой транзакцией в секундах, после которого соединение разрывается.

   • cloudStorage.enable — использование гибридного хранилища. Установите значение true, чтобы включить в кластере расширение Yezzey от Yandex Cloud. Оно применяется, чтобы выгрузить таблицы AO и AOCO с дисков кластера Yandex MPP Analytics for PostgreSQL в холодное хранилище Yandex Object Storage. Так данные хранятся в служебном бакете в сжатом и зашифрованном виде. Это более экономичный способ хранения.

     Гибридное хранилище нельзя отключить после сохранения настроек кластера.

     Примечание

     Функциональность находится на стадии Preview и не тарифицируется.

   • masterHostGroupIds и segmentHostGroupIds — (опционально) идентификаторы групп выделенных хостов для хостов-мастеров и хостов-сегментов.

     Группа выделенных хостов должна быть предварительно создана в сервисе Yandex Compute Cloud.

     Эту настройку нельзя изменить после создания кластера.

     При использовании выделенных хостов стоимость использования кластера складывается из цены за вычислительные ресурсы Yandex Compute Cloud и наценки Yandex MPP Analytics for PostgreSQL.

   • serviceAccountId — идентификатор сервисного аккаунта.

   • logging — настройки передачи логов в сервис Yandex Cloud Logging:

     • enabled — управляет механизмом передачи логов: true или false. Для работы параметров, отвечающих за передачу конкретных логов, передайте значение true.

     • commandCenterEnabled — передача логов командного центра: true или false.

     • greenplumEnabled — передача логов СУБД: true или false.

     • poolerEnabled — передача логов менеджера подключений: true или false.

     • folderId — идентификатор каталога, лог-группу которого нужно использовать.

     • logGroupId — идентификатор лог-группы, в которую будут записываться логи.

       Укажите только одну из настроек: folderId либо logGroupId.

3. Воспользуйтесь методом Cluster.Create и выполните запрос, например, с помощью cURL:

   curl \
       --request POST \
       --header "Authorization: Bearer $IAM_TOKEN" \
       --header "Content-Type: application/json" \
       --url 'https://mdb.api.cloud.yandex.net/managed-greenplum/v1/clusters' \
       --data "@body.json"
   

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

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

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

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

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

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

3. Создайте файл body.json и добавьте в него следующее содержимое:

   {
     "folder_id": "<идентификатор_каталога>",
     "name": "<имя_кластера>",
     "environment": "<окружение>",
     "config": {
       "version": "<версия_СУБД>",
       "access": {
         "data_lens": <разрешить_доступ_из_DataLens>,
         "yandex_query": <разрешить_доступ_из_Yandex_Query>
       },
       "zone_id": "<зона_доступности>",
       "subnet_id": "<идентификатор_подсети>",
       "assign_public_ip": <разрешить_публичный_доступ_к_хостам_кластера>
     },
     "master_config": {
       "resources": {
         "resource_preset_id": "<класс_хостов>",
         "disk_size": "<размер_хранилища_в_байтах>",
         "disk_type_id": "<тип_диска>"
       }
     },
     "segment_config": {
       "resources": {
         "resource_preset_id": "<класс_хостов>",
         "disk_size": "<размер_хранилища_в_байтах>",
         "disk_type_id": "<тип_диска>"
       }
     },
     "master_host_count": "<количество_хостов-мастеров>",
     "segment_host_count": "<количество_хостов-сегментов>",
     "segment_in_host": "<количество_сегментов_на_хост>",
     "user_name": "<имя_пользователя>",
     "user_password": "<пароль_пользователя>",
     "network_id": "<идентификатор_сети>",
     "security_group_ids": [
         "<идентификатор_группы_безопасности_1>",
         "<идентификатор_группы_безопасности_2>",
         ...
         "<идентификатор_группы_безопасности_N>"
     ],
     "deletion_protection": <защитить_кластер_от_удаления>
     "config_spec": {
       "pool": {
         "mode": "<режим_работы>",
         "size": "<количество_клиентских_соединений>",
         "client_idle_timeout": "<время_ожидания_клиента>",
         "idle_in_transaction_timeout": "<время_ожидания_клиента_в_транзакции>"
       }
     },
     "cloud_storage": {
       "enable": <использовать_гибридное_хранилище>
     },
     "master_host_group_ids": [
       "string"
     ],
     "segment_host_group_ids": [
       "string"
     ],
     "service_account_id": "<идентификатор_сервисного_аккаунта>",
     "logging": {
       "enabled": "<включить_передачу_логов>",
       "command_center_enabled": "<передавать_логи_Yandex_Command_Center>",
       "greenplum_enabled": "<передавать_логи_СУБД>",
       "pooler_enabled": "<передавать_логи_менеджера_подключений>",
       "folder_id": "<идентификатор_каталога>"
     }
   }
   

   Где:

   • folder_id — идентификатор каталога. Его можно запросить со списком каталогов в облаке.

   • name — имя кластера.

   • environment — окружение кластера: PRODUCTION или PRESTABLE.

   • config — настройки кластера:

     • version — версия СУБД.

     • access — настройки доступа кластера к следующим сервисам Yandex Cloud:

       • data_lens — Yandex DataLens: true или false.
       • yandex_query — Yandex Query: true или false.

     • zone_id — зона доступности.

     • subnet_id — идентификатор подсети.

     • assign_public_ip — публичный доступ к хостам кластера: true или false.

   • master_config.resources, segment_config.resources — конфигурация хостов-мастеров и хостов-сегментов кластера:

     • resource_preset_id — класс хостов;
     • disk_size — размер диска в байтах;
     • disk_type_id — тип диска.

   • master_host_count — количество хостов-мастеров: 1 или 2.

   • segment_host_count — количество хостов-сегментов: от 2 до 32.

   • segment_in_host — количество сегментов на хост. Максимальное значение этого параметра зависит от класса хостов.

     Класс хостов-сегментов и количество сегментов на хост влияют на максимальный объем памяти, выделенный на каждый серверный процесс Yandex MPP Analytics for PostgreSQL. Если выбран класс хостов с небольшим объемом оперативной памяти и указано большое число сегментов, то может возникнуть ошибка.

   • user_name — имя пользователя.

   • user_password — пароль пользователя.

   • network_id — идентификатор сети, в которой будет размещен кластер.

   • security_group_ids — идентификаторы групп безопасности.

   • deletion_protection — защита кластера от непреднамеренного удаления: true или false.

     Включенная защита кластера от удаления не помешает подключиться к нему вручную и удалить данные.

   • config_spec.pool — настройки менеджера подключений:

     • mode — режим работы: SESSION или TRANSACTION.
     • size — количество клиентских соединений.
     • client_idle_timeout — время неактивности клиентского соединения в секундах, после которого соединение разрывается.
     • idle_in_transaction_timeout — время неактивности клиентского соединения с открытой транзакцией в секундах, после которого соединение разрывается.

   • cloud_storage.enable — использование гибридного хранилища. Установите значение true, чтобы включить в кластере расширение Yezzey от Yandex Cloud. Оно применяется, чтобы выгрузить таблицы AO и AOCO с дисков кластера Yandex MPP Analytics for PostgreSQL в холодное хранилище Yandex Object Storage. Так данные хранятся в служебном бакете в сжатом и зашифрованном виде. Это более экономичный способ хранения.

     Гибридное хранилище нельзя отключить после сохранения настроек кластера.

     Примечание

     Функциональность находится на стадии Preview и не тарифицируется.

   • master_host_group_ids и segment_host_group_ids — (опционально) идентификаторы групп выделенных хостов для хостов-мастеров и хостов-сегментов.

     Группа выделенных хостов должна быть предварительно создана в сервисе Yandex Compute Cloud.

     Эту настройку нельзя изменить после создания кластера.

     При использовании выделенных хостов стоимость использования кластера складывается из цены за вычислительные ресурсы Yandex Compute Cloud и наценки Yandex MPP Analytics for PostgreSQL.

   • service_account_id — идентификатор сервисного аккаунта.

   • logging — настройки передачи логов в сервис Yandex Cloud Logging:

     • enabled — управляет механизмом передачи логов: true или false. Для работы параметров, отвечающих за передачу конкретных логов, передайте значение true.

     • command_center_enabled — передача логов командного центра: true или false.

     • greenplum_enabled — передача логов СУБД: true или false.

     • pooler_enabled — передача логов менеджера подключений: true или false.

     • folder_id — идентификатор каталога, лог-группу которого нужно использовать.

     • log_group_id — идентификатор лог-группы, в которую будут записываться логи.

       Укажите только одну из настроек: folder_id либо log_group_id.

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

   grpcurl \
       -format json \
       -import-path ~/cloudapi/ \
       -import-path ~/cloudapi/third_party/googleapis/ \
       -proto ~/cloudapi/yandex/cloud/mdb/greenplum/v1/cluster_service.proto \
       -rpc-header "Authorization: Bearer $IAM_TOKEN" \
       -d @ \
       mdb.api.cloud.yandex.net:443 \
       yandex.cloud.mdb.greenplum.v1.ClusterService.Create \
       < body.json
   

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