El La utilidadmongosync crea una conexión entre clústeres MongoDB. mongosync puede conectarse a cualquiera de los siguientes clústeres:
Clústeres alojadosen MongoDB Atlas
un clúster autogestionado y un clúster alojado en Atlas
Esta página proporciona instrucciones para conectar un clúster autogestionado a un clúster de Atlas utilizando MongoDB Mongosync.
Para obtener detalles adicionales sobre cómo conectarse a un clúster Atlas, consulte Conectarse a una implementación de base de datos
Nota
Para obtener el mejor rendimiento, actualice su clúster autoadministrado a la última versión del parche de MongoDB Server antes de la migración. Para obtener más información, consulte Actualizar a la última versión del parche de MongoDB autoadministrado.
Cadenas de conexión
mongosync utiliza una cadena de conexión URI de MongoDB para conectar clústeres autoadministrados:
El esquema de conexión SRV tiene la forma:
mongodb+srv://[username:password@][host.domain.TLD][/defaultauthdb][?options] El esquema estándar de conexión URI tiene la forma:
mongodb://[username:password@]host1[:port1][,...hostN[:portN]][/[defaultauthdb][?options]]
Especifique los nombres de host de las mongod instancias de la misma manera que aparecen enumerados en la configuración del conjunto de réplicas.
Para clústeres fragmentados, especifique los nombres de host de las instancias en mongos mongod lugar de las instancias.
Nota
mongosync no requiere la replicaSet opción.
mongosync Requiere la primary preferencia de lectura para conectarse a los clústeres de origen y destino. Para más información, consulte Opciones de preferencia de lectura.
mongosync utiliza una cadena de conexión URI de MongoDB para conectar clusters en Atlas:
El esquema de conexión SRV tiene la forma:
mongodb+srv://[username:password]@[clusterName].[host].mongodb.net/ Para obtener información sobre cómo encontrar su cadena de conexión SRV en Atlas,consulte Conectarse a su clúster.
El esquema estándar de conexión URI tiene la forma:
mongodb://[username:password]@[clusterName].[host].mongodb.net/
mongosync Requiere la primary preferencia de lectura para conectarse a los clústeres de origen y destino. Para más información, consulte Opciones de preferencia de lectura.
Autenticación
Proporcione datos de autenticación válidos para conectarse a un clúster de MongoDB Atlas. Si aún no tiene un usuario de base de datos Atlas, debe crear un usuario.
Si el clúster de origen o de destino requiere autenticación, debe proporcionar las credenciales correctas al llamar a mongosync.
Roles
El usuario especificado en la cadena de conexión mongosync debe tener los permisos necesarios en los clústeres de origen y destino. Los permisos varían según el entorno y si desea modificar la configuración de bloqueo de escritura o usar la sincronización inversa.
Los permisos autoadministrados para el clúster de origen son:
Tipo de sincronización | Permisos de origen requeridos |
|---|---|
predeterminado | |
Doble bloqueo de escritura | |
Revertir | |
Múltiples reversiones |
Para detalles sobre las funciones del servidor, consulte: Control de acceso basado en roles en implementaciones autogestionadas.
Para actualizar los permisos de usuario, grantRolesToUser consulte:.
Los permisos de Atlas para el clúster de destino son:
Tipo de sincronización | Permisos de destino requeridos |
|---|---|
predeterminado |
|
Doble bloqueo de escritura, reversión o reversiones múltiples |
|
Para obtener detalles sobre los roles de Atlas, consulte: Roles y privilegios integrados.
Para actualizar los permisos de usuario de Atlas, consulte: Administrar el acceso a un proyecto.
Comportamiento
Alojamiento
La mongosync utilidad puede alojarse en su propio hardware, cerca del clúster de origen o de destino. No es necesario que esté alojada en el mismo servidor que una de las mongod u instancias del clúster. Esta flexibilidad permite enviar o recibir mongos mongod datos al clúster de destino mongos con un impacto mínimo en las o instancias que se ejecutan allí.
Estado inicial
Cuando mongosync se conecta, está en el IDLE estado. Debe ejecutar el comando de inicio para iniciar la sincronización.
Limitaciones
Antes de intentar ejecutar mongosync con un clúster Atlas M10+, desactive la Require Indexes for All Queries
Opción para establecer notablescan a false tanto en el clúster de origen como en el de destino.
Ejemplo
Recopilar información de conexión
El clúster de origen,, está alojado en los siguientes servidores ycluster0 puertos:
clusterOne01.fancyCorp.com:20020clusterOne02.fancyCorp.com:20020clusterOne03.fancyCorp.com:20020
El clúster Atlas de destino,, está alojado en los siguientes servidores ycluster1 puertos:
cluster2Name-01.abc123.com:27017cluster2Name-02.abc123.com:27017cluster2Name-03.abc123.com:27017
Hay un usuario administrativo, clusterAdmin configurado en cada clúster, con contraseña, superSecret.
Conecte los clústeres de origen y destino con mongosync
El formato de cadena de conexión genérica para el clúster autoadministrado es:
mongodb://<user>:<password>@<ip-address>:<port>,<ip-address>:<port>,<ip-address>:<port>
El formato genérico de cadena de conexión para el clúster de Atlas es:
mongodb://<user>:<password>@<clusterName>.<hostname>.mongodb.net/
Utilice la información de conexión que recopiló para el clúster autoadministrado para crear las cadenas de conexión para cluster0:
cluster0: mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020
Puede obtener la cadena de conexión del clúster Atlas desde la interfaz de usuario de Atlas. Para obtener más información, consulte Conectarse a una implementación de base de datos.
El siguiente diseño del comando mongosync está modificado para poder visualizarlo. Para conectar cluster0 a cluster1 con mongosync, introduce el siguiente comando en una sola línea:
mongosync \ --cluster0 "mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020" \ --cluster1 "mongodb://clusterAdmin:superSecret@cluster2Name.abc123.mongodb.net"
Los clústeres Atlas requieren conexiones TLS. Para usar mongosync con clústeres Atlas, agregue la opción. Por ejemplo, para conectarse a tls=true la admin base de datos cluster0 en cluster1 y:
mongosync \ --cluster0 "mongodb://clusterAdmin:superSecret@clusterOne01.fancyCorp.com:20020,clusterOne02.fancyCorp.com:20020,clusterOne03.fancyCorp.com:20020/admin?tls=true" \ --cluster1 "mongodb://clusterAdmin:superSecret@cluster2Name.abc123.mongodb.net/admin?tls=true"
También puede usar mongodb+srv cadenas de conexión mongosync con. No es necesario añadir la opción a tls=true una mongodb+srv cadena de conexión. Por ejemplo:
mongosync \ --cluster0 "mongodb+srv://clusterAdmin:superSecret@clusterOne01.fancyCorp.com/" \ --cluster1 "mongodb+srv://clusterAdmin:superSecret@cluster2Name.abc123.mongodb.net/"
Para obtener más detalles sobre las mongodb+srv cadenas de conexión, consulte Formato de conexión SRV.