Preguntas más frecuentes sobre Azure DocumentDB (con compatibilidad con MongoDB)

Obtenga respuestas a las preguntas más frecuentes sobre Azure DocumentDB (con compatibilidad con MongoDB): qué es, cómo es compatible con MongoDB, el ahorro de TCO factible y cómo migrar.

General

¿Qué es Azure DocumentDB?

Azure DocumentDB (con compatibilidad con MongoDB) es una base de datos de documentos totalmente administrada compatible con MongoDB en Azure. Los controladores, herramientas y código de aplicación existentes de MongoDB se conectan sin cambios y Azure DocumentDB admite 99.03% de operadores de MongoDB. Azure DocumentDB se basa en DocumentDB, una base de datos de documentos de código abierto que se rige por Linux Foundation, publicada bajo la licencia MIT y basada en PostgreSQL. Para obtener una introducción, consulte ¿Qué es Azure DocumentDB?.

¿Azure DocumentDB es un reemplazo para MongoDB?

Sí, para la mayoría de las aplicaciones. Azure DocumentDB implementa el protocolo de conexión de MongoDB, por lo que los controladores de MongoDB, MongoDB Compass, el shell de MongoDB (mongosh) y marcos como Mongoose y Spring Data se conectan sin cambios en el código. Azure DocumentDB admite 99.03% de operadores de consulta, proyección, actualización y agregación de MongoDB. Para comprobar su propia carga de trabajo, ejecute la evaluación de compatibilidad gratuita en la extensión de migración de Azure DocumentDB para Visual Studio Code. Consulte Compatibilidad de MongoDB.

¿Qué cargas de trabajo son más adecuadas para Azure DocumentDB?

Azure DocumentDB se adapta a cualquier carga de trabajo que se ejecute en MongoDB hoy: aplicaciones operativas y transaccionales, back-ends web y móviles, administración de contenido y catálogos, análisis en tiempo real con canalizaciones de agregación y aplicaciones de inteligencia artificial que usan búsqueda vectorial. Azure DocumentDB es la opción administrada recomendada para los equipos que mueven MongoDB desde Azure máquinas virtuales, MongoDB Atlas, Amazon DocumentDB o servidores locales.

¿Hay categorías de cargas de trabajo más allá de MongoDB para las que Azure DocumentDB es adecuada?

Azure DocumentDB es adecuado para las nuevas aplicaciones y cargas de trabajo controladas por agentes que necesitan empezar a trabajar rápidamente, iterar rápidamente y escalar de forma eficaz. Proporciona un almacén de datos de documentos integrado, una base de datos vectorial (con DiskANN) y funcionalidades de búsqueda, todo ello administrado y contenido en el mismo despliegue. Esto hace que la creación de nuevas aplicaciones y marcos basados en agentes sea muy eficaz.

¿Cómo se relaciona Azure DocumentDB con Azure Cosmos DB?

Azure DocumentDB se denominaba anteriormente Azure Cosmos DB basada en vCore para MongoDB. Se convirtió en su propia oferta distinta para alinearse con el proyecto DocumentDB de código abierto que lo impulsa. El cambio de nombre no cambió los clústeres, las cadenas de conexión ni las API existentes. Azure DocumentDB y Azure Cosmos DB para MongoDB (RU) son servicios independientes: Azure DocumentDB usa clústeres basados en núcleo virtual dedicados y Azure Cosmos DB para MongoDB (RU) usa el rendimiento basado en unidades de solicitud.

¿Es Azure DocumentDB igual que Amazon DocumentDB?

No. Azure DocumentDB y Amazon DocumentDB son servicios no relacionados de distintas empresas. Azure DocumentDB es un servicio de Microsoft Azure basado en el motor de DocumentDB de código abierto y admite 99.03% de operadores de MongoDB. Azure DocumentDB tampoco está relacionado con el servicio original Azure DocumentDB de 2014 a 2017, que se convirtió en Azure Cosmos DB. Puede migrar de Amazon DocumentDB a Azure DocumentDB. Consulte Opciones de migración.

¿Se aplica la licencia SSPL de MongoDB a Azure DocumentDB?

No. Azure DocumentDB no ejecuta el servidor de bases de datos de MongoDB ni su código base, por lo que no se aplica la licencia pública del lado servidor (SSPL) de MongoDB. Azure DocumentDB se basa en el motor de DocumentDB de código abierto, que se publica bajo la licencia MIT permisiva.

¿Puedo ejecutar la misma base de datos local o en otras nubes?

Yes. El motor de DocumentDB de código abierto que impulsa Azure DocumentDB se ejecuta de forma local y en cualquier nube a través del operador de Kubernetes de DocumentDB. Las aplicaciones usan los mismos controladores y interfaces compatibles con MongoDB en todas partes, y Azure DocumentDB admite la replicación y la conmutación por error entre nubes con DocumentDB autohospedado.

¿Cómo puedo empezar a trabajar con Azure DocumentDB?

Comience con el nivel gratis, que proporciona un clúster dedicado con 32 GB de almacenamiento sin costo alguno. Puede crear un clúster desde el portal de Azure, el CLI de Azure, Bicep o Terraform. Consulte Azure nivel gratis de DocumentDB, Inicio rápido: Azure portal e Inicio rápido: Bicep.

¿Ofrece Azure DocumentDB un acuerdo de nivel de servicio (SLA)?

Yes. Azure DocumentDB ofrece un Acuerdo de Nivel de Servicio de disponibilidad de 99.995% para configuraciones de alta disponibilidad. El Acuerdo de Nivel de Servicio cubre la pila completa: la base de datos, el cómputo, el almacenamiento y las redes. Los clústeres del nivel gratuito y los clústeres sin alta disponibilidad tienen términos diferentes. Para obtener más información, consulte el SLA for servicios en línea.

Coste y precios

¿Cómo funcionan los precios para Azure DocumentDB?

Los precios de Azure DocumentDB se basan en dos cosas: cómputo (el nivel de clúster, en núcleos virtuales y memoria) y el almacenamiento. El cómputo y el almacenamiento se escalan de forma independiente. No hay ninguna unidad de solicitud, ningún cargo por E/S por operación y ningún cargo independiente por copias de seguridad o almacenamiento de alto rendimiento. La capacidad reservada ahorra hasta 40% con un compromiso de un año y hasta 60% con tres años y Azure DocumentDB es apta para el plan de ahorro para las bases de datos. Consulte Azure precios de DocumentDB.

¿Cuánto más barato es Azure DocumentDB que MongoDB Atlas?

Azure DocumentDB cuesta al menos un 40% menos que MongoDB Atlas para una capacidad de proceso equivalente. La mayoría de los clientes ahorran más de 50% en total, ya que Azure DocumentDB no cobra por separado por las copias de seguridad o las redes. Para obtener una comparación de características por característica, consulte Comparar Azure DocumentDB con MongoDB Atlas.

¿Qué se incluye en el precio sin costo adicional?

Azure DocumentDB incluye estos elementos sin costo adicional:

  • Copias de seguridad, con restauración a un momento dado durante un máximo de 35 días para los niveles de producción (M30 y SKU de mayor tamaño).
  • Almacenamiento premium ssd v2 de alto rendimiento.
  • Búsqueda de texto integrada y búsqueda vectorial, sin ningún nivel de búsqueda independiente.
  • Soporte técnico a través del plan existente de Soporte técnico de Azure.
  • La extensión de migración y evaluación de compatibilidad de Azure DocumentDB.

¿Puedo reducir los costos de los entornos de desarrollo y pruebas?

Yes. Azure DocumentDB permite ejecutar clústeres sin alta disponibilidad para desarrollo y pruebas, lo que cuesta menos de un clúster de producción de alta disponibilidad. También puede usar el nivel gratis para desarrollo, pruebas y cargas de trabajo pequeñas.

¿Azure DocumentDB cuenta para mi compromiso de Azure?

Azure DocumentDB es un servicio de Azure de primera entidad, por lo que el uso aparece en la factura de Azure y está cubierto por el plan de Soporte técnico de Azure.

Free tier

¿Azure DocumentDB tiene un nivel gratuito?

Yes. El nivel gratuito de Azure DocumentDB proporciona un clúster dedicado con 32 GB de almacenamiento, gratis durante la vigencia de la cuenta de Azure. Es 64 veces el almacenamiento del nivel gratis de MongoDB Atlas, que ofrece 512 MB. Los clústeres de nivel gratis se aprovisionan en segundos. Cada suscripción de Azure puede tener un clúster de nivel gratuito. Consulte nivel gratuito de Azure DocumentDB.

¿Cuáles son los límites del nivel gratis?

El nivel gratis Azure DocumentDB no incluye alta disponibilidad, autenticación Microsoft Entra ID, copia de seguridad y restauración, índices de vectores DiskANN o HNSW ni registro de diagnóstico. Azure DocumentDB pone en pausa los clústeres de nivel gratis después de 60 días de inactividad. El nivel gratis está disponible en un subconjunto de regiones de Azure. Consulte nivel gratuito de Azure DocumentDB para obtener la lista actual. El nivel gratis está pensado para usarse para la validación funcional y la creación de prototipos en fases tempranas. Para cualquier cosa más grande, se recomienda pasar a un plan de pago.

¿Puedo actualizar un clúster de nivel gratis a un nivel de pago?

Yes. Puede actualizar un clúster de nivel gratuito de Azure DocumentDB a cualquier nivel de pago en el mismo clúster. Los datos, cadena de conexión y las reglas de red permanecen iguales. No se puede volver a mover un clúster de pago al nivel gratis.

Compatibilidad de MongoDB

¿Qué versiones y características de MongoDB admite Azure DocumentDB?

Azure DocumentDB admite las versiones 5.0, 6.0, 7.0 y 8.0 del protocolo wire de MongoDB, y el 99,03 % de los operadores de consulta, proyección, actualización y agregación de MongoDB. Los recuentos porcentuales se basan en los operadores de MongoDB compatibles de cara al usuario. Excluye los comandos administrativos, que Azure DocumentDB administra como servicio de plataforma. Para obtener más información, consulte Compatibilidad del lenguaje de consulta de MongoDB (MQL) y compatibilidad de características de MongoDB.

¿Son compatibles los controladores y herramientas de MongoDB con Azure DocumentDB?

Yes. Cualquier controlador que admita el protocolo de conexión de MongoDB se conecta a Azure DocumentDB, incluidos los controladores oficiales de MongoDB para Node.js, Python, Java, .NET, Go y otros lenguajes. También funcionan herramientas como MongoDB Compass y el shell de MongoDB (mongosh). No se admiten motores de almacenamiento específicos de MongoDB ni extensiones del lado servidor, ya que Azure DocumentDB no ejecuta el servidor de MongoDB.

¿Hay alguna diferencia en el comportamiento que debería esperar después de la migración?

La mayoría de las aplicaciones se comportan igual. Las diferencias pueden aparecer en algunos comandos administrativos, que Azure DocumentDB administra por usted y en el pequeño conjunto de operadores que no se admiten. Ejecute la evaluación de compatibilidad antes de migrar y pruebe la carga de trabajo en un clúster de ensayo. Consulte Compatibilidad de MongoDB para obtener la lista de operadores no admitidos.

¿Cómo puedo comprobar que mi aplicación es compatible antes de migrar?

Ejecute la evaluación de compatibilidad gratuita en la extensión de migración de Azure DocumentDB para Visual Studio Code. Examina la implementación de MongoDB de origen e informa de características, comandos, sintaxis de consulta y tipos de índice no admitidos. A continuación, ejecute las pruebas de integración en un clúster de prueba, que puede ser un clúster de nivel gratuito. Consulte Evalúe y planifique la preparación para la migración.

Migration

¿Puedo migrar mi base de datos de MongoDB existente a Azure DocumentDB?

Yes. Azure DocumentDB admite migraciones desde MongoDB Atlas en cualquier nube, Amazon DocumentDB, MongoDB autohospedado en máquinas virtuales y MongoDB autohospedado localmente. Las herramientas de migración son gratuitas. Consulte Opciones de migración.

¿Qué herramientas puedo usar para migrar a Azure DocumentDB?

Puede usar cualquiera de estas herramientas:

¿Puedo migrar sin tiempo de inactividad?

Sí, con un tiempo de inactividad mínimo. Una migración en línea copia los datos y, a continuación, mantiene el destino sincronizado con el origen a través de flujos de cambio mientras la aplicación sigue ejecutándose. Cambia la aplicación a Azure DocumentDB en la transición. La migración en línea requiere que los flujos de cambio estén habilitados en el origen y un oplog lo suficientemente grande como para cubrir la ventana de migración.

¿Cómo puedo migrar de MongoDB Atlas a Azure DocumentDB?

Ejecute la evaluación de compatibilidad, cree un clúster de Azure DocumentDB con el tamaño de la carga de trabajo y, a continuación, ejecute una migración en línea con la extensión de migración o Azure Database Migration Service. Los clústeres de Atlas en Azure, AWS y Google Cloud son orígenes compatibles. Consulte Opciones de migración.

¿Cómo puedo migrar de Amazon DocumentDB a Azure DocumentDB?

Habilite los flujos de cambio en el clúster de Amazon DocumentDB, ejecute la evaluación de compatibilidad y, a continuación, ejecute una migración en línea con la extensión de migración o Azure Database Migration Service. Consulte Opciones de migración.

Security

¿Cómo se protegen los datos en reposo en Azure DocumentDB?

Azure DocumentDB cifra todos los datos en reposo de forma predeterminada. Puede usar claves administradas por el servicio (SMK) o claves administradas por el cliente (CMK) para una capa adicional de cifrado. Consulte Cifrado en reposo.

¿Qué cifrado de nivel de transporte usa Azure DocumentDB?

Azure DocumentDB exige la seguridad de la capa de transporte (TLS) para todas las conexiones de cliente y servicio. Asegúrese de que los clientes usan las versiones actuales de TLS y los certificados raíz de confianza.

¿Cómo se administra la autenticación y el control de acceso?

Azure DocumentDB admite la autenticación nativa (integrada) y Microsoft Entra ID para la administración centralizada de identidades y acceso. Puede crear roles y usuarios pormenorizados en el nivel de base de datos y colección, y usar identidades administradas para la autenticación entre servicios. Consulte la autenticación de Microsoft Entra ID y los procedimientos recomendados de seguridad.

Yes. Las reglas de firewall restringen el acceso público y Azure Private Link expone el clúster de DocumentDB de Azure a través de puntos de conexión privados en la red virtual. Los puntos de conexión privados son accesibles desde recursos de red virtual y desde redes locales conectadas a esa red virtual. Consulte Uso de Azure Private Link y Administración del acceso público.

¿Cómo se deben administrar las claves de cifrado al usar CMK?

Cuando se usan claves administradas por el cliente con Azure DocumentDB, se administra el ciclo de vida de la clave en Azure Key Vault. Siga estos procedimientos:

  • Habilite el registro y las alertas en el almacén de claves.
  • Bloquee el recurso del almacén de claves.
  • Planee la rotación de claves.
  • Asegúrese de que Azure DocumentDB tiene acceso de red al almacén de claves para recuperar la clave.

Para obtener más información, consulte Configuración de CMK.

¿Cuáles son los procedimientos recomendados de supervisión y registro de seguridad?

Supervise y alerte sobre las métricas gratuitas de Azure DocumentDB a través de Azure Monitor o supervisión detallada del nivel de solicitud en Log Analytics, lo que conlleva un costo en el área de trabajo de Log Analytics. Audite las acciones administrativas y configure alertas para actividades sospechosas. El registro de diagnóstico no está disponible en el nivel gratis.

Connectivity

¿Cómo se conectan los clientes a un clúster de Azure DocumentDB?

Los clientes se conectan con controladores estándar de MongoDB mediante el cadena de conexión del clúster. Puede conectarse a través del punto de conexión público, protegido por reglas de firewall o de forma privada a través de Private Link. Consulte los inicios rápidos del lenguaje para obtener ejemplos, como Inicio rápido: Node.js.

¿Qué opciones existen para restringir el acceso a la red?

