Represent a set of mutations across multiple rows.
Cloud Bigtable can batch multiple mutations in a single request. The mutations are not atomic, but it is more efficient to send them in a batch than to make multiple smaller requests.
Constructors
BulkMutation()
Create an empty set of mutations.
BulkMutation(Iterator, Iterator)
Create a multi-row mutation from a range of SingleRowMutations.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-14 UTC."],[[["\u003cp\u003eThis document outlines the \u003ccode\u003eBulkMutation\u003c/code\u003e class in the Google Cloud Bigtable C++ client library, focusing on its functionality for managing multiple row mutations.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eBulkMutation\u003c/code\u003e class allows users to efficiently group multiple \u003ccode\u003eSingleRowMutation\u003c/code\u003e objects into a single batch request for Cloud Bigtable.\u003c/p\u003e\n"],["\u003cp\u003eUsers can construct a \u003ccode\u003eBulkMutation\u003c/code\u003e object using various methods, including iterators, initializer lists, single \u003ccode\u003eSingleRowMutation\u003c/code\u003e objects, or variadic arguments, providing flexibility in creating multi-row mutations.\u003c/p\u003e\n"],["\u003cp\u003eThe class provides methods like \u003ccode\u003eemplace_back\u003c/code\u003e and \u003ccode\u003epush_back\u003c/code\u003e to add mutations to the set, and methods like \u003ccode\u003eempty()\u003c/code\u003e, \u003ccode\u003esize()\u003c/code\u003e, and \u003ccode\u003eestimated_size_in_bytes()\u003c/code\u003e to inspect the current state of the object.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eBulkMutation\u003c/code\u003e allows for the conversion of its contents to a \u003ccode\u003egoogle::bigtable::v2::MutateRowsRequest\u003c/code\u003e which is used to send the batch to the Bigtable server.\u003c/p\u003e\n"]]],[],null,["# Class BulkMutation (2.36.0)\n\nVersion 2.36.0keyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/bigtable/latest/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.41.0](/cpp/docs/reference/bigtable/2.41.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.40.0](/cpp/docs/reference/bigtable/2.40.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.39.0](/cpp/docs/reference/bigtable/2.39.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.38.0](/cpp/docs/reference/bigtable/2.38.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.37.0](/cpp/docs/reference/bigtable/2.37.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.36.0](/cpp/docs/reference/bigtable/2.36.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.35.0](/cpp/docs/reference/bigtable/2.35.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.34.0](/cpp/docs/reference/bigtable/2.34.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.33.0](/cpp/docs/reference/bigtable/2.33.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.32.0](/cpp/docs/reference/bigtable/2.32.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.31.0](/cpp/docs/reference/bigtable/2.31.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.30.0](/cpp/docs/reference/bigtable/2.30.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.29.0](/cpp/docs/reference/bigtable/2.29.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.28.0](/cpp/docs/reference/bigtable/2.28.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.27.0](/cpp/docs/reference/bigtable/2.27.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.26.0](/cpp/docs/reference/bigtable/2.26.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.25.1](/cpp/docs/reference/bigtable/2.25.1/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.24.0](/cpp/docs/reference/bigtable/2.24.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.23.0](/cpp/docs/reference/bigtable/2.23.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.22.1](/cpp/docs/reference/bigtable/2.22.1/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.21.0](/cpp/docs/reference/bigtable/2.21.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.20.0](/cpp/docs/reference/bigtable/2.20.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.19.0](/cpp/docs/reference/bigtable/2.19.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.18.0](/cpp/docs/reference/bigtable/2.18.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.17.0](/cpp/docs/reference/bigtable/2.17.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.16.0](/cpp/docs/reference/bigtable/2.16.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.15.1](/cpp/docs/reference/bigtable/2.15.1/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.14.0](/cpp/docs/reference/bigtable/2.14.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.13.0](/cpp/docs/reference/bigtable/2.13.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.12.0](/cpp/docs/reference/bigtable/2.12.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation)\n- [2.11.0](/cpp/docs/reference/bigtable/2.11.0/classgoogle_1_1cloud_1_1bigtable_1_1BulkMutation) \nRepresent a set of mutations across multiple rows. \nCloud Bigtable can batch multiple mutations in a single request. The mutations are not atomic, but it is more efficient to send them in a batch than to make multiple smaller requests.\n\nConstructors\n------------\n\n### BulkMutation()\n\nCreate an empty set of mutations.\n\n### BulkMutation(Iterator, Iterator)\n\nCreate a multi-row mutation from a range of SingleRowMutations.\n\n### BulkMutation(std::initializer_list\\\u003c SingleRowMutation \\\u003e)\n\nCreate a multi-row mutation from a initializer list.\n\n### BulkMutation(SingleRowMutation)\n\nCreate a multi-row mutation from a [SingleRowMutation](/cpp/docs/reference/bigtable/2.36.0/classgoogle_1_1cloud_1_1bigtable_1_1SingleRowMutation).\n\n### BulkMutation(SingleRowMutation, SingleRowMutation)\n\nCreate a multi-row mutation from two [SingleRowMutation](/cpp/docs/reference/bigtable/2.36.0/classgoogle_1_1cloud_1_1bigtable_1_1SingleRowMutation).\n\n### BulkMutation(M \\&\\&...)\n\nCreate a multi-row mutation from a variadic list.\n\nFunctions\n---------\n\n### emplace_back(SingleRowMutation)\n\n### emplace_back(FailedMutation)\n\n### push_back(SingleRowMutation)\n\n### MoveTo(google::bigtable::v2::MutateRowsRequest \\*)\n\nMove the contents into a bigtable::v2::MutateRowsRequest.\n\n### empty() const\n\nReturn true if there are no mutations in this set.\n\n### size() const\n\nReturn the number of mutations in this set.\n\n### estimated_size_in_bytes() const\n\nReturn the estimated size in bytes of all the mutations in this set."]]
