Overview
En esta guía, puedes aprender a realizar múltiples operaciones de escritura en una sola llamada a la base de datos utilizando operaciones de escritura en bloque.
Considere un escenario en el que desee insertar un documento en una colección, actualizar varios otros documentos y luego borrar un documento. Si utiliza funciones individuales, cada operación requiere su propia llamada a la base de datos. En su lugar, puede utilizar una operación masiva para reducir el número de llamar a la base de datos.
El driver de C proporciona dos API de guardar masiva: mongoc_bulkwrite_t y mongoc_bulk_operation_t.
Nota
Si está utilizando MongoDB Server 8.0 o posterior, le recomendamos que utilice mongoc_bulkwrite_t. Puede realizar operaciones en varias colecciones o bases de datos en una sola llamar, mientras que mongoc_bulk_operation_t solo puede dirigirse a una colección por llamar.
Datos de muestra
Los ejemplos en esta guía utilizan la colección restaurants en la base de datos sample_restaurants de los conjuntos de datos de muestra de Atlas. Para aprender a crear un clúster gratuito de MongoDB Atlas y cargar los conjuntos de datos de muestra, consulta la guía MongoDB Primeros Pasos.
mongoc_bulkwrite_t
Las operaciones de guardar masivas contienen una o más operaciones de guardar. Para utilizar un guardar masivo, cree el tipo de guardar masivo, llame a la función de anexión correspondiente para cada operación que desee realizar y, a continuación, ejecute el guardar masivo.
Crear la operación de guardado masivo
Para crear una operación de guardar masiva, llame a la función mongoc_client_bulkwrite_new(). Esta función devuelve un valor de tipo mongoc_bulkwrite_t que puede utilizar para almacenar instrucciones sobre qué operaciones de guardar desea realizar. Pase un valor mongoc_client_t como parámetro para especificar el cliente para guardar masivamente.
mongoc_bulkwrite_t *bulk = mongoc_client_bulkwrite_new(client);Agregar a la operación de guardado masivo
Puede agregar operaciones de inserción, actualizar, reemplazo y borrar a su valor mongoc_bulkwrite_t.
Operaciones de inserción
Para realizar una operación de inserción, añada las instrucciones de inserción al valor mongoc_bulkwrite_t, que pone en cola la operación como parte del guardado masivo.
El siguiente ejemplo llama a la función mongoc_bulkwrite_append_insertone(). Esta función acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| El namespace donde insertar el documento, especificado como |
| El documento a insertar. |
| Configuraciones opcionales para personalizar la operación, o |
| Recibe detalles del error si la función devuelve |
El siguiente ejemplo agrega una operación de inserción a la guardar masiva:
bson_t *insert_doc = BCON_NEW( "name", BCON_UTF8("Mongo's Deli"), "cuisine", BCON_UTF8("Sandwiches"), "borough", BCON_UTF8("Manhattan"), "restaurant_id", BCON_UTF8("1234"));bson_error_t error;
if (!mongoc_bulkwrite_append_insertone( bulk, "sample_restaurants.restaurants", insert_doc, NULL, &error)) { fprintf(stderr, "Failed to add insert operation: %s\n", error.message);}
bson_destroy(insert_doc);Para insertar varios documentos, llame a la función mongoc_bulkwrite_append_insertone() para cada documento.
Operaciones de actualizar
Para realizar una operación de actualizar, agregue las instrucciones de actualizar al valor mongoc_bulkwrite_t, que pone en cola la operación como parte de guardar de forma masiva.
El siguiente ejemplo llama a la función mongoc_bulkwrite_append_updateone(). Esta función acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| El namespace que contiene los documentos a actualizar, especificado como |
| El filtro de query que selecciona el documento para actualizar. |
| El actualizar que se aplicará al documento coincidente. |
| Configuraciones opcionales para personalizar la operación, o |
| Recibe detalles del error si la función devuelve |
El siguiente ejemplo añade una operación de actualizar a guardar masivamente:
bson_t *filter_doc = BCON_NEW("name", BCON_UTF8("Mongo's Deli"));bson_t *update_doc = BCON_NEW("$set", "{", "cuisine", BCON_UTF8("Sandwiches and Salads"), "}");bson_error_t error;
if (!mongoc_bulkwrite_append_updateone( bulk, "sample_restaurants.restaurants", filter_doc, update_doc, NULL, &error)) { fprintf(stderr, "Failed to add update operation: %s\n", error.message);}
bson_destroy(filter_doc);bson_destroy(update_doc);Para actualizar varios documentos, llame a la función mongoc_bulkwrite_append_updatemany() y pase los parámetros que se muestran en el ejemplo anterior. Esto le indica al driver que actualice todos los documentos que coincidan con su filtro de query.
El siguiente ejemplo agrega una operación de actualizar múltiple a la guardar masiva:
bson_t *filter_doc = BCON_NEW("name", BCON_UTF8("Mongo's Deli"));bson_t *update_doc = BCON_NEW("$set", "{", "cuisine", BCON_UTF8("Sandwiches and Salads"), "}");bson_error_t error;
if (!mongoc_bulkwrite_append_updatemany( bulk, "sample_restaurants.restaurants", filter_doc, update_doc, NULL, &error)) { fprintf(stderr, "Failed to add update operation: %s\n", error.message);}
bson_destroy(filter_doc);bson_destroy(update_doc);Reemplazar operaciones
Una operación de reemplazo remueve todos los campos y valores de un documento especificado y los reemplaza por otros nuevos. Para realizar una operación de reemplazo, agregue las instrucciones de reemplazo al valor mongoc_bulkwrite_t, que pone en cola la operación como parte de la guardar masiva.
El siguiente ejemplo llama a la función mongoc_bulkwrite_append_replaceone(). Esta función acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| El namespace que contiene los documentos a reemplazar, especificado como |
| El filtro de query que selecciona el documento a reemplazar. |
| El documento que reemplaza el documento coincidente. |
| Configuraciones opcionales para personalizar la operación, o |
| Recibe detalles del error si la función devuelve |
El siguiente ejemplo añade una operación de reemplazo al guardado masivo:
bson_t *filter_doc = BCON_NEW("restaurant_id", BCON_UTF8("1234"));bson_t *replace_doc = BCON_NEW( "name", BCON_UTF8("Mongo's Deli"), "cuisine", BCON_UTF8("Sandwiches and Salads"), "borough", BCON_UTF8("Brooklyn"), "restaurant_id", BCON_UTF8("5678"));bson_error_t error;
if (!mongoc_bulkwrite_append_replaceone( bulk, "sample_restaurants.restaurants", filter_doc, replace_doc, NULL, &error)) { fprintf(stderr, "Failed to add replace operation: %s\n", error.message);}
bson_destroy(filter_doc);bson_destroy(replace_doc);Para reemplazar varios documentos, llame a la función mongoc_bulkwrite_append_replaceone() para cada documento.
Operaciones de borrar
Para realizar una operación de borrar, agregue las instrucciones de borrar al valor mongoc_bulkwrite_t, que pone en cola la operación como parte de la operación de guardar masivo.
El siguiente ejemplo llama a la función mongoc_bulkwrite_append_deleteone(). Esta función acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| El namespace que contiene los documentos a borrar, especificado como |
| El filtro de query que selecciona el documento a borrar. |
| Configuraciones opcionales para personalizar la operación, o |
| Recibe detalles del error si la función devuelve |
El siguiente ejemplo añade una operación de borrar a la escritura masiva:
bson_t *filter_doc = BCON_NEW("name", BCON_UTF8("Mongo's Deli"));bson_error_t error;
if (!mongoc_bulkwrite_append_deleteone( bulk, "sample_restaurants.restaurants", filter_doc, NULL, &error)) { fprintf(stderr, "Failed to add delete operation: %s\n", error.message);}
bson_destroy(filter_doc);Para borrar varios documentos, llame a la función mongoc_bulkwrite_append_deletemany() y pase los parámetros que se muestran en el ejemplo anterior. Esto indica al driver que borre todos los documentos que coincidan con su filtro de query.
El siguiente ejemplo añade una operación de borrar muchos:
bson_t *filter_doc = BCON_NEW("borough", BCON_UTF8("Manhattan"));bson_error_t error;
if (!mongoc_bulkwrite_append_deletemany( bulk, "sample_restaurants.restaurants", filter_doc, NULL, &error)) { fprintf(stderr, "Failed to add delete operation: %s\n", error.message);}
bson_destroy(filter_doc);Ejecutar la operación masiva
La función mongoc_bulkwrite_execute() acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| Configuraciones opcionales para personalizar la operación, o |
Si la operación es exitosa, la función devuelve un valor mongoc_bulkwritereturn_t que contiene los resultados de la operación. De lo contrario, el valor de retorno incluye un valor mongoc_bulkwriteexception_t con los detalles del error.
El siguiente ejemplo muestra cómo guardar documentos de forma masiva:
bson_error_t error;
mongoc_bulkwrite_t *bulk = mongoc_client_bulkwrite_new(client);
bson_t *insert_doc = BCON_NEW( "<field name 1>", BCON_UTF8("<value 1>"), "<field name 2>", BCON_UTF8("<value 2>"), "<field name 3>", BCON_UTF8("<value 3>"), "<field name 4>", BCON_UTF8("<value 4>"));
mongoc_bulkwrite_append_insertone( bulk, "sample_restaurants.restaurants", insert_doc, NULL, &error);bson_destroy(insert_doc);
bson_t *query = BCON_NEW("<field to match>", BCON_UTF8("<value to match>"));bson_t *update = BCON_NEW("$set", "{", "<field name>", BCON_UTF8("<value>"), "}");
mongoc_bulkwrite_append_updateone( bulk, "sample_restaurants.restaurants", query, update, NULL, &error);bson_destroy(query);bson_destroy(update);
mongoc_bulkwritereturn_t result = mongoc_bulkwrite_execute(bulk, NULL);
if (result.exc) { if (mongoc_bulkwriteexception_error(result.exc, &error)) { fprintf(stderr, "Bulk write error: %s\n", error.message); }}
mongoc_bulkwriteresult_destroy(result.res);mongoc_bulkwriteexception_destroy(result.exc);mongoc_bulkwrite_destroy(bulk);El siguiente ejemplo llama a la función mongoc_bulkwrite_execute() para realizar las operaciones de insertar, actualizar, reemplazar y borrar.
bson_error_t error;mongoc_bulkwritereturn_t result = mongoc_bulkwrite_execute(bulk, NULL);
if (result.exc) { if (mongoc_bulkwriteexception_error(result.exc, &error)) { fprintf(stderr, "Bulk write error: %s\n", error.message); }} else if (result.res) { printf("Inserted: %" PRId64 " document(s)\n", mongoc_bulkwriteresult_insertedcount(result.res)); printf("Matched: %" PRId64 " document(s)\n", mongoc_bulkwriteresult_matchedcount(result.res)); printf("Modified: %" PRId64 " document(s)\n", mongoc_bulkwriteresult_modifiedcount(result.res)); printf("Deleted: %" PRId64 " document(s)\n", mongoc_bulkwriteresult_deletedcount(result.res));}
mongoc_bulkwriteresult_destroy(result.res);mongoc_bulkwriteexception_destroy(result.exc);Si fallan algunas operaciones de guardar, el driver C informa de los errores en el valor de retorno y no realiza ninguna operación adicional.
Personaliza las operaciones de escritura masiva
El siguiente ejemplo crea un valor mongoc_bulkwriteopts_t, establece ordered en false, y pasa las opciones a mongoc_bulkwrite_execute():
mongoc_bulkwriteopts_t *opts = mongoc_bulkwriteopts_new();mongoc_bulkwriteopts_set_ordered(opts, false);
mongoc_bulkwrite_t *bulk = mongoc_client_bulkwrite_new(client);
// Perform bulk operation
mongoc_bulkwritereturn_t result = mongoc_bulkwrite_execute(bulk, opts);
mongoc_bulkwriteresult_destroy(result.res);mongoc_bulkwriteexception_destroy(result.exc);
mongoc_bulkwriteopts_destroy(opts);mongoc_bulkwrite_destroy(bulk);Si alguna de las operaciones de guardado en una escritura masiva desordenada falla, el driver C informa de los errores solo después de intentar todas las operaciones.
Nota
Las operaciones masivas no ordenadas no ofrecen garantías del orden de ejecución. El orden puede diferir de la manera en que los enumeras para optimizar el tiempo de ejecución.
Opciones de escritura masiva
La siguiente tabla describe las opciones que puede especificar en el valor mongoc_bulkwriteopts_t para una operación de guardar masivo:
Opción | Descripción |
|---|---|
| Si |
| Si |
| Especifica el nivel de confirmación de escritura (write concern) para la operación en lote. Para obtener más información, consulta nivel de confirmación de escritura (write concern) en el manual de MongoDB Server. |
| Anexa un comentario a la operación. Para obtener más información, consulta la guía sobre los campos del comando borrar en el manual del MongoDB Server. |
| Especifica un documento con una lista de valores para mejorar la legibilidad de la operación. Los valores deben ser expresiones constantes o cerradas que no hagan referencia a campos de documentos. Para obtener más información, consulta la instrucción let en el manual de MongoDB Server. |
| Si |
mongoc_bulk_operation_t
Nota
Utilice mongoc_bulk_operation_t cuando utilice una versión anterior del driver C que 1.28.0, dirigido a una versión de MongoDB Server anterior a 8.0, o solo necesita guardar en una sola colección.
Las operaciones de guardar masivas contienen una o más operaciones de guardar. Para utilizar un guardar masivo, cree el tipo de guardar masivo, llame a la función de anexión correspondiente para cada operación que desee realizar y, a continuación, ejecute el guardar masivo.
Crear la operación de guardado masivo
Antes de ejecutar una operación de escritura masiva, llama la función mongoc_collection_create_bulk_operation_with_opts(). Esta función devuelve un valor de tipo mongoc_bulk_operation_t que puede usar para almacenar instrucciones sobre qué escrituras masivas realizar.
La función mongoc_collection_create_bulk_operation_with_opts() acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| La colección a modificar. |
| Opciones para personalizar la operación, o |
El siguiente ejemplo llama a la función mongoc_collection_create_bulk_operation_with_opts(), pasando la colección de restaurantes como parámetro:
mongoc_bulk_operation_t *bulk = mongoc_collection_create_bulk_operation_with_opts(collection, NULL);Agregar a la operación de guardado masivo
Puede agregar operaciones de inserción, actualizar, reemplazo y borrar a su valor mongoc_bulk_operation_t.
Operaciones de inserción
Para realizar una operación de inserción, añada las instrucciones de inserción al valor mongoc_bulk_operation_t, que pone en cola la operación como parte del guardado masivo.
El siguiente ejemplo llama a la función mongoc_bulk_operation_insert_with_opts(). Esta función acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| El documento a insertar. |
| Configuraciones opcionales para personalizar la operación, o |
| Una ubicación opcional para un valor de error |
El siguiente ejemplo agrega una operación de inserción a la guardar masiva:
bson_t *insert_doc = BCON_NEW( "name", BCON_UTF8("Mongo's Deli"), "cuisine", BCON_UTF8("Sandwiches"), "borough", BCON_UTF8("Manhattan"), "restaurant_id", BCON_UTF8("1234"));bson_error_t error;
if (!mongoc_bulk_operation_insert_with_opts(bulk, insert_doc, NULL, &error)) { fprintf(stderr, "Failed to add insert operation: %s\n", error.message);}
bson_destroy(insert_doc);Para insertar varios documentos, llame a la función mongoc_bulk_operation_insert_with_opts() para cada documento.
Operaciones de actualizar
Para realizar una operación de actualizar, agregue las instrucciones de actualizar al valor mongoc_bulk_operation_t, que pone en cola la operación como parte de guardar de forma masiva.
El siguiente ejemplo llama a la función mongoc_bulk_operation_update_one_with_opts(). Esta función acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| El filtro de query que selecciona el documento para actualizar. |
| El actualizar que se aplicará al documento coincidente. |
| Configuraciones opcionales para personalizar la operación, o |
| Una ubicación opcional para un valor de error |
El siguiente ejemplo añade una operación de actualizar a guardar masivamente:
bson_t *filter_doc = BCON_NEW("name", BCON_UTF8("Mongo's Deli"));bson_t *update_doc = BCON_NEW("$set", "{", "cuisine", BCON_UTF8("Sandwiches and Salads"), "}");bson_error_t error;
if (!mongoc_bulk_operation_update_one_with_opts(bulk, filter_doc, update_doc, NULL, &error)) { fprintf(stderr, "Failed to add update operation: %s\n", error.message);}
bson_destroy(filter_doc);bson_destroy(update_doc);Para actualizar varios documentos, llame a la función mongoc_bulk_operation_update_many_with_opts() y pase los parámetros que se muestran en el ejemplo anterior. Esto le indica al driver que actualice todos los documentos que coincidan con su filtro de query.
El siguiente ejemplo agrega una operación de actualizar múltiple a la guardar masiva:
bson_t *filter_doc = BCON_NEW("name", BCON_UTF8("Mongo's Deli"));bson_t *update_doc = BCON_NEW("$set", "{", "cuisine", BCON_UTF8("Sandwiches and Salads"), "}");bson_error_t error;
if (!mongoc_bulk_operation_update_many_with_opts(bulk, filter_doc, update_doc, NULL, &error)) { fprintf(stderr, "Failed to add update operation: %s\n", error.message);}
bson_destroy(filter_doc);bson_destroy(update_doc);Reemplazar operaciones
Una operación de reemplazo remueve todos los campos y valores de un documento especificado y los reemplaza por otros nuevos. Para realizar una operación de reemplazo, agregue las instrucciones de reemplazo al valor mongoc_bulk_operation_t, que pone en cola la operación como parte de la guardar masiva.
El siguiente ejemplo llama a la función mongoc_bulk_operation_replace_one_with_opts(). Esta función acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| El filtro de query que selecciona el documento a reemplazar. |
| El documento que reemplaza el documento coincidente. |
| Configuraciones opcionales para personalizar la operación, o |
| Una ubicación opcional para un valor de error |
El siguiente ejemplo añade una operación de reemplazo al guardado masivo:
bson_t *filter_doc = BCON_NEW("restaurant_id", BCON_UTF8("1234"));bson_t *replace_doc = BCON_NEW( "name", BCON_UTF8("Mongo's Deli"), "cuisine", BCON_UTF8("Sandwiches and Salads"), "borough", BCON_UTF8("Brooklyn"), "restaurant_id", BCON_UTF8("5678"));bson_error_t error;
if (!mongoc_bulk_operation_replace_one_with_opts(bulk, filter_doc, replace_doc, NULL, &error)) { fprintf(stderr, "Failed to add replace operation: %s\n", error.message);}
bson_destroy(filter_doc);bson_destroy(replace_doc);Para reemplazar varios documentos, llame a la función mongoc_bulk_operation_replace_one_with_opts() para cada documento.
Operaciones de borrar
Para realizar una operación de borrar, agregue las instrucciones de borrar al valor mongoc_bulk_operation_t, que pone en cola la operación como parte de la operación de guardar masivo.
El siguiente ejemplo llama a la función mongoc_bulk_operation_remove_one_with_opts(). Esta función acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| El filtro de query que selecciona el documento a borrar. |
| Configuraciones opcionales para personalizar la operación, o |
| Una ubicación opcional para un valor de error |
El siguiente ejemplo añade una operación de borrar a la escritura masiva:
bson_t *filter_doc = BCON_NEW("restaurant_id", BCON_UTF8("5678"));bson_error_t error;
if (!mongoc_bulk_operation_remove_one_with_opts(bulk, filter_doc, NULL, &error)) { fprintf(stderr, "Failed to add delete operation: %s\n", error.message);}
bson_destroy(filter_doc);Para borrar varios documentos, llame a la función mongoc_bulk_operation_remove_many_with_opts() y pase los parámetros que se muestran en el ejemplo anterior. Esto indica al driver que borre todos los documentos que coincidan con su filtro de query.
El siguiente ejemplo añade una operación de borrar masiva a guardar masiva.
bson_t *filter_doc = BCON_NEW("borough", BCON_UTF8("Manhattan"));bson_error_t error;
if (!mongoc_bulk_operation_remove_many_with_opts(bulk, filter_doc, NULL, &error)) { fprintf(stderr, "Failed to add delete operation: %s\n", error.message);}
bson_destroy(filter_doc);Ejecutar la operación masiva
La función mongoc_bulk_operation_execute() acepta los siguientes parámetros:
Parameter | Descripción |
|---|---|
| El valor |
| Un puntero opcional al almacenamiento sobrescribible para el documento de resultados, o |
| Una ubicación opcional para un valor de error |
El siguiente ejemplo muestra cómo guardar documentos de forma masiva:
bson_error_t error;
mongoc_bulk_operation_t *bulk = mongoc_collection_create_bulk_operation_with_opts(collection, NULL);
bson_t *insert_doc = BCON_NEW( "<field name>", BCON_UTF8("<value>"), "<field name>", BCON_UTF8("<value>"), "<field name>", BCON_UTF8("<value>"), "<field name>", BCON_UTF8("<value>"));
mongoc_bulk_operation_insert(bulk, insert_doc);bson_destroy(insert_doc); bson_t *query = BCON_NEW("<field to match>", BCON_UTF8("<value to match>"));bson_t *update = BCON_NEW("$set", "{", "<field name>", BCON_UTF8("<value>"), "}");
mongoc_bulk_operation_update_one(bulk, query, update, false);bson_destroy(query);bson_destroy(update);
bool result = mongoc_bulk_operation_execute(bulk, NULL, &error);if (!result) { fprintf(stderr, "Bulk operation error: %s\n", error.message);}
mongoc_bulk_operation_destroy(bulk);El siguiente ejemplo llama a la función mongoc_bulk_operation_execute() para realizar las operaciones de insertar, actualizar, reemplazar y borrar.
bson_error_t error;bool result = mongoc_bulk_operation_execute(bulk, NULL, &error);
if (!result) { printf("Bulk operation error: %s\n", error.message);}
mongoc_bulk_operation_destroy(bulk);Si alguna de las operaciones de guardar fallan, el driver de C establece el parámetro de salida error y no realiza ninguna operación adicional.
Personaliza las operaciones de escritura masiva
Puede modificar el comportamiento de la función mongoc_collection_create_bulk_operation_with_opts() pasando un documento BSON que especifica los valores de las opciones.
El siguiente ejemplo llama a la función mongoc_collection_create_bulk_operation_with_opts() y establece la opción ordered en false:
bson_t opts;BSON_APPEND_BOOL(&opts, "ordered", false);bulk = mongoc_collection_create_bulk_operation_with_opts(collection, &opts);
// Perform bulk operation
bson_destroy(&opts);mongoc_bulk_operation_destroy(bulk);Si alguna de las operaciones de guardado en una escritura masiva desordenada falla, el driver C informa de los errores solo después de intentar todas las operaciones.
Nota
Las operaciones masivas no ordenadas no ofrecen garantías del orden de ejecución. El orden puede diferir de la manera en que los enumeras para optimizar el tiempo de ejecución.
Opciones de escritura masiva
La siguiente tabla describe las opciones que puede especificar en el documento de opciones que pasa a mongoc_collection_create_bulk_operation_with_opts():
Opción | Descripción |
|---|---|
| Si |
| Especifica el nivel de confirmación de escritura (write concern) para la operación en lote. Para obtener más información, consulta nivel de confirmación de escritura (write concern) en el manual de MongoDB Server. |
| Ejecuta las operaciones masivas dentro de la sesión especificada. Para obtener más información, consulte Sesiones del servidor en el manual del MongoDB Server. |
| Anexa un comentario a la operación. Para obtener más información, consulta la guía sobre los campos del comando borrar en el manual del MongoDB Server. |
| Especifica un documento con una lista de valores para mejorar la legibilidad de la operación. Los valores deben ser expresiones constantes o cerradas que no hagan referencia a campos de documentos. Para obtener más información, consulta la instrucción let en el manual de MongoDB Server. |
Información Adicional
Para aprender cómo realizar operaciones de guardar individuales, consulta los siguientes guías:
Documentación de la API
Para obtener más información sobre cualquiera de las funciones o tipos mencionados en esta guía, consulta la siguiente documentación de la API:
- mongoc_bulkwrite_t
- mongoc_bulk_operation_t