Para agentes de IA: hay un índice de documentación disponible en https://www.mongodb.com/es/docs/llms.txt — versiones en markdown de todas las páginas están disponibles agregando .md a cualquier ruta URL.

Especifica opciones de conexión

Esta página describe las opciones de conexión disponibles en el driver C y explica cómo especificarlas para su conexión a MongoDB mediante el uso de una cadena de conexión o una opción de URI.

Las siguientes secciones describen las formas en las que puedes especificar las opciones de conexión.

Si pasas una cadena de conexión a la estructura monogoc_client_t, puedes incluir opciones de conexión en la cadena como pares <name>=<value>. En el siguiente ejemplo, la cadena de conexión contiene la opción connectTimeoutMS con un valor de 60000 y la opción tls con un valor de true:

mongoc_init(); // Specifies the connection options in the connection stringconst char *uri = "mongodb+srv://localhost:27017/?connectTimeoutMS=60000&tls=true"; // Creates a new clientmongoc_client_t *client = mongoc_client_new_from_uri_with_error(uri, &error); if (!client) { fprintf(stderr, "%s\n", error.message); goto cleanup;} // Use client... cleanup: mongoc_client_destroy(client); mongoc_uri_destroy(uri);

Para aprender más sobre las opciones que puedes especificar en una cadena de conexión, consulta Opciones de cadena de conexión en el manual del MongoDB Server.

Puedes utilizar opciones URI para configurar los ajustes de conexión en el código en lugar de en una cadena de conexión. Configurar la conexión de esta manera facilita el cambio de ajustes en tiempo de ejecución, ayuda a detectar errores durante la compilación y proporciona más opciones de configuración que la cadena de conexión.

Para configurar las opciones de conexión utilizando la opción URI, realiza los siguientes pasos:

  1. Crea una estructura mongoc_uri_t con tu cadena de conexión

  2. Se puede usar una función de configuración de URI para indicar la opción de conexión deseada

  3. Crea un nuevo cliente con el URI pasando el URI a mongoc_client_new_from_uri()

El siguiente ejemplo de código muestra cómo realizar los pasos anteriores:

mongoc_uri_t *uri = mongoc_uri_new_with_error("mongodb+srv://localhost:27017/", &error); if (!uri) { fprintf(stderr, "%s\n", error.message); goto cleanup;} // Specifies the connection options by using the URI options APIif (!mongoc_uri_set_option_as_int32(uri, MONGOC_URI_CONNECTTIMEOUTMS, 60000)) { fprintf(stderr, "Failed to set '%s'\n", MONGOC_URI_CONNECTTIMEOUTMS); goto cleanup;} if (!mongoc_uri_set_option_as_bool(uri, MONGOC_URI_TLS, true)) { fprintf(stderr, "Failed to set '%s'\n", MONGOC_URI_TLS); goto cleanup;} // Creates a new clientclient = mongoc_client_new_from_uri_with_error(uri, &error); if (!client) { fprintf(stderr, "%s\n", error.message); goto cleanup; } // Use client... cleanup: mongoc_client_destroy(client); mongoc_uri_destroy(uri);

Especifica si se debe forzar el despacho de todas las operaciones al host. Si especifica esta opción, el driver no acepta el formato de conexión SRV. En su lugar, debe utilizar el formato URI de conexión estándar. Para obtener más información sobre la conexión SRV y los formatos de conexión estándar, consulte la guía Cadenas de conexión en el manual de MongoDB Server.

Esta propiedad debe establecerse en false si se especifica más de un nombre de host.

Tipo de dato: boolean

Valor por defecto: false

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb://localhost:27017/?directConnection=true");

El nombre del set de réplicas al que conectarse.

Tipo de dato: char*

Valor por defecto: NULL

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?replicaSet=yourReplicaSet");

Especifica si se debe requerir TLS para las conexiones al servidor. Si usas un esquema de "mongodb+srv" o especificas otras opciones de TLS, esta opción será por defecto true. En caso contrario, el valor será por defecto false.

Tipo de dato: boolean

Valor por defecto: false

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?tls=true");

Especifica si relajar las restricciones de TLS tanto como sea posible. Esto puede incluir permitir certificados no válidos o discrepancias en los nombres de host.

Tipo de dato: boolean

Valor por defecto: false

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?tls=true&tlsInsecure=true");

Si deshabilitar la comprobación de revocación de certificados durante el protocolo de enlace TLS.

Tipo de dato: boolean

Valor por defecto: false

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?tls=true&tlsDisableCertificateRevocationCheck=true");

Para obtener más información sobre las opciones de TLS, consultar la guía Configurar la seguridad de la capa de transporte (TLS).

La duración de tiempo que el driver intenta establecer una sola conexión de socket TCP con el servidor antes de agotar el tiempo de espera.

Tipo de dato: integer

Valor por defecto: 10000 (10 segundos)

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?connectTimeoutMS=60000");

La duración de tiempo que el controlador intenta enviar o recibir a través de un socket antes de exceder el tiempo de espera. El sistema operativo establece el valor por defecto.

Tipo de dato: integer

Valor por defecto: 300000 (5 minutos)

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?socketTimeoutMS=60000");

Los tipos de compresión preferidos, en orden, para los mensajes del protocolo de conexión enviados al servidor o recibidos de este. Puede habilitar "snappy", "zlib" y "zstd" como dependencias opcionales en tiempo de compilación. El driver utiliza el primero de estos tipos de compresión que admite el servidor.

Tipo de dato: char*

Valor por defecto: NULL

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?compressors=zlib,snappy");

El mayor número de clientes o conexiones que el driver puede crear en su pool de conexiones. Este recuento incluye las conexiones en uso.

Tipo de dato: integer

Valor por defecto: 100

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?maxPoolSize=150");

El tiempo que el driver intenta extraer una conexión del pool de conexiones del servidor antes de que caduque.

Tipo de dato: integer

Valor por defecto: -1 (sin tiempo de espera)

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?waitQueueTimeoutMS=30000");

Para obtener más información sobre los pool de conexiones, consulta la guía pool de conexiones.

El componente w del nivel de confirmación de escritura (write concern), que solicita el reconocimiento de que la operación de escritura se ha propagado a un número especificado de instancias de MongoDB. El valor por defecto es "majority" o 1, dependiendo del número de árbitros y nodos de votación. Para obtener más información sobre la opción w, consulta nivel de confirmación de escritura (write concern) en el manual de MongoDB Server.

Tipo de dato: integer or char*

Valor por defecto: 1 or "majority"

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?w=2");

El wtimeoutms componente del nivel de confirmación de escritura (write concern), que especifica un límite de tiempo para el nivel de confirmación de escritura (write concern). Para obtener más información sobre la opción wtimeout, consulta nivel de confirmación de escritura (Write Concern) en el manual de MongoDB Server.

Tipo de dato: integer

Valor por defecto: 0

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?wTimeoutMS=5000");

El componente j del nivel de confirmación de escritura (write concern), que solicita una confirmación de que las instancias de MongoDB han guardado en la bitácora en disco.

Tipo de dato: boolean

Valor por defecto: false

Para aprender más sobre la opción j, consulta nivel de confirmación de escritura (write concern) en el manual de MongoDB Server.

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?journal=true");

El nivel de consistencia de lectura del cliente. Para obtener más información, consulte la referencia de nivel de consistencia de lectura en el manual de MongoDB Server.

Tipo de dato: char*

Valor por defecto: local

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?readConcernLevel=local");

La configuración de preferencia de lectura por defecto del cliente. Consulte Preferencia de lectura en el manual de MongoDB Server para obtener más información.

Tipo de dato: char*

Valor por defecto: primary

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?readPreference=primaryPreferred");

Los Segundos Máximos de Antigüedad representan el mayor atraso de la replicación, en tiempo de reloj, que una secundaria puede experimentar y seguir siendo elegible para la selección del servidor. El valor mínimo permitido para maxStalenessSeconds es 90 segundos. Esta opción debe usarse con una preferencia de lectura distinta a la primaria.

Tipo de dato: integer

Valor por defecto: -1

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?readPreference=secondary&maxStalenessSeconds=120");

La ventana de latencia para la elegibilidad del servidor. Si el viaje de ida y vuelta de un servidor tarda más que el tiempo de viaje de ida y vuelta del servidor más rápido más este valor, el servidor no es elegible para la selección.

Tipo de dato: integer

Valor por defecto: 15

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?localThresholdMS=150");

El mecanismo que utiliza el driver para autenticarse en MongoDB Server. Si no especificas un mecanismo de autenticación, el driver utiliza SCRAM-SHA-1 o SCRAM-SHA-256, según la versión del servidor.

