Изменение настроек кластера Greenplum®

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы изменить имя и описание кластера Greenplum®:

1. Посмотрите текущие имя (name) и описание (description) кластера:

   yc managed-greenplum cluster get <имя_или_идентификатор_кластера>
   

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

   yc managed-greenplum cluster update --help
   

3. Задайте новое имя и описание кластера:

   yc managed-greenplum cluster update <имя_или_идентификатор_кластера> \
      --new-name <новое_имя_кластера> \
      --description <новое_описание_кластера>
   

Чтобы изменить описание кластера:

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

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

   Полный список доступных для изменения полей конфигурации кластера Managed Service for Greenplum® см. в документации провайдера Terraform.

2. Измените в описании кластера Managed Service for Greenplum® значение атрибута description:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера>" {
     name        = "<имя_кластера>"
     description = "<новое_описание_кластера>"
     ...
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение всех операций с кластером Managed Service for Greenplum® 120 минутами.

   Операции, длящиеся дольше указанного времени, прерываются.

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_greenplum_cluster" "<имя кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

Чтобы изменить имя и описание кластера, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Новое имя в параметре name.
• Новое описание в параметре description.
• Список изменяемых полей конфигурации кластера в параметре updateMask (в данном случае — name, description).

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы изменить настройку публичного доступа Greenplum®:

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

   yc managed-greenplum cluster update --help
   

2. Задайте настройку публичного доступа в параметре --assign-public-ip:

   yc managed-greenplum cluster update <имя_или_идентификатор_кластера> \
      --assign-public-ip=<публичный_доступ_к_кластеру>
   

   Где assign-public-ip — публичный доступ к кластеру: true или false.

Воспользуйтесь методом API update и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Настройку публичного доступа в параметре config.assignPublicIp.
• Список изменяемых полей конфигурации кластера в параметре updateMask (в данном случае — name, description).

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы изменить дополнительные настройки кластера:

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

   yc managed-greenplum cluster update --help
   

2. Выполните команду, передав список настроек, которые хотите изменить:

   yc managed-greenplum cluster update <имя_или_идентификатор_кластера> \
       --backup-window-start <время_начала_резервного_копирования> \
       --datalens-access=<доступ_из_DataLens> \
       --yandexquery-access=<доступ_из_Yandex_Query> \
       --maintenance-window type=<тип_технического_обслуживания>,`
                           `day=<день_недели>,`
                           `hour=<час_дня> \
       --deletion-protection
   

Вы можете изменить следующие настройки:

• --backup-window-start — время начала резервного копирования кластера, задается по UTC в формате HH:MM:SS. Если время не задано, резервное копирование начнется в 22:00 UTC.

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

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

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

  • anytime (по умолчанию) — в любое время.
  • weekly — по расписанию. При задании этого значения укажите день недели и час дня:
    • day — день недели в формате DDD: MON, TUE, WED, THU, FRI, SAT или SUN.
    • hour — час дня по UTC в формате HH: от 1 до 24.

• --deletion-protection — защита кластера, его баз данных и пользователей от непреднамеренного удаления.

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

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

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

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

   Полный список доступных для изменения полей конфигурации кластера Managed Service for Greenplum® см. в документации провайдера Terraform.

2. Измените в описании кластера Managed Service for Greenplum® значения нужных дополнительных настроек:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера>" {
     ...
     backup_window_start {
       hours = <начало_периода_резервного_копирования>
     }
   
     maintenance_window {
       type = <тип_технического_обслуживания>
       day  = <день_недели>
       hour = <час_дня>
     }
   
     access {
       data_lens    = <доступ_из_DataLens>
       yandex_query = <доступ_из_Yandex_Query>
     }
   
     deletion_protection = <защита_от_удаления>
   
     cloud_storage {
       enable = <использование_гибридного_хранилища>
     }
   
     pooler_config {
       pooling_mode             = <режим_работы>
       pool_size                = <размер>
       pool_client_idle_timeout = <время_ожидания_клиента>
     }
   }
   

   Вы можете изменить следующие настройки:

   • backup_window_start.hours — начало периода, в течение которого начинается резервное копирование кластера. Задается по UTC в формате HH: от 0 до 23.

   • maintenance_window — настройки времени технического обслуживания (в т. ч. для выключенных кластеров):

     • type — тип технического обслуживания. Принимает значения:
       • ANYTIME — в любое время.
       • WEEKLY — по расписанию.
     • day — день недели для типа WEEKLY в формате DDD. Например, MON.
     • hour — час дня по UTC для типа WEEKLY в формате HH. Например, 21.

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

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

   • deletion_protection — защита от удаления кластера, его баз данных и пользователей: true или false.

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

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

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

     Примечание

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

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

     • pooling_mode — режим работы: SESSION или TRANSACTION.
     • pool_size — количество клиентских соединений.
     • pool_client_idle_timeout — время неактивности клиентского соединения (в миллисекундах), после которого соединение разрывается.

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение всех операций с кластером Managed Service for Greenplum® 120 минутами.

   Операции, длящиеся дольше указанного времени, прерываются.

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_greenplum_cluster" "<имя кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

Чтобы изменить дополнительные настройки кластера, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.

• Публичный доступ в параметре config.assignPublicIp.

• Окно резервного копирования в параметре config.backupWindowStart.

• Доступ к кластеру из сервиса Yandex DataLens в параметре config.access.dataLens.

• Доступ к кластеру из сервиса Yandex Query в параметре config.access.yandexQuery.

• Время технического обслуживания (в т. ч. для выключенных кластеров) в параметре maintenanceWindow.

• Защиту от удаления кластера в параметре deletionProtection.

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

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

Чтобы изменить настройки регламентных операций технического обслуживания кластера, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.

• Новые значения параметров для объектаconfigSpec.backgroundActivities.analyzeAndVacuum:

  • start.hours — час начала операции VACUUM по UTC. Возможные значения: от 0 до 23, по умолчанию — 19.
  • start.minutes — минута начала операции VACUUM по UTC. Возможные значения: от 0 до 59, по умолчанию — 0.
  • vacuumTimeout — максимальная длительность выполнения операции VACUUM, в секундах. Возможные значения: от 7200 до 86399, по умолчанию — 36000. Когда указанное время истечет, операция VACUUM будет принудительно завершена.
  • analyzeTimeout — максимальная длительность выполнения операции ANALYZE, в секундах. Возможные значения: от 7200 до 86399, по умолчанию — 36000. Когда указанное время истечет, операция ANALYZE будет принудительно завершена.

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

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы изменить настройки СУБД Greenplum®:

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

   yc managed-greenplum cluster get <имя_или_идентификатор_кластера>
   

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

   yc managed-greenplum cluster update-config --help
   

3. Установите нужные значения параметров:

   Все поддерживаемые параметры перечислены в формате запроса для метода update, в поле greenplumConfig_<версия_Greenplum>. Чтобы указать имя параметра в вызове CLI, преобразуйте его имя из вида lowerCamelCase в snake_case, например, параметр maxConnections из запроса к API преобразуется в max_connections для команды CLI:

   yc managed-greenplum cluster update-config <имя_или_идентификатор_кластера> \
      --set <имя_параметра1>=<значение1>,<имя_параметра2>=<значение2>,...
   

   Managed Service for Greenplum® запустит операцию по изменению настроек кластера.

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

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

   Полный список доступных для изменения полей конфигурации кластера Managed Service for Greenplum® см. в документации провайдера Terraform.

2. Измените в описании кластера настройки Greenplum® в блоке greenplum_config:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера>" {
     ...
     greenplum_config = {
       max_connections         = <максимальное_количество_соединений>
       gp_workfile_compression = <true_или_false>
       ...
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение всех операций с кластером Managed Service for Greenplum® 120 минутами.

   Операции, длящиеся дольше указанного времени, прерываются.

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_greenplum_cluster" "<имя кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

Чтобы изменить настройки Greenplum®, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Новые значения в параметре configSpec.greenplumConfig_<версия>.

• Список полей конфигурации кластера, подлежащих изменению, в параметре updateMask.

  Важно

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

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

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы изменить класс хостов для кластера:

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

   yc managed-greenplum cluster update --help
   

2. Запросите список доступных классов (в колонке ZONE IDS указаны зоны доступности, в которых можно выбрать соответствующий класс):

   • для хостов-мастеров:

     yc managed-greenplum resource-preset list master
     

   • для хостов-сегментов:

     yc managed-greenplum resource-preset list segment
     

   +-------------+--------------------------------+--------------------------------+-------+----------+--------------------+---------------------+
   |     ID      |            ZONE IDS            |           DISK TYPES           | CORES |  MEMORY  | HOST COUNT DIVIDER | MAX SEGMENT IN HOST |
   +-------------+--------------------------------+--------------------------------+-------+----------+--------------------+---------------------+
   | i2.2xlarge  | ru-central1-a, ru-central1-b   | local-ssd,                     |    16 | 128.0 GB |                  1 |                   0 |
   |             |                                | network-ssd-nonreplicated      |       |          |                    |                     |
   | ...                                                                                                                                         |
   +-------------+--------------------------------+--------------------------------+-------+----------+--------------------+---------------------+
   

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

   yc managed-greenplum cluster update <имя_или_идентификатор_кластера> \
       --master-config resource-id=<идентификатор_класса_хостов-мастеров> \
       --segment-config resource-id=<идентификатор_класса_хостов-сегментов>
   

   Managed Service for Greenplum® запустит операцию изменения класса хостов для кластера.

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

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

   Полный список доступных для изменения полей конфигурации кластера Managed Service for Greenplum® см. в документации провайдера Terraform.

2. Измените в описании кластера Managed Service for Greenplum® значение атрибута resource_preset_id в блоке master_subcluster.resources или segment_subcluster.resources:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера>" {
     ...
     master_subcluster {
       resources {
         resource_preset_id = "<класс_хоста>"
         ...
       }
     }
     segment_subcluster {
       resources {
         resource_preset_id = "<класс_хоста>"
         ...
       }
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение всех операций с кластером Managed Service for Greenplum® 120 минутами.

   Операции, длящиеся дольше указанного времени, прерываются.

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_greenplum_cluster" "<имя кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

Чтобы изменить класс хостов для кластера, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор кластера, получите список кластеров в каталоге.
• Идентификатор класса хоста-мастера в параметре masterConfig.resources.resourcePresetId или идентификатор класса хоста-сегмента в параметре segmentConfig.resources.resourcePresetId. Список поддерживаемых значений можно получить, воспользовавшись методом list для ресурса ResourcePreset.
• Список настроек, которые необходимо изменить (в данном случае — masterConfig.resources.resourcePresetId или segmentConfig.resources.resourcePresetId), в параметре updateMask.

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

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

   Полный список доступных для изменения полей конфигурации кластера Managed Service for Greenplum® см. в документации провайдера Terraform.

2. Измените в описании кластера Managed Service for Greenplum® значение атрибута disk_size в блоке master_subcluster.resources или segment_subcluster.resources:

   resource "yandex_mdb_greenplum_cluster" "<имя_кластера>" {
     ...
     master_subcluster {
       resources {
         disk_size = <размер_хранилища_в_гигабайтах>
         ...
       }
     }
     segment_subcluster {
       resources {
         disk_size = <размер_хранилища_в_гигабайтах>
         ...
       }
     }
   }
   

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

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

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

      terraform validate
      

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

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

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

      terraform plan
      

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

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

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

         terraform apply
         

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

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

   Ограничения по времени

   Провайдер Terraform ограничивает время на выполнение всех операций с кластером Managed Service for Greenplum® 120 минутами.

   Операции, длящиеся дольше указанного времени, прерываются.

   Как изменить эти ограничения?

   Добавьте к описанию кластера блок timeouts, например:

   resource "yandex_mdb_greenplum_cluster" "<имя кластера>" {
     ...
     timeouts {
       create = "1h30m" # Полтора часа
       update = "2h"    # 2 часа
       delete = "30m"   # 30 минут
     }
   }
   

Чтобы увеличить размер хранилища для кластера, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:

• Идентификатор кластера в параметре clusterId. Чтобы узнать идентификатор, получите список кластеров в каталоге.
• Новый размер хранилища мастера и сегмента в параметрах masterConfig.resources.diskSize и segmentConfig.resources.diskSize.
• Список изменяемых полей конфигурации кластера в параметре updateMask.