Nota
La función API estable requiere MongoDB Server 5.0 o posterior.
Overview
En esta guía, puedes aprender a especificar la compatibilidad de la API estable al conectarse a una implementación de MongoDB.
La función API estable obliga al servidor a ejecutar operaciones con comportamientos compatibles con la versión de API que especifique. Al actualizar el controlador o el servidor, la versión de API cambia, lo que puede modificar el comportamiento de estas operaciones. El uso de la API estable garantiza respuestas consistentes del servidor y proporciona estabilidad de API a largo plazo para su aplicación.
Las siguientes secciones describen cómo habilitar y personalizar la API estable para su cliente MongoDB. Para obtener más información sobre la API estable, incluyendo una lista de los comandos que admite, consulte API estable en el manual del servidor MongoDB.
Activar la API estable
Para habilitar la API estable, realice los siguientes pasos:
Construir una
ServerApiobjeto y especifique una versión estable de la API. Debe usar una versión estable de la API definida en la enumeraciónServerApiVersion.Construya un objeto
MongoClient, pasando su objetoServerApipara el argumentoserver_api.
El siguiente ejemplo de código muestra cómo especificar la versión de API estable 1. Seleccione la opción Synchronous o pestaña Asynchronous para ver el código correspondiente:
from pymongo import MongoClient from pymongo.server_api import ServerApi client = MongoClient("mongodb://<db_username>:<db_password>@<hostname:<port>", server_api=ServerApi("1"))
from pymongo import AsyncMongoClient from pymongo.server_api import ServerApi client = AsyncMongoClient("mongodb://<db_username>:<db_password>@<hostname:<port>", server_api=ServerApi("1"))
Una vez creada una instancia MongoClient con una versión de API específica, todos los comandos que ejecute con el cliente usarán dicha versión. Si necesita ejecutar comandos con más de una versión de la API estable, cree una instancia MongoClient.
Configurar la API estable
La siguiente tabla describe los parámetros de la clase ServerApi. Puede usarlos para personalizar el comportamiento de la API estable.
Nombre de la opción | Descripción |
|---|---|
estricto | Optional. When True, if you call a command that isn't part of
the declared API version, the driver raises an exception.Default: False |
errores de deprecación | Optional. When True, if you call a command that is deprecated in the
declared API version, the driver raises an exception.Default: False |
El siguiente ejemplo de código muestra cómo usar estos parámetros al construir un objeto ServerApi. Seleccione la pestaña Synchronous o Asynchronous para ver el código correspondiente:
from pymongo import MongoClient from pymongo.server_api import ServerApi client = MongoClient("mongodb://<db_username>:<db_password>@<hostname:<port>", server_api=ServerApi("1", strict=True, deprecation_errors=True))
from pymongo import AsyncMongoClient from pymongo.server_api import ServerApi client = AsyncMongoClient("mongodb://<db_username>:<db_password>@<hostname:<port>", server_api=ServerApi("1", strict=True, deprecation_errors=True))
Solución de problemas
Campo no reconocido 'apiVersion' en el servidor
PyMongo genera esta excepción si especifica una versión de API y se conecta a un servidor MongoDB que no es compatible con la API estable. Asegúrese de conectarse a una implementación con MongoDB Server v5.0 o posterior.
Se proporcionó apiStrict:true, pero el recuento de comandos no está en la versión de API
PyMongo genera esta excepción si su MongoClient ejecuta una operación que no está en la versión de la API estable especificada. Para evitar este error, utilice una operación alternativa compatible con la versión de la API estable especificada o configure la opción strict como False al construir su objeto ServerApi.
Documentación de la API
Para obtener más información sobre el uso de la API estable con PyMongo, consulte la siguiente documentación de la API: