Importante
Para utilizar la funcionalidad Stable API, debes conectarte a una implementación que ejecute MongoDB Server versión 5.0 o posterior.
Utilizar la funcionalidad de la Stable API solo si todos los servidores MongoDB a los que te conectas admiten esta funcionalidad.
Overview
En esta guía, puedes aprender a especificar la compatibilidad con Stable API al conectar una instancia o un set de réplicas de MongoDB.
La funcionalidad de Stable API obliga al servidor a ejecutar operaciones con comportamientos que sean compatibles con la versión de la API que indiques. Una versión de la API define el comportamiento esperado de las operaciones que cubre y el formato de las respuestas del servidor. Las operaciones y las respuestas del servidor pueden variar según la versión de la API que especifiques.
Cuando utilices la funcionalidad Stable API con un driver oficial de MongoDB, podrás actualizar tu driver o servidor sin preocuparte por problemas de retrocompatibilidad de los comandos cubiertos por la Stable API.
Para aprender más sobre los comandos cubiertos por el servidor, consulte Stable API en el manual del Servidor.
Especifica una versión de API
Para especificar una versión de la API, define una ServerApi struct y configura el campo server_api de su instancia de ClientOptions a este struct. El struct ServerApi contiene la versión de la API y las opciones. Para aprender más sobre cómo configurar opciones, consulte la sección Modificando el comportamiento de esta guía.
Una vez que hayas especificado una versión de API, el cliente solo ejecuta operaciones que sean compatibles con esa versión.
Nota
El driver Rust de MongoDB solo es compatible con la versión 1 de la Stable API.
Ejemplo de especificación de versión de API
El siguiente ejemplo establece la Stable API al instanciar un Client y conectarse a un servidor.
let server_api = ServerApi::builder().version(ServerApiVersion::V1).build(); client_options.server_api = Some(server_api); let client = Client::with_options(client_options)?;
Modificar comportamiento
Se puede modificar el comportamiento de la funcionalidad de la Stable API configurando campos en la estructura ServerApi.
Si bien puedes configurar los campos en una estructura ServerApi manualmente, puedes utilizar el patrón de diseño builder para definir la estructura de manera más eficiente.
Nota
Opciones de instanciación
El controlador Rust implementa el patrón de diseño Builder para la creación de muchos tipos diferentes, incluida la estructura ServerApi. Puedes usar el método builder() de cada tipo para construir una instancia de opciones encadenando funciones constructoras de opciones una tras otra.
Campo | Descripción |
|---|---|
| (Required) The Stable API version to use. Specified with the ServerApiVersion enum. The only
accepted value is V1.Type: ServerApiVersion |
| Indicates whether the server returns errors for features
that aren't part of the API version. Type: boolDefault: false |
| Indicates whether the server returns errors for
deprecated features. Type: boolDefault: false |
Ejemplo de opciones de API estable
Este ejemplo habilita la funcionalidad Stable API con las siguientes especificaciones:
Utiliza la versión 1 de la Stable API
Devuelve errores para funcionalidades que no forman parte de la versión 1.
Devuelve errores para las funcionalidades obsoletas
let mut client_options = ClientOptions::parse(uri)?; let server_api = ServerApi::builder() .version(ServerApiVersion::V1) .strict(true) .deprecation_errors(true) .build(); client_options.server_api = Some(server_api); let client = Client::with_options(client_options)?;
Información Adicional
Para obtener más información sobre cómo conectarse a su instancia o set de réplicas de MongoDB, consulte el Guía de conexión.
Documentación de la API
Para obtener más información sobre los métodos y tipos mencionados en esta guía, vea la siguiente documentación de la API: