› › ›

Практическое руководство по управляемому соединителю MongoDB

В этом руководстве объясняется, как настроить автоматическую, непрерывную синхронизацию из базы данных MongoDB в оптимизированный для поиска индекс в Elastic Cloud. В этом руководстве мы будем использовать развертывание Atlas вместе с встроенными образцами данных, но вы также можете использовать свои собственные данные.

Это руководство является примером:

Использования подключения к MongoDB, которое совместимо с MongoDB Atlas и локальными серверами MongoDB. См. Совместимость.
Использования любого подключения, доступного как управляемое подключение. Рабочий процесс в этом руководстве применим ко всем управляемым подключениям Elastic.

Это руководство состоит из трех основных разделов:

Настройка MongoDB Atlas: Сначала вам необходимо запустить MongoDB Atlas. (Пропустите этот шаг, если у вас уже есть экземпляр MongoDB, который вы хотите использовать.)
- Вы создадите бесплатную учетную запись, настройте бесплатный кластер Atlas и загрузите некоторые образцы данных.
Сбор данных об экземпляре MongoDB После этого вам нужно будет собрать некоторые данные о вашем кластере Atlas, чтобы вы могли подключить его к развертыванию Elastic Cloud.
Настройка Elastic Cloud: Далее вам необходимо запустить Elastic Cloud.
- Затем вам необходимо создать индекс Elasticsearch и настроить подключение Elastic для взаимодействия с вашим кластером Atlas. Мы выполним все это в интерфейсе Kibana.
- После настройки вы зададите расписание синхронизации, чтобы начать индексирование данных MongoDB в Elasticsearch и обеспечить их актуальность.

Настройка MongoDB Atlas

Следуйте инструкциям в документации MongoDB, чтобы создать бесплатную учетную запись Atlas:

Создайте и разверните бесплатный кластер Atlas.
В разделе Безопасность > Доступ к сети добавьте IP-доступ к 0.0.0.0/0. Этот CIDR-запись позволяет подключения с любого IP-адреса. Это позволит подключению Elastic, работающему в Elastic Cloud, получить доступ к Atlas. См. документацию Atlas для получения полных инструкций.
Создайте пользователя базы данных с именем пользователя и паролем. Выберите Добавить нового пользователя базы данных в Безопасность > Доступ к базе данных. Сохраните эти данные, так как вам понадобятся они для настройки подключения позже.

Загрузка образцов данных в Atlas

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

Используйте кнопку Загрузить образец набора данных в интерфейсе Atlas в разделе Развертывания баз данных. Найдите ее, нажав кнопку "…" рядом с именем вашего кластера.

Рисунок 11. Загрузка образцов данных в интерфейсе Atlas

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

Просмотр образцов данных в пользовательском интерфейсе Atlas

После загрузки вы можете просмотреть свои образцы данных в интерфейсе Atlas, выбрав кнопку Просмотреть коллекции развертывания вашей базы данных. Убедитесь, что образцы баз данных были добавлены в развертывание вашей базы данных.

В этом примере мы будем использовать sample_mflix набор данных, содержащий данные о фильмах и кинотеатрах. База данных содержит коллекции определенных метаданных, включая пользователей и комментарии к определенным фильмам. В этом примере мы сосредоточимся на коллекции comments. Каждый документ содержит комментарий и информацию, такую как имя и адрес электронной почты комментирующего.

Sample document from the comments collection

Рисунок 12. Пример документа MongoDB из коллекции comments

Позже, после того, как подключение преобразует документы MongoDB в документы Elasticsearch, вы сможете сравнить их структуру.

Мы добавили данные в наш кластер MongoDB Atlas, и теперь нам нужно настроить подключение Elastic MongoDB.

Сбор данных об экземпляре MongoDB

Прежде чем перейти к работе в Elastic Cloud, нам необходимо собрать некоторые данные о нашем кластере MongoDB Atlas. Эти данные понадобятся для настройки подключения Elastic MongoDB. Вы можете найти эти данные в пользовательском интерфейсе Atlas.

Найдите следующие данные:

Хост: URI вашего кластера MongoDB Atlas. Он должен выглядеть так, как mongodb+srv://<your-cluster-name>.hjksqfc.mongodb.net. Найдите его, подключившись к своему кластеру в пользовательском интерфейсе MongoDB Atlas.
- Один из способов найти этот URI — выбрать Подключиться с MongoDB Shell и скопировать строку подключения из инструкций командной строки.
База данных: имя базы данных, которую вы хотите синхронизировать. В этом примере мы будем использовать базу данных sample_mflix.
Коллекция: имя коллекции, которую вы хотите синхронизировать. В этом примере мы будем использовать коллекцию comments базы данных sample_mflix.
Имя пользователя: имя пользователя, созданное ранее на этапе настройки.
Пароль: пароль, созданный ранее.

Сохраните эти данные!

Настройка Elastic Cloud

Все настроено в MongoDB Atlas, и у нас есть необходимые данные для настройки подключения Elastic MongoDB. Сначала нам нужно запустить развертывание Elastic Cloud.

Создание развертывания Elastic Cloud

Этот шаг предназначен для новых пользователей Elastic Cloud. Пропустите этот шаг, если у вашей команды уже есть развертывание Elastic Cloud.

Войдите в Elastic Cloud и используйте интерфейс для создания развертывания. Вам потребуется версия 8.5.0+ или более поздняя.

См. предварительные условия для управляемых подключений Elastic для получения подробной информации.

После создания развертывания перейдите в раздел Поиск.

Создание индекса Elasticsearch

Подключение Elastic будет синхронизировать ваши данные MongoDB в оптимизированный для поиска индекс Elasticsearch. Первым шагом является создание вашего индекса в пользовательском интерфейсе Kibana.

В главном меню перейдите к Поиск > Контент > Индексы или используйте поле глобального поиска.

Следуйте этим шагам для создания вашего индекса:

Выберите Создать индекс Elasticsearch.
Выберите Подключение в качестве метода извлечения данных.
Выберите тип подключения MongoDB.
Назовите новый индекс, например search-mongo-sample, затем сохраните. Это переводит вас на вкладку Настройка страницы обзора вашего индекса.

Далее нам нужно ввести данные Atlas для настройки подключения.

Настройка подключения MongoDB

Используя данные, собранные ранее, настройте подключение MongoDB. Введите данные на шаге Настройка.

Установите опцию Прямое подключение в false для этого примера. Для MongoDB Atlas необходимо включить SSL/TLS, поэтому включите опцию Подключение SSL/TLS.

Example configuration for the MongoDB connector

Рисунок 13. Пример конфигурации подключения MongoDB

После ввода этих данных выберите Сохранить конфигурацию.

Начало синхронизации

После настройки подключения MongoDB пришло время запланировать синхронизацию.

Интерфейс переведет вас на вкладку Расписание страницы обзора вашего индекса. В этом примере мы запланируем повторяющуюся синхронизацию, которая будет выполняться ежедневно в полночь.

На вкладке Расписание:

Переключить Включить повторяющиеся синхронизации по следующему расписанию.
Выбрать Частоту, "Еже" day.
Выбрать Время, "В" 00:00.
Сохранить это расписание синхронизации.

После сохранения расписания синхронизации соединитель начнет синхронизировать данные MongoDB Atlas в Elasticsearch.

Проверить документы

В нашей документации по справке описано, как документы в вашей базе данных и коллекции MongoDB извлекаются и преобразуются в документы в вашем индексе Elasticsearch.

Если все параметры конфигурации верны, синхронизация начнется, и документы начнут появляться в вашем индексе Elasticsearch.

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

В Kibana перейдите к Поиск > Содержание > Индексы в главном меню или используйте поле глобального поиска.
Выберите свой индекс, например search-mongo-sample.
Выберите вкладку Документы, чтобы просмотреть синхронизированные документы. Разверните документ, чтобы просмотреть его поля.

Узнать больше

Обратитесь к справочной документации по подключению Elastic MongoDB за подробной информацией о соединителе, включая то, как работают правила синхронизации.
Обзор всех управляемых соединителей Elastic см. в Управляемые соединители Elastic.
Узнайте о Правилах синхронизации для управляемых соединителей Elastic.
Узнайте об справочных конвейерах для индексов поиска
Обратитесь к официальной документации MongoDB Atlas для вопросов, специфичных для MongoDB.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/es-mongodb-start.html