Para aprender más sobre los mecanismos de autenticación disponibles, consulte la guía de Mecanismos de autenticación o Mecanismos de autenticación de empresa.

Tipo de dato: char*

Valor por defecto: SCRAM-SHA-256 (para MongoDB 4.0 y posteriores)

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?authSource=admin&authMechanism=GSSAPI");

El intervalo entre las verificaciones de supervisión del servidor. Debe ser mayor o igual a 500 milisegundos. El valor por defecto es 10000 ms (10 segundos) en modo agrupado (multihilo) y 60000 ms (60 segundos) en modo no agrupado (de un solo hilo).

Tipo de dato: integer

Valor por defecto: 10000 para clientes agrupados, 60000 para clientes de un solo subproceso

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?heartbeatFrequencyMS=5000");

El tiempo que el driver intenta seleccionar un servidor antes de agotar el tiempo de espera.

Tipo de dato: integer

Valor por defecto: 30000

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?serverSelectionTimeoutMS=40000");

Solo se aplica a clientes de un solo subproceso. Si un socket no se ha utilizado en este tiempo, el driver comprueba la conexión con una llamada rápida de "hola" antes de volver a utilizarlo.

Tipo de dato: integer

Valor por defecto: 5000

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?socketCheckIntervalMS=10000");

Activar las lecturas reintentables.

Tipo de dato: boolean

Valor por defecto: true

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?retryReads=false");

Activar las escrituras reintentables.

Tipo de dato: boolean

Valor por defecto: true con soporte TLS, false en caso contrario

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?retryWrites=false");

Nota

Deslastre de carga en la gestión inteligente de cargas de trabajo (IWM)

Si los errores con las etiquetas SystemOverloadedError o RetryableError están causando fallos en su aplicación o aparecen en el registro de su aplicación, Load Shedding puede estar activo en su clúster y su driver puede no estar actualizado a una versión que lo admita. Recomendamos actualizar su MongoDB C driver a la versión 2.3 o posterior. Si sigue viendo estos errores después de la actualización, puede solucionarlos mediante cambios en el lado del servidor, como la revisión de la configuración de Load Shedding, o mediante cambios en el lado de la aplicación, como implementar un manejo de errores personalizado o la limitación de solicitudes en el lado del cliente. Dependiendo de su situación, los cambios en la aplicación pueden ser preferibles o necesarios.

Reducción de carga es una funcionalidad de IWM, y ayuda a gestionar la carga del servidor al rechazar operaciones excesivas durante una sobrecarga sostenida. Esta funcionalidad está disponible en MongoDB 9.0 y versiones posteriores.

Para obtener más información sobre IWM o la gestión de errores de sobrecarga, consulte la página Gestión inteligente de la carga de trabajo o la página Errores de sobrecarga en la documentación de Atlas.

El nombre de la aplicación que el driver pasa al servidor en los metadatos del cliente como parte del protocolo de enlace de conexión. El servidor imprime este valor en los registros de MongoDB una vez que establece la conexión. El valor también se registra en los registros de query lentas y en las colecciones de perfiles.

Tipo de dato: char*

Valor por defecto: vacío

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?appName=yourAppName");

Especifica si el driver se está conectando a un balanceador de carga. Puede establecer esta propiedad en true solo si se cumplen todas las siguientes condiciones:

  • Solo especifica un nombre de host

  • No estás conectándote a un set de réplicas.

  • No estás utilizando la propiedad SrvMaxHosts

  • No estás utilizando la propiedad DirectConnection

Tipo de dato: boolean

Valor por defecto: false

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?loadBalanced=true");

El mayor número de resultados de SRV que se seleccionarán al azar al rellenar inicialmente la lista de nodos iniciales o, durante la exploración de SRV, al añadir nuevos hosts a la topología.

Puedes usar esta propiedad solo si el esquema de la cadena de conexión está establecido en ConnectionStringScheme.MongoDBPlusSrv. No se puede utilizar al conectarse a un set de réplicas.

Tipo de dato: integer

Valor por defecto: 0

Ejemplo:

mongoc_uri_t *uri = mongoc_uri_new("mongodb+srv://localhost:27017/?srvMaxHosts=5");

Para obtener más información sobre los tipos utilizados en esta página, consulte la siguiente documentación de la API: