Управление базами данных в Managed Service for MongoDB
Вы можете добавлять и удалять базы данных, а также просматривать информацию о них.
Получить список баз данных в кластере
- Перейдите на страницу каталога
и выберите сервис Managed Service for MongoDB. - Нажмите на имя нужного кластера, затем выберите вкладку Базы данных.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы получить список баз данных в кластере, выполните команду:
yc managed-mongodb database list
--cluster-name <имя_кластера>
Имя кластера можно запросить со списком кластеров в каталоге.
Чтобы получить список баз данных кластера, воспользуйтесь методом REST API list для ресурса Database или вызовом gRPC API DatabaseService/List и передайте в запросе идентификатор кластера в параметре clusterId
.
Идентификатор кластера можно получить со списком кластеров в каталоге.
Создать базу данных
Примечание
В каждом кластере вы можете создать не более 1000 баз данных.
-
Перейдите на страницу каталога
и выберите сервис Managed Service for MongoDB. -
Нажмите на имя нужного кластера.
-
Выберите вкладку Базы данных.
-
Нажмите кнопку Создать базу данных.
-
Введите имя для базы данных и нажмите кнопку Создать.
Имя базы может содержать латинские буквы, цифры, нижнее подчеркивание и дефис. Максимальная длина имени — 63 символа. Имена
config
,local
,admin
иmdb_internal
зарезервированы для собственных нужд Managed Service for MongoDB. Создавать БД с этими именами нельзя. -
Назначьте роли, разрешающие доступ к созданной базе данных, нужным пользователям кластера.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Выполните команду создания БД, задав имя новой базы:
yc managed-mongodb database create <имя_БД>
--cluster-name <имя_кластера>
Имя базы может содержать латинские буквы, цифры, нижнее подчеркивание и дефис. Максимальная длина имени — 63 символа. Имена config
, local
, admin
и mdb_internal
зарезервированы для собственных нужд Managed Service for MongoDB. Создавать БД с этими именами нельзя.
Имя кластера можно запросить со списком кластеров в каталоге.
Managed Service for MongoDB запустит операцию создания базы данных.
Выдайте разрешение на доступ к созданной базе данных нужным пользователям кластера.
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание кластера.
-
Добавьте ресурс
yandex_mdb_mongodb_database
:resource "yandex_mdb_mongodb_database" "<имя_БД>" { cluster_id = "<идентификатор_кластера>" name = "<имя_БД>" }
Имя базы может содержать латинские буквы, цифры, нижнее подчеркивание и дефис. Максимальная длина имени — 63 символа. Имена
config
,local
,admin
иmdb_internal
зарезервированы для собственных нужд Managed Service for MongoDB. Создавать БД с этими именами нельзя. -
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Подробнее см. в документации провайдера Terraform
Чтобы создать новую базу данных в кластере, воспользуйтесь методом REST API create для ресурса Database или вызовом gRPC API DatabaseService/Create и передайте в запросе:
- Идентификатор кластера, в котором нужно создать базу данных, в параметре
clusterId
. Чтобы получить идентификатор, получите список кластеров в каталоге. - Настройки базы данных в параметре
databaseSpec
.
Чтобы разрешить доступ к созданной базе, воспользуйтесь методом REST API update для ресурса User или вызовом gRPC API UserService/Update.
Удалить базу данных
- Перейдите на страницу каталога
и выберите сервис Managed Service for MongoDB. - Нажмите на имя нужного кластера и выберите вкладку Базы данных.
- Нажмите значок
в строке нужной БД и выберите пункт Удалить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы удалить базу данных, выполните команду:
yc managed-mongodb database delete <имя_БД>
--cluster-name <имя_кластера>
Имя кластера можно запросить со списком кластеров в каталоге.
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание кластера.
-
Удалите ресурс
yandex_mdb_mongodb_database
с именем удаляемой базы данных. -
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Подробнее см. в документации провайдера Terraform
Чтобы удалить базу данных, воспользуйтесь методом REST API delete для ресурса Database или вызовом gRPC API DatabaseService/Delete и передайте в запросе:
- Идентификатор кластера в параметре
clusterId
. Чтобы узнать идентификатор, получите список кластеров в каталоге. - Имя базы данных в параметре
databaseName
.
Важно
Прежде чем создать новую базу с тем же именем, дождитесь завершения операции удаления, иначе будет восстановлена удаляемая база. Статус операции можно получить вместе со списком операций в кластере.