Use reglas de firewall de clúster para restringir las direcciones IP de origen, Private Link para crear puntos de conexión privados en las redes virtuales y grupos de seguridad de red y emparejamiento de redes virtuales para un control más preciso. Consulte Administración del acceso público y Uso de Azure Private Link.

¿Puedo conectarse desde redes locales?

Yes. Los recursos locales conectados a través de VPN o Azure ExpressRoute a una red virtual emparejada pueden acceder a los puntos de conexión de Private Link de Azure DocumentDB. También puede usar el punto de conexión público con reglas de firewall, pero se recomienda la conectividad privada para cargas de trabajo de producción.

¿Cómo se configuran las cadenas de conexión y los valores del controlador?

Use el formato estándar de cadena de conexión de MongoDB con su controlador. Incluya opciones para TLS y su mecanismo de autenticación (nombre de usuario y contraseña o Microsoft Entra ID). Consulte los inicios rápidos específicos del lenguaje para obtener ejemplos.

¿Cómo puedo reducir la latencia para los usuarios en varias regiones?

La distancia de red entre la aplicación y el clúster afecta a la latencia. Implemente el clúster de Azure DocumentDB en la misma región que la aplicación y agregue réplicas de lectura localmente o en otras regiones para los usuarios en otros lugares. Consulte Procedimientos recomendados de alta disponibilidad y replicación.

Rendimiento y escalado

¿Cómo se escala el rendimiento en Azure DocumentDB?

Amplíe un clúster de Azure DocumentDB eligiendo un nivel de clúster superior con más vCores y memoria, y amplíe el almacenamiento por separado a medida que crezcan sus datos. Escale horizontalmente añadiendo fragmentos. Dado que la capacidad de procesamiento y el almacenamiento se escalan de forma independiente, no es necesario comprar más capacidad de procesamiento solo para obtener más almacenamiento. Consulte Escalado o configuración de un clúster.

¿Puedo reducir el tamaño de almacenamiento de mi clúster?

No. El tamaño del almacenamiento solo se puede aumentar, no disminuir.

¿Cuándo debo particionar mis datos?

La mayoría de las cargas de trabajo no necesitan fragmentación hasta que una base de datos alcance varios terabytes, ya que un único nodo de Azure DocumentDB admite hasta 32 TB de almacenamiento. Al particionar, elija una clave de partición con alta cardinalidad e incluso distribución. Puede fragmentar colecciones existentes en línea, sin tiempo de inactividad. Consulte Particionamiento e indexación.

¿Puede el mismo clúster de Azure DocumentDB admitir colecciones particionadas y sin fragmentar?

Sí, y este es un patrón común. Los clústeres de DocumentDB de varias particiones Azure pueden admitir colecciones sin particiones en las que las colecciones no se distribuyen entre particiones y residen completamente en un solo nodo. En esta configuración, se pueden separar varias colecciones grandes en distintos nodos, lo que permite un mejor uso y administración de recursos. Además, las colecciones más grandes se pueden particionar, mientras que las colecciones más pequeñas permanecen sin particiones. Por último, todas las colecciones se pueden particionar y distribuir entre las particiones físicas del clúster de Azure DocumentDB.

¿Cuáles son los procedimientos recomendados para la indexación y el rendimiento de las consultas?

Cree índices que coincidan con los patrones de consulta, evite exploraciones sin límite y revise los planes de consulta con explain() para buscar cuellos de botella. Utiliza Index Advisor para obtener recomendaciones sobre consultas comunes. Consulte Cómo leer explain out.

¿Cómo se supervisan y solucionan problemas de rendimiento?

Use las métricas de Azure Monitor para CPU, memoria, almacenamiento e IOPS, y registros de diagnóstico para capturar consultas lentas. Consulte Métricas de supervisión y Solucionar problemas comunes.

¿Puede Azure DocumentDB gestionar un alto rendimiento de lectura y escritura?

Yes. Azure DocumentDB controla las cargas de trabajo de alto rendimiento cuando el nivel de clúster, el almacenamiento y el diseño de particiones coinciden con la carga de trabajo. Escale la capacidad de proceso para obtener más rendimiento, agregue particiones para distribuir escrituras y agregue réplicas de lectura para distribuir lecturas.