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

Управление базами данных в Managed Service for PostgreSQL

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

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

Важно

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

Получить список баз данных в кластере

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

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

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

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

yc managed-postgresql database list --cluster-name=<имя кластера>

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

Воспользуйтесь методом API list и передайте в запросе идентификатор кластера в параметре clusterId.

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

Создать базу данных

Примечание

В каждом кластере вы можете создать не более 1000 баз данных.

  1. Перейдите на страницу каталога и выберите сервис Managed Service for PostgreSQL.

  2. Нажмите на имя нужного кластера.

  3. Если владельцем новой базы данных должен стать еще не существующий пользователь, создайте его.

  4. Выберите вкладку Базы данных.

  5. Нажмите кнопку Добавить.

  6. Укажите параметры базы данных:

    • Имя.

      Имя базы может содержать латинские буквы, цифры, нижнее подчеркивание и дефис. Максимальная длина имени 63 символа. Имена postgres, template0, template1 зарезервированы для собственных нужд Managed Service for PostgreSQL. Создавать базы с этими именами нельзя.

    • Владелец.

    • (Опционально) Шаблон — имя одной из существующих баз, с которой нужно будет скопировать схему данных. На время создания новой базы все подключения к базе-шаблону будут закрыты.

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

    • Локали сортировки и набора символов.

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

      • Порядок сортировки в запросах с использованием оператора ORDER BY или стандартных операторов сравнения текстовых данных.
      • Функции upper, lower, initcap, а также семейство функций to_char.
      • Операторы поиска по шаблону (LIKE, ILIKE, SIMILAR TO, регулярные выражения).
      • Возможность использовать индексы с оператором LIKE.

      По умолчанию используется локаль C. При использовании кодировки C для текстовых данных с нелатинскими (например, кириллическими) символами возможны ошибки в порядке сортировки данных и отображении данных при поиске по шаблону. Если эта локаль не подходит для корректной обработки таблиц в базе данных, выберите другую из списка. Однако учитывайте, что использование нестандартной локали может снизить скорость выполнения запросов к базе данных.

      Подробнее о настройках локали см. в документации PostgreSQL.

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

  7. Нажмите кнопку Добавить.

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

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

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

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

    yc managed-postgresql database create --help

  2. Запросите список пользователей кластера, чтобы выбрать владельца новой базы данных:

    yc managed-postgresql user list --cluster-name=<имя кластера>

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

  3. Выполните команду создания БД. При необходимости укажите нужные локали сортировки и набора символов (по умолчанию задаются LC_COLLATE=C и LC_CTYPE=C) и шаблон:

    yc managed-postgresql database create <имя базы данных> \
   --cluster-name=<имя кластера> \
   --owner=<имя пользователя-владельца> \
   --lc-collate=<локаль сортировки> \
   --lc-type=<локаль набора символов> \
   --template-db=<имя базы данных, используемой в качестве шаблона>

    Имя базы может содержать латинские буквы, цифры, нижнее подчеркивание и дефис. Максимальная длина имени 63 символа. Имена postgres, template0, template1 зарезервированы для собственных нужд Managed Service for PostgreSQL. Создавать базы с этими именами нельзя.

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

    Managed Service for PostgreSQL запустит операцию создания базы данных.

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

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

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

  2. Добавьте ресурс yandex_mdb_postgresql_database. При необходимости укажите нужные локали сортировки и набора символов (по умолчанию задаются LC_COLLATE=C и LC_CTYPE=C) и шаблон:

    resource "yandex_mdb_postgresql_database" "<имя базы данных>" {
  cluster_id  = "<идентификатор кластера>"
  name        = "<имя базы данных>"
  owner       = "<имя пользователя-владельца: должен быть задан в ресурсе yandex_mdb_postgresql_user>"
  lc_collate  = "<локаль сортировки>"
  lc_type     = "<локаль набора символов>"
  template_db = "<имя базы данных, используемой в качестве шаблона>"
}

    Имя базы может содержать латинские буквы, цифры, нижнее подчеркивание и дефис. Максимальная длина имени 63 символа. Имена postgres, template0, template1 зарезервированы для собственных нужд Managed Service for PostgreSQL. Создавать базы с этими именами нельзя.

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

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

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

      terraform validate

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

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

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

      terraform plan

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

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

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

        terraform apply

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

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

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

Удалить базу данных

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

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

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

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

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

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

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

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

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

  2. Удалите ресурс yandex_mdb_postgresql_database с именем удаляемой базы данных.

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

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

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

      terraform validate

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

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

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

      terraform plan

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

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

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

        terraform apply

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

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

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

Важно

Прежде чем создать новую базу с тем же именем, дождитесь завершения операции удаления, иначе будет восстановлена удаляемая база. Статус операции можно получить вместе со списком операций в кластере.

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