Operações de gravação em massa

Inserir operações

Para executar uma operação de inserção, adicione as instruções de inserção ao valor mongoc_bulkwrite_t, que enfileira a operação como parte da gravação em massa.

O exemplo a seguir chama a função mongoc_bulkwrite_append_insertone(). Esta função aceita os seguintes parâmetros:

O exemplo a seguir anexa uma operação de inserção à escrita em massa:

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 inserir vários documentos, chame a função mongoc_bulkwrite_append_insertone() para cada documento.

Atualizar operações

Para executar uma operação de atualização, adicione as instruções de atualização ao valor mongoc_bulkwrite_t, que classifica a operação como parte da gravação em massa.

O exemplo a seguir chama a função mongoc_bulkwrite_append_updateone(). Esta função aceita os seguintes parâmetros:

O exemplo a seguir anexa uma operação de atualização à escrita em massa:

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 atualizar vários documentos, chame a função mongoc_bulkwrite_append_updatemany() e passe os parâmetros mostrados no exemplo anterior. Isso instrui o driver a atualizar todos os documentos que correspondem ao seu filtro de consulta.

O exemplo a seguir anexa uma operação de atualização de muitos à escrita em massa:

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);

Operações de substituição

Uma operação de substituição remove todos os campos e valores de um documento especificado e os substitui por novos. Para executar uma operação de substituição, adicione as instruções de substituição ao valor mongoc_bulkwrite_t, que classifica a operação como parte da gravação em massa.

O exemplo a seguir chama a função mongoc_bulkwrite_append_replaceone(). Esta função aceita os seguintes parâmetros:

O exemplo a seguir anexa uma operação de substituição à escrita em massa:

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 substituir vários documentos, chame a função mongoc_bulkwrite_append_replaceone() para cada documento.

Excluir operações

Para executar uma operação de exclusão, adicione as instruções de exclusão ao valor mongoc_bulkwrite_t, que enfileira a operação como parte da gravação em massa.

O exemplo a seguir chama a função mongoc_bulkwrite_append_deleteone(). Esta função aceita os seguintes parâmetros:

O exemplo a seguir anexa uma operação de exclusão à escrita em massa:

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 excluir vários documentos, chame a função mongoc_bulkwrite_append_deletemany() e passe os parâmetros mostrados no exemplo anterior. Isso instrui o driver a excluir todos os documentos que correspondem ao seu filtro de query.

O exemplo a seguir anexa uma operação de exclusão de muitos:

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);

BulkWriteOptions

A tabela seguinte descreve as opções que você pode especificar no valor mongoc_bulkwriteopts_t para uma operação de gravação em massa:

Inserir operações

Para executar uma operação de inserção, adicione as instruções de inserção ao valor mongoc_bulk_operation_t, que enfileira a operação como parte da gravação em massa.

O exemplo a seguir chama a função mongoc_bulk_operation_insert_with_opts(). Esta função aceita os seguintes parâmetros:

O exemplo a seguir anexa uma operação de inserção à escrita em massa:

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 inserir vários documentos, chame a função mongoc_bulk_operation_insert_with_opts() para cada documento.

Atualizar operações

Para executar uma operação de atualização, adicione as instruções de atualização ao valor mongoc_bulk_operation_t, que classifica a operação como parte da gravação em massa.

O exemplo a seguir chama a função mongoc_bulk_operation_update_one_with_opts(). Esta função aceita os seguintes parâmetros:

O exemplo a seguir anexa uma operação de atualização à escrita em massa:

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 atualizar vários documentos, chame a função mongoc_bulk_operation_update_many_with_opts() e passe os parâmetros mostrados no exemplo anterior. Isso instrui o driver a atualizar todos os documentos que correspondem ao seu filtro de query.

O exemplo a seguir anexa uma operação de atualização de muitos à escrita em massa:

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);

Operações de substituição

Uma operação de substituição remove todos os campos e valores de um documento especificado e os substitui por novos. Para executar uma operação de substituição, adicione as instruções de substituição ao valor mongoc_bulk_operation_t, que classifica a operação como parte da gravação em massa.

O exemplo a seguir chama a função mongoc_bulk_operation_replace_one_with_opts(). Esta função aceita os seguintes parâmetros:

O exemplo a seguir anexa uma operação de substituição à escrita em massa:

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 substituir vários documentos, chame a função mongoc_bulk_operation_replace_one_with_opts() para cada documento.

Excluir operações

Para executar uma operação de exclusão, adicione as instruções de exclusão ao valor mongoc_bulk_operation_t, que enfileira a operação como parte da gravação em massa.

O exemplo a seguir chama a função mongoc_bulk_operation_remove_one_with_opts(). Esta função aceita os seguintes parâmetros:

O exemplo a seguir anexa uma operação de exclusão à escrita em massa:

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 excluir vários documentos, chame a função mongoc_bulk_operation_remove_many_with_opts() e passe os parâmetros mostrados no exemplo anterior. Isso instrui o driver a excluir todos os documentos que correspondem ao seu filtro de query.

O exemplo a seguir anexa uma operação delete many à escrita em massa:

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);

BulkWriteOptions

A tabela a seguir descreve as opções que você pode especificar no documento de opções que você passa para mongoc_collection_create_bulk_operation_with_opts():