Подключиться
Yandex Managed Service for PostgreSQL

Управление PostgreSQL-расширениями

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

Managed Service for PostgreSQL поддерживает многие стандартные расширения PostgreSQL и некоторые нестандартные. Полный список доступных расширений приведен ниже.

Важно

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

Получить список расширений

  1. Перейдите на страницу каталога и выберите сервис Managed Service for PostgreSQL.
  2. Нажмите на имя нужного кластера и выберите блок Базы данных.
  3. В колонке Расширения PostgreSQL будет отображаться список расширений, подключенных к каждой базе данных.

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

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

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

$ yc managed-postgresql database get <имя базы данных> \
     --cluster-name <имя кластера>

Включенные расширения будут перечислены в списке extensions.

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

Изменить список расширений

  1. Перейдите на страницу каталога и выберите сервис Managed Service for PostgreSQL.
  2. Нажмите на имя нужного кластера и выберите вкладку Базы данных.
  3. В строке с нужной базой данных нажмите значок и выберите пункт Настроить расширения PostgreSQL.
  4. Выберите необходимые расширения и нажмите кнопку Изменить.

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

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

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

$ yc managed-postgresql database update <имя базы данных> \
     --cluster-name <имя кластера>
     --extensions <имя расширения>=<версия>,<имя расширения>=<версия>...

Примечание

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

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

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

  2. Добавьте к описанию кластера Managed Service for PostgreSQL один или несколько блоков extension в секции database, соответствующей нужной базе данных (по одному блоку на каждое расширение):

    resource "yandex_mdb_postgresql_cluster" "<имя кластера>" {
  ...
  database {
    ...
    extension {
      name    = "<имя расширения>"
      version = "<версия расширения>"
    }
    ...
  }
  ...

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

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

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

      terraform plan

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

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

    1. Если в конфигурации нет ошибок, выполните команду:

      terraform apply

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

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

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

Поддерживаемые расширения PostgreSQL

Полный список поддерживаемых расширений:

В этой статье: