Действия сервиса ADB

Антон Васильев

В этой статье описаны действия, доступные для сервиса ADB в веб-интерфейсе ADCM.

Create database

Создает дефолтную базу данных. Название по умолчанию — adb.

Эта база данных требуется для установки большинства расширений ADB. Если вы установили кластер при помощи кластерного действия Install, эта БД создается автоматически. Если вы устанавливали каждый сервис по отдельности, БД не создается автоматически и ее требуется создать вручную при помощи действия Create database.

После того как действие успешно завершилось, вы можете проверить, что БД создана:

  1. Подключитесь к мастер-хосту ADB под учетной записью пользователя gpadmin:

    $ sudo su - gpadmin

  2. Выведите список БД:

    $ psql -l

    В выводе команды должна присутствовать БД adb:

                                   List of databases
   Name    |  Owner  | Encoding |  Collate   |   Ctype    |  Access privileges
-----------+---------+----------+------------+------------+---------------------
 adb       | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 | =Tc/gpadmin        +
           |         |          |            |            | gpadmin=CTc/gpadmin
 postgres  | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 |
 template0 | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 | =c/gpadmin         +
           |         |          |            |            | gpadmin=CTc/gpadmin
 template1 | gpadmin | UTF8     | en_US.utf8 | en_US.utf8 | =c/gpadmin         +
           |         |          |            |            | gpadmin=CTc/gpadmin
(5 rows)

Create role

Добавляет новую роль в кластер.

Окно Create role
Окно Create role

На вкладке Configuration открывшегося окна заполните параметры.

Параметр Описание Значение по умолчанию

Role name

Уникальное имя новой роли

 — 

Role password

Пароль роли. Не может быть пустым

 — 

Allow this role to login

Флаг, определяющий, можно ли использовать роль для подключения к БД. Если значение — true, роль можно воспринимать как пользователя

true

Make role superuser

Флаг, определяющий, является ли роль суперпользователем

false

Allow role to create databases

Флаг, определяющий, может ли роль создавать новые базы данных

false

Allow role to create users/roles

Флаг, определяющий, может ли роль создавать новые роли

false

Allow role create external tables

Флаг, определяющий, может ли роль создавать внешние таблицы

false

Resource Group

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

default_group

Enable auto core dump

Устанавливает сервис Auto Core Dump (systemd-coredump) на хостах мастера, резервного мастера и сегментов. При вызове действия используются следующие значения параметров сервиса:

  • Storage=external — дампы памяти (core dump) будут храниться в директории /var/lib/systemd/coredump/.

  • MaxUse=1024M — удалять старые дампы, если их размер превышает 1 ГБ.

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

$ systemctl status systemd-coredump.socket

Сервис должен иметь статус active (listening):

systemd-coredump.socket - Process Core Dump Socket
     Loaded: loaded (/lib/systemd/system/systemd-coredump.socket; static)
     Active: active (listening) since Thu 2025-09-04 10:24:43 UTC; 21min ago
       Docs: man:systemd-coredump(8)
     Listen: /run/systemd/coredump (SequentialPacket)
   Accepted: 0; Connected: 0;
     CGroup: /system.slice/systemd-coredump.socket

Disable auto core dump

Удаляет сервис Auto Core Dump (systemd-coredump) и его конфигурационные файлы.

Enable mirroring

Включает репликацию данных primary-сегментов путем добавления mirror-сегментов в кластер.

На вкладке Configuration открывшегося окна в списке Type of mirroring выберите тип зеркалирования: распределенное (spread) или групповое (group).

По умолчанию используется распределенное зеркалирование. При выборе такого зеркалирования действие Enable mirroring проверяет, что число сегментных хостов в кластере больше числа сегментов на одном хосте и что число сегментов на хост без остатка делится на число data-каталогов. Если эти условия не выполняются, то действие завершится ошибкой.

Окно Enable mirroring
Окно Enable mirroring

Install diskquota

Устанавливает расширение ADB diskquota. Это расширение предназначено для ограничения дискового пространства, выделяемого под схемы и роли.

Действие создает базу данных diskquota и схему diskquota и регистрирует расширение diskquota.

Чтобы проверить наличие расширения diskquota, выполните следующую команду:

SELECT * FROM pg_extension WHERE extname = 'diskquota';

Результат команды:

  extname  | extowner | extnamespace | extrelocatable | extversion |   extconfig   | extcondition
-----------+----------+--------------+----------------+------------+---------------+--------------
 diskquota |       10 |         2200 | t              | 2.3        | {48320,48328} | {"",""}
(1 row)

После установки diskquota становятся доступными действия Uninstall diskquota и Reinstall diskquota.

Install MADlib

Устанавливает библиотеку MADlib.

Действие создает схему madlib, в которой хранятся функции MADlib.

Чтобы проверить установленную версию, выполните следующую команду:

SELECT madlib.version();

Результат команды:

          version
---------------------------------------------------------------------------------------------------------
 MADlib version: 1.21.0, git revision: 6.27.1_arenadata64-66-gbf5684f4, cmake configuration time: Tue Aug
 19 23:01:09 UTC 2025, build type: RelWithDebInfo, build system: Linux-4.15.0-175-generic, C compiler: gc
c 11, C++ compiler: g++ 11
(1 row)

После установки MADlib становятся доступными действия Uninstall MADlib и Reinstall MADlib.

Install PostGIS

Устанавливает расширение PostGIS.

Чтобы проверить установленную версию PostGIS, выполните следующую команду:

SELECT PostGIS_Lib_Version();

Результат команды:

 postgis_lib_version
---------------------
 2.5.4
(1 row)

После установки PostGIS становятся доступными действия Uninstall PostGIS и Reinstall PostGIS.

Install Plpython3

Устанавливает расширение plpython3u для поддержки процедурного языка PL/Python.

Чтобы проверить наличие расширения plpython3u, выполните следующую команду:

SELECT * FROM pg_extension WHERE extname = 'plpython3u';

Результат команды:

  extname   | extowner | extnamespace | extrelocatable | extversion | extconfig | extcondition
------------+----------+--------------+----------------+------------+-----------+--------------
 plpython3u |       10 |           11 | f              | 1.0        |           |
(1 row)

После установки Plpython3 становятся доступными действия Uninstall Plpython3 и Reinstall Plpython3.

Reconfigure & Restart

Обновляет конфигурацию сервиса в соответствии с параметрами конфигурации.

Действие перезапускает кластер (с помощью команды gpstop -arM fast), если был изменен один из следующих конфигурационных параметров:

  • ADB GPperfmon Extension

  • Interconnect properties → Interconnect type

  • Любой параметр в блоке SSL

Если изменения не касались этих параметров, действие перечитывает конфигурацию без перезапуска всего кластера (с помощью команды gpstop -au).

Флаг Migrate db_files_history table now, доступный в открывшемся окне, определяет необходимость миграции таблицы arenadata_toolkit.db_files_history во время обновления. При установке флага таблица пересоздается с последующей загрузкой данных, а также опций партиционирования/сжатия данных. Для больших таблиц этот процесс может занять длительное время. Сброс флага означает, что миграция будет выполнена позднее вручную либо при следующем обновлении.

Reinstall ADB

Переустанавливает сервис ADB.

На вкладке Configuration открывшегося окна заполните параметры:

  • Reboot cluster servers after installation — флаг, определяющий необходимость автоматической перезагрузки хостов ADB после выполнения действия Reinstall ADB. Значение по умолчанию — true. Если значение — false, перезагрузку потребуется выполнить вручную.

  • Reboot timeout, sec — время ожидания перезагрузки хостов (в секундах). Значение по умолчанию — 1800. Значение не может быть меньше 600.

Окно Reinstall ADB
Окно Reinstall ADB

Start

Запускает сервис ADB.

Stop

Останавливает сервис ADB. На вкладке Configuration открывшегося окна выберите значение параметра ADB shutdown mode:

  • fast — принудительная остановка сервиса после прерывания и отката выполняющихся транзакций, а также закрытия всех активных соединений. Этот режим используется по умолчанию.

  • smart — остановка только в случае отсутствия клиентских соединений к базе данных. Иначе действие завершается с предупреждением.

  • immediate — принудительное завершение процессов PostgreSQL без корректной обработки активных транзакций. Этот режим не рекомендуется к использованию, так как в некоторых случаях может привести к повреждению базы данных.

Run SQL

Выполняет SQL-команду с правами пользователя gpadmin.

Команда выполняется в базе adb или в другой базе, указанной как дефолтной для клиентских подключений.

На вкладке Configuration открывшегося окна в поле SQL query введите SQL-команду.

Окно Run SQL
Окно Run SQL

Чтобы посмотреть результат действия, на странице Jobs нажмите на название действия и перейдите на вкладку Ansible [check] — результат будет в строке SQL query.

Manage tablespace

Создает табличное пространство (tablespace) или изменяет существующие.

Параметр Описание Значение по умолчанию

Name

Уникальное название нового табличного пространства. Название не может начинаться с префикса pg_.

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

pg_default

Path

Каталог, который будет использоваться табличным пространством. При создании нового табличного пространства этот параметр является обязательным. Действие не создает каталог, поэтому он должен существовать на мастер-хосте и каждом сегментном хосте

 — 

Storage device

Если вы хотите разместить табличное пространство на отдельном запоминающем устройстве, укажите имя блочного устройства на мастер-хосте (внутри каталога /dev). ADB создаст файловую систему XFS на этом устройстве, отформатирует устройство и смонтирует его в каталог, указанный в Path

 — 

Use for temporary and transaction files

Флаг, определяющий, нужно ли использовать табличное пространство для хранения временных объектов. Действие добавит табличное пространство в конфигурационный параметр temp_tablespaces.

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

$ gpconfig -s temp_tablespaces

Результат команды:

Values on all segments are consistent
GUC          : temp_tablespaces
Master  value: fast_storage
Segment value: fast_storage

false
Окно Manage tablespace
Окно Manage tablespace
Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней