Conditionally write a value (HBase)
Stay organized with collections
Save and categorize content based on your preferences.
Send a conditional write request. This type of write makes a CheckAndMutateRow API request.
Explore further
For detailed documentation that includes this code sample, see the following:
Code sample
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
[[["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"]],[],[[["\u003cp\u003eThis code demonstrates how to send a conditional write request using the CheckAndMutateRow API in Google Cloud Bigtable.\u003c/p\u003e\n"],["\u003cp\u003eThe example uses Java to connect to a Bigtable instance, create a row mutation, and apply a conditional check before writing data.\u003c/p\u003e\n"],["\u003cp\u003eThe code sets up a conditional check to ensure that data is written only if the "os_build" column's value is greater than or equal to "PQ2A.190405".\u003c/p\u003e\n"],["\u003cp\u003eThe provided sample code includes the necessary imports and details how to authenticate and connect to a Bigtable instance.\u003c/p\u003e\n"]]],[],null,["Send a conditional write request. This type of write makes a CheckAndMutateRow API request.\n\nExplore further\n\n\nFor detailed documentation that includes this code sample, see the following:\n\n- [Write examples](/bigtable/docs/writing-data)\n\nCode sample \n\nJava\n\n\nTo learn how to install and use the client library for Bigtable, see\n[Bigtable client libraries](/bigtable/docs/reference/libraries).\n\n\nTo authenticate to Bigtable, set up Application Default Credentials.\nFor more information, see\n\n[Set up authentication for a local development environment](/docs/authentication/set-up-adc-local-dev-environment).\n\n\n import com.google.cloud.bigtable.hbase.BigtableConfiguration;\n import org.apache.hadoop.hbase.TableName;\n import org.apache.hadoop.hbase.client.Connection;\n import org.apache.hadoop.hbase.client.Put;\n import org.apache.hadoop.hbase.client.RowMutations;\n import org.apache.hadoop.hbase.client.Table;\n import org.apache.hadoop.hbase.filter.CompareFilter.CompareOp;\n import org.apache.hadoop.hbase.util.Bytes;\n\n public class WriteConditionally {\n\n private static final byte[] COLUMN_FAMILY_NAME = Bytes.toBytes(\"stats_summary\");\n\n public static void writeConditionally(String projectId, String instanceId, String tableId) {\n // String projectId = \"my-project-id\";\n // String instanceId = \"my-instance-id\";\n // String tableId = \"mobile-time-series\";\n\n try (Connection connection = BigtableConfiguration.connect(projectId, instanceId)) {\n Table table = connection.getTable(TableName.valueOf(Bytes.toBytes(tableId)));\n long timestamp = System.currentTimeMillis();\n\n String rowKey = \"phone#4c410523#20190501\";\n RowMutations mutations = new RowMutations(Bytes.toBytes(rowKey));\n\n Put put = new Put(Bytes.toBytes(rowKey));\n put.addColumn(\n COLUMN_FAMILY_NAME, Bytes.toBytes(\"os_name\"), timestamp, Bytes.toBytes(\"android\"));\n mutations.add(put);\n\n table.checkAndMutate(\n Bytes.toBytes(rowKey),\n COLUMN_FAMILY_NAME,\n Bytes.toBytes(\"os_build\"),\n CompareOp.GREATER_OR_EQUAL,\n Bytes.toBytes(\"PQ2A.190405\"),\n mutations);\n\n System.out.print(\"Successfully updated row's os_name\");\n\n } catch (Exception e) {\n System.out.println(\"Error during WriteConditionally: \\n\" + e.toString());\n e.printStackTrace();\n }\n }\n }\n\nWhat's next\n\n\nTo search and filter code samples for other Google Cloud products, see the\n[Google Cloud sample browser](/docs/samples?product=bigtable)."]]