Google Cloud Bigtable Row for sending append mutations.
These mutations are intended to augment the value of an existing cell
and uses the methods:
append_cell_value
increment_cell_value
The first works by appending bytes and the second by incrementing an
integer (stored in the cell as 8 bytes). In either case, if the
cell is empty, assumes the default empty value (empty string for
bytes or 0 for integer).
This commits modifications made byappend_cell_valueandincrement_cell_value. If no modifications were made, makes
no API request and just returns{}.
Modifies a row atomically, reading the latest existing
timestamp / value from the specified columns and writing a new value by
appending / incrementing. The new cell created uses either the current
server time or the highest timestamp of a cell in that column (if it
exceeds the server time).
After committing the accumulated mutations, resets the local mutations.
The new contents of all modified cells. Returned as a dictionary of column families, each of which holds a dictionary of columns. Each column contains a list of cells modified. Each cell is represented with a two-tuple with the value (in bytes) and the timestamp for the cell.
The column family that contains the column. Must be of the form<code>_a-zA-Z0-9][-_.a-zA-Z0-9]</code>*.
column
bytes
The column within the column family where the cell is located.
int_value
int
The value to increment the existing value in the cell by. If the targeted cell is unset, it will be treated as containing a zero. Otherwise, the targeted cell must contain an 8-byte value (interpreted as a 64-bit big-endian signed integer), or the entire request will fail.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-04 UTC."],[],[],null,["# Class AppendRow (2.32.0)\n\nVersion latestkeyboard_arrow_down\n\n- [2.32.0 (latest)](/python/docs/reference/bigtable/latest/google.cloud.bigtable.row.AppendRow)\n- [2.31.0](/python/docs/reference/bigtable/2.31.0/google.cloud.bigtable.row.AppendRow)\n- [2.30.1](/python/docs/reference/bigtable/2.30.1/google.cloud.bigtable.row.AppendRow)\n- [2.29.0](/python/docs/reference/bigtable/2.29.0/google.cloud.bigtable.row.AppendRow)\n- [2.28.1](/python/docs/reference/bigtable/2.28.1/google.cloud.bigtable.row.AppendRow)\n- [2.26.0](/python/docs/reference/bigtable/2.26.0/google.cloud.bigtable.row.AppendRow)\n- [2.25.0](/python/docs/reference/bigtable/2.25.0/google.cloud.bigtable.row.AppendRow)\n- [2.24.0](/python/docs/reference/bigtable/2.24.0/google.cloud.bigtable.row.AppendRow)\n- [2.23.1](/python/docs/reference/bigtable/2.23.1/google.cloud.bigtable.row.AppendRow)\n- [2.22.0](/python/docs/reference/bigtable/2.22.0/google.cloud.bigtable.row.AppendRow)\n- [2.21.0](/python/docs/reference/bigtable/2.21.0/google.cloud.bigtable.row.AppendRow)\n- [2.20.0](/python/docs/reference/bigtable/2.20.0/google.cloud.bigtable.row.AppendRow)\n- [2.19.0](/python/docs/reference/bigtable/2.19.0/google.cloud.bigtable.row.AppendRow)\n- [2.18.1](/python/docs/reference/bigtable/2.18.1/google.cloud.bigtable.row.AppendRow)\n- [2.17.0](/python/docs/reference/bigtable/2.17.0/google.cloud.bigtable.row.AppendRow)\n- [2.16.0](/python/docs/reference/bigtable/2.16.0/google.cloud.bigtable.row.AppendRow)\n- [2.15.0](/python/docs/reference/bigtable/2.15.0/google.cloud.bigtable.row.AppendRow)\n- [2.14.1](/python/docs/reference/bigtable/2.14.1/google.cloud.bigtable.row.AppendRow)\n- [2.13.2](/python/docs/reference/bigtable/2.13.2/google.cloud.bigtable.row.AppendRow)\n- [2.12.0](/python/docs/reference/bigtable/2.12.0/google.cloud.bigtable.row.AppendRow)\n- [2.11.3](/python/docs/reference/bigtable/2.11.3/google.cloud.bigtable.row.AppendRow)\n- [2.10.1](/python/docs/reference/bigtable/2.10.1/google.cloud.bigtable.row.AppendRow)\n- [2.9.0](/python/docs/reference/bigtable/2.9.0/google.cloud.bigtable.row.AppendRow)\n- [2.8.1](/python/docs/reference/bigtable/2.8.1/google.cloud.bigtable.row.AppendRow)\n- [2.7.1](/python/docs/reference/bigtable/2.7.1/google.cloud.bigtable.row.AppendRow)\n- [2.6.0](/python/docs/reference/bigtable/2.6.0/google.cloud.bigtable.row.AppendRow)\n- [2.5.2](/python/docs/reference/bigtable/2.5.2/google.cloud.bigtable.row.AppendRow)\n- [2.4.0](/python/docs/reference/bigtable/2.4.0/google.cloud.bigtable.row.AppendRow)\n- [2.3.3](/python/docs/reference/bigtable/2.3.3/google.cloud.bigtable.row.AppendRow)\n- [2.2.0](/python/docs/reference/bigtable/2.2.0/google.cloud.bigtable.row.AppendRow)\n- [2.1.0](/python/docs/reference/bigtable/2.1.0/google.cloud.bigtable.row.AppendRow)\n- [2.0.0](/python/docs/reference/bigtable/2.0.0/google.cloud.bigtable.row.AppendRow)\n- [1.7.3](/python/docs/reference/bigtable/1.7.3/google.cloud.bigtable.row.AppendRow)\n- [1.6.1](/python/docs/reference/bigtable/1.6.1/google.cloud.bigtable.row.AppendRow)\n- [1.5.1](/python/docs/reference/bigtable/1.5.1/google.cloud.bigtable.row.AppendRow)\n- [1.4.0](/python/docs/reference/bigtable/1.4.0/google.cloud.bigtable.row.AppendRow)\n- [1.3.0](/python/docs/reference/bigtable/1.3.0/google.cloud.bigtable.row.AppendRow)\n- [1.2.1](/python/docs/reference/bigtable/1.2.1/google.cloud.bigtable.row.AppendRow)\n- [1.1.0](/python/docs/reference/bigtable/1.1.0/google.cloud.bigtable.row.AppendRow)\n- [1.0.0](/python/docs/reference/bigtable/1.0.0/google.cloud.bigtable.row.AppendRow)\n- [0.34.0](/python/docs/reference/bigtable/0.34.0/google.cloud.bigtable.row.AppendRow) \n\n AppendRow(row_key, table)\n\nGoogle Cloud Bigtable Row for sending append mutations.\n\nThese mutations are intended to augment the value of an existing cell\nand uses the methods:\n\n- `append_cell_value`\n- `increment_cell_value`\n\nThe first works by appending bytes and the second by incrementing an\ninteger (stored in the cell as 8 bytes). In either case, if the\ncell is empty, assumes the default empty value (empty string for\nbytes or 0 for integer).\n\nProperties\n----------\n\n### row_key\n\nRow key.\n\nFor example:\n\n.. literalinclude:: snippets_table.py\n:start-after: \\[START bigtable_api_row_row_key\\]\n:end-before: \\[END bigtable_api_row_row_key\\]\n:dedent: 4\n\n### table\n\nRow table.\n\nFor example:\n\n.. literalinclude:: snippets_table.py\n:start-after: \\[START bigtable_api_row_table\\]\n:end-before: \\[END bigtable_api_row_table\\]\n:dedent: 4\n\nMethods\n-------\n\n### append_cell_value\n\n append_cell_value(column_family_id, column, value)\n\nAppends a value to an existing cell.\n\n\u003cbr /\u003e\n\n| **Note:** This method adds a read-modify rule protobuf to the accumulated read-modify rules on this row, but does not make an API request. To actually send an API request (with the rules) to the Google Cloud Bigtable API, call `commit`.\n.. literalinclude:: snippets_table.py :start-after: \\[START bigtable_api_row_append_cell_value\\] :end-before: \\[END bigtable_api_row_append_cell_value\\] :dedent: 4\n\n\u003cbr /\u003e\n\n### clear\n\n clear()\n\nRemoves all currently accumulated modifications on current row.\n\nFor example:\n\n.. literalinclude:: snippets_table.py\n:start-after: \\[START bigtable_api_row_clear\\]\n:end-before: \\[END bigtable_api_row_clear\\]\n:dedent: 4\n\n### commit\n\n commit()\n\nMakes a `ReadModifyWriteRow` API request.\n\nThis commits modifications made by `append_cell_value` and\n`increment_cell_value`. If no modifications were made, makes\nno API request and just returns `{}`.\n\nModifies a row atomically, reading the latest existing\ntimestamp / value from the specified columns and writing a new value by\nappending / incrementing. The new cell created uses either the current\nserver time or the highest timestamp of a cell in that column (if it\nexceeds the server time).\n\nAfter committing the accumulated mutations, resets the local mutations.\n\nFor example:\n\n.. literalinclude:: snippets_table.py\n:start-after: \\[START bigtable_api_row_commit\\]\n:end-before: \\[END bigtable_api_row_commit\\]\n:dedent: 4\n\n### increment_cell_value\n\n increment_cell_value(column_family_id, column, int_value)\n\nIncrements a value in an existing cell.\n\nAssumes the value in the cell is stored as a 64 bit integer\nserialized to bytes.\n\n\u003cbr /\u003e\n\n| **Note:** This method adds a read-modify rule protobuf to the accumulated read-modify rules on this row, but does not make an API request. To actually send an API request (with the rules) to the Google Cloud Bigtable API, call `commit`.\n.. literalinclude:: snippets_table.py :start-after: \\[START bigtable_api_row_increment_cell_value\\] :end-before: \\[END bigtable_api_row_increment_cell_value\\] :dedent: 4\n\n\u003cbr /\u003e"]]
