Overview
Te damos la bienvenida al sitio de documentación del driver oficial de MongoDB para C++.
Empezar
Aprenda a instalar el controlador, establecer una conexión a MongoDB y comenzar a trabajar con datos en el Comience con el tutorial del controlador C++.
Conéctese a MongoDB
Aprenda a crear y configurar una conexión a una implementación de MongoDB en la sección Connect to MongoDB.
Operaciones CRUD
Aprenda cómo puede recuperar y escribir datos de MongoDB en la sección Operaciones CRUD.
Transforma tus datos con agregación
Aprenda a utilizar el controlador C++ para realizar operaciones de agregación en la sección Agregación.
Formatos de datos especializados
Aprenda a trabajar con formatos de datos especializados y tipos personalizados en la sección Formatos de datos especializados.
Optimiza queries con índices
Aprenda a trabajar con los tipos comunes de índices en la sección Índices.
Protege tus datos
Aprende sobre las formas en que puede autenticar tu aplicación y cifrar tus datos en la sección Security.
Opciones de instalación avanzadas
Aprende sobre las opciones de configuración e instalación avanzadas en la sección Opciones de configuración e instalación avanzadas.
Incluye y vincula el driver en tu programa
Aprende cómo incluir y vincular el driver en tu programa en la sección Incluir y vincular el driver en tu programa.
Notas de versión
Para obtener una lista de las nuevas características y los cambios en cada versión, consulte la sección Notas de versión.
Actualizar versiones de los controladores
Aprende qué cambios podrías necesitar hacer en su aplicación para actualizar las versiones de los controladores en la sección Actualizar versiones de los controladores.
Problemas y Ayuda
Aprende cómo reportar errores, contribuir al controlador y encontrar ayuda en la sección Problemas y ayuda.
Compatibilidad
Para ver las tablas de compatibilidad que muestran la versión del controlador C++ recomendada para usar con versiones específicas de C++ y MongoDB Server, consulte Compatibilidad.
Documentación de la API
Para obtener información detallada sobre los tipos y métodos en el driver de C++, consulta la documentación de la API del driver de C++.
Configuración de Polyfill en C++17
Importante
Recomendamos utilizar la biblioteca estándar de C++ siempre que sea posible configurando
CMAKE_CXX_STANDARD opción de configuración a 17 o más reciente.
El driver C++ de MongoDB utiliza las funcionalidades std::optional<T> y std::string_view de C++17. Si se configura el driver con un estándar anterior a C++17, la librería bsoncxx proporciona implementaciones polyfill para estas funcionalidades de C++17. El driver utiliza las implementaciones de polyfill bsoncxx cuando la opción de configuración CMAKE_CXX_STANDARD está configurada a un número menor que 17. Por defecto, esta opción está configurada como 11.
Advertencia
La elección de la librería de polyfill tiene un impacto directo en la API pública y la ABI de la librería mongocxx. Cambiar el polyfill puede provocar cambios disruptivos en el código fuente durante la compilación y cambios disruptivos en el binario durante el enlace o la ejecución. Para limitar la dependencia del comportamiento específico de polyfill, se debe evitar el uso de stdx::string_view y stdx::optional<T> con interfaces de librería que no sean bsoncxx y mongocxx.
Estado del controlador por familia y versión
La estabilidad indica si este driver se recomienda para uso en producción. Actualmente, ninguno de los drivers garantiza la estabilidad de la API o ABI.
Para obtener documentación sobre versiones anteriores, consulta la documentación heredada.
Familia/versión | Estabilidad | Desarrollo | Propósito |
|---|---|---|---|
(rama del repositorio principal) | Inestable | Desarrollo activo | Desarrollo de nueva funcionalidad |
mongocxx 4.1.x | Estable | Solo correcciones de errores | Versión de driver C++ estable actual |
mongocxx 4.0.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.11.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.10.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.9.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.8.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.7.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.6.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.5.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.4.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.3.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.2.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.1.x | Estable | Ninguno | Versión de driver C++ estable anterior |
mongocxx 3.0.x | Estable | Ninguno | Versión de driver C++ estable anterior | |
Controlador actual
mongocxx es una reescritura desde cero de un driver C++ para MongoDB basado en libmongoc. Requiere un compilador de C++11. Se sabe que se compila para arquitecturas x86 y x86-64 para Linux, macOS, Windows y FreeBSD.
La librería de drivers mongocxx incluye un paquete bson correspondiente, bsoncxx, que implementa la especificación BSON. Esta librería se puede utilizar de forma autónoma para la serialización y deserialización de objetos incluso cuando no se utiliza MongoDB en absoluto.
Las versiones del driver Mongocxx tienen números de versión como v3.x.y.
Nota
No había drivers v2.x.y C++ para evitar confusiones con los drivers heredados obsoletos-0.0-26compat-2.x.y.
Cómo obtener ayuda
Solicita ayuda en la página Stack Overflow de MongoDB o en la comunidad de Reddit de MongoDB.
Visita nuestros canales de soporte.
Vea cómo informar un error.
Licencia
Los drivers C++ de MongoDB están disponibles bajo los términos de la licencia Apache, versión 2.0.