Быстрое начало: Создание кластера базы данных Azure DocumentDB в портале Azure

В этом кратком руководстве описано, как создать новый кластер Azure DocumentDB. Этот кластер содержит все типичные ресурсы MongoDB: базы данных, коллекции и документы. Кластер предоставляет уникальную конечную точку для различных средств и драйверов для подключения к Azure DocumentDB и выполнения повседневных операций.

Предпосылки

• подписка Azure

  • Если у вас нет подписки Azure, создайте бесплатную учетную запись.

Создание кластера

Чтобы приступить к работе, сначала необходимо создать кластер Azure DocumentDB, который служит основой для хранения данных NoSQL и управления ими.

1. Войдите на портал Azure (https://portal.azure.com).

2. В меню портала Azure или на главной странице выберите Создать ресурс.

3. На новой странице найдите и выберите Azure DocumentDB.

   

4. На странице Создание кластера Azure DocumentDB и в разделе Основы выберите параметр Настройка в разделе Уровень кластера.

   

5. На странице масштабирования настройте эти параметры и нажмите кнопку "Сохранить ", чтобы сохранить изменения на уровне кластера.

   	Ценность
   Уровень кластера	M30 tier, 2 vCore, 8-GiB RAM
   Хранилище на сегмент	128 GiB

   

6. В разделе "Основные сведения" настройте следующие параметры:

   	Ценность
   Subscription	Выберите подписку Azure.
   Группа ресурсов	Создание новой группы ресурсов или выбор существующей группы ресурсов
   Имя кластера	Укажите глобально уникальное имя
   Местоположение	Выбор поддерживаемого региона Azure для подписки
   Версия MongoDB	Выберите 8.0
   Имя администратора	Создание имени пользователя для доступа к кластеру в качестве администратора пользователя
   Пароль	Использование уникального пароля, связанного с именем пользователя

   

   Подсказка

   Запишите значения, используемые для имени пользователя и пароля. Эти значения используются далее в этом руководстве. Дополнительные сведения о допустимых значениях см. в разделе об ограничениях кластера.

7. Выберите Next: Networking.

8. В разделе правил брандмауэра на вкладке "Сеть" настройте следующие параметры:

   	Ценность
   Метод подключения	Public access
   Разрешить общедоступный доступ из служб и ресурсов в Azure к этому кластеру	Enabled

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

   

   Подсказка

   Во многих корпоративных средах IP-адреса компьютера разработчика скрыты из-за VPN или других параметров корпоративной сети. В этих случаях можно временно разрешить доступ ко всем IP-адресам, добавив 0.0.0.0 - 255.255.255.255 диапазон IP-адресов в качестве правила брандмауэра. Используйте это правило брандмауэра только временно в рамках тестирования и разработки подключений.

10. Выберите Review + create.

11. Проверьте настройки, которые вы указали, и затем выберите Создать. Создание кластера занимает несколько минут. Дождитесь завершения развертывания ресурсов.

12. Наконец, выберите "Перейти к ресурсу" , чтобы перейти к кластеру Azure DocumentDB на портале.

Получение учетных данных кластера

Получите учетные данные, используемые для подключения к кластеру.

1. На странице кластера выберите параметр "Строки подключения " в меню ресурсов.

2. В разделе "Строки подключения" скопируйте или запишите значение из поля строки подключения .

Это важно

Строка подключения на портале не включает значение пароля. Вы должны заменить плейсхолдер <password> на учетные данные, введенные при создании кластера, или ввести пароль в интерактивном режиме.

Подключение с помощью MongoDB Shell из раздела 'Быстрый старт'

Чтобы подключиться непосредственно к Azure DocumentDB с помощью MongoDB Shell, воспользуйтесь интерфейсом быстрого запуска на странице ресурса на портале Azure.

1. На странице ресурсов кластера выберите "Быстрый запуск" (предварительная версия) в меню навигации.

2. Затем выберите "Открыть оболочку MongoDB".

3. Подождите, пока не запустится оболочка среды MongoDB.

4. Как только среда будет готова, введите Y, для принятия уведомления.

   Замечание

   Если вы столкнулись с проблемой подключения с помощью MongoDB Shell после принятия уведомления, убедитесь, что Azure Cloud Shell имеет доступ к кластеру.

5. Теперь введите пароль для подключения кластера к Cloud Shell.

Выполнение тестовых запросов

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

1. Проверьте состояние подключения, выполнив connectionStatus команду.

   db.runCommand({connectionStatus: 1})
   

   {
     ...
     ok: 1
   }
   

2. Список баз данных в кластере.

   show dbs
   

3. Переключитесь в определенную базу данных. Замените <database-name> заполнитель именем любой базы данных в кластере.

   use <database-name>
   

   Подсказка

   Например, если имя базы данных равно inventory, то команда будет use inventory.

4. Вывод списка коллекций в базе данных.

   show collections
   

5. Найдите первые пять элементов в определенной коллекции. Замените заполнитель <collection-name> на имя коллекции в вашем кластере.

   db.<collection-name>.find().limit(5)
   

   Подсказка

   Например, если имя коллекции — equipment, то команда будет db.equipment.find().limit(5).

Очистите ресурсы

Когда вы закончите работу с кластером Azure DocumentDB, вы можете удалить созданные ресурсы Azure, чтобы не взимать больше расходов.

1. В строке поиска портал Azure найдите и выберите группы ресурсов.

   

2. В списке выберите группу ресурсов, которую вы использовали для этого быстрого начала.

   

3. На странице группы ресурсов выберите Удалить группу ресурсов.

4. В диалоговом окне подтверждения удаления введите имя группы ресурсов, чтобы убедиться, что она будет удалена. Наконец, выберите "Удалить ", чтобы окончательно удалить группу ресурсов.

   

Связанный контент

• Подключитесь из оболочки MongoDB
• Подключение из Azure Cloud Shell
• Перенос данных в Azure DocumentDB