If set, the client will throttle mutations in batch write jobs.
This option is for batch write jobs where the goal is to avoid cluster overload and prevent job failure more than it is to minimize latency or maximize throughput.
With this option set, the server rate-limits traffic to avoid overloading your Bigtable cluster, while ensuring the cluster is under enough load to trigger Bigtable [autoscaling] (if enabled).
[[["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 page provides documentation for the \u003ccode\u003eBulkApplyThrottlingOption\u003c/code\u003e within the Google Cloud Bigtable C++ client library, spanning multiple versions from 2.11.0 to 2.37.0-rc.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eBulkApplyThrottlingOption\u003c/code\u003e enables rate-limiting of mutations in batch write jobs to prevent Bigtable cluster overload and ensure stability, rather than focusing on maximizing throughput or minimizing latency.\u003c/p\u003e\n"],["\u003cp\u003eUsing this option is most effective when the Bigtable cluster has autoscaling enabled, as the server will maintain a certain load to trigger scaling.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize this option, it must be set when invoking \u003ccode\u003eMakeDataConnection()\u003c/code\u003e, and the associated app profile must be set for single-cluster routing.\u003c/p\u003e\n"],["\u003cp\u003eThe option itself is a \u003ccode\u003ebool\u003c/code\u003e, when set to true it will throttle mutations in batch write jobs.\u003c/p\u003e\n"]]],[],null,["# Struct BulkApplyThrottlingOption (2.42.0-rc)\n\nVersion latestkeyboard_arrow_down\n\n- [2.42.0-rc (latest)](/cpp/docs/reference/bigtable/latest/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.41.0](/cpp/docs/reference/bigtable/2.41.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.40.0](/cpp/docs/reference/bigtable/2.40.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.39.0](/cpp/docs/reference/bigtable/2.39.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.38.0](/cpp/docs/reference/bigtable/2.38.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.37.0](/cpp/docs/reference/bigtable/2.37.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.36.0](/cpp/docs/reference/bigtable/2.36.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.35.0](/cpp/docs/reference/bigtable/2.35.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.34.0](/cpp/docs/reference/bigtable/2.34.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.33.0](/cpp/docs/reference/bigtable/2.33.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.32.0](/cpp/docs/reference/bigtable/2.32.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.31.0](/cpp/docs/reference/bigtable/2.31.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.30.0](/cpp/docs/reference/bigtable/2.30.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.29.0](/cpp/docs/reference/bigtable/2.29.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.28.0](/cpp/docs/reference/bigtable/2.28.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.27.0](/cpp/docs/reference/bigtable/2.27.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.26.0](/cpp/docs/reference/bigtable/2.26.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.25.1](/cpp/docs/reference/bigtable/2.25.1/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.24.0](/cpp/docs/reference/bigtable/2.24.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.23.0](/cpp/docs/reference/bigtable/2.23.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.22.1](/cpp/docs/reference/bigtable/2.22.1/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.21.0](/cpp/docs/reference/bigtable/2.21.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.20.0](/cpp/docs/reference/bigtable/2.20.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.19.0](/cpp/docs/reference/bigtable/2.19.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.18.0](/cpp/docs/reference/bigtable/2.18.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.17.0](/cpp/docs/reference/bigtable/2.17.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.16.0](/cpp/docs/reference/bigtable/2.16.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.15.1](/cpp/docs/reference/bigtable/2.15.1/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.14.0](/cpp/docs/reference/bigtable/2.14.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.13.0](/cpp/docs/reference/bigtable/2.13.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.12.0](/cpp/docs/reference/bigtable/2.12.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption)\n- [2.11.0](/cpp/docs/reference/bigtable/2.11.0/structgoogle_1_1cloud_1_1bigtable_1_1experimental_1_1BulkApplyThrottlingOption) \nIf set, the client will throttle mutations in batch write jobs. \nThis option is for batch write jobs where the goal is to avoid cluster overload and prevent job failure more than it is to minimize latency or maximize throughput.\n\nWith this option set, the server rate-limits traffic to avoid overloading your Bigtable cluster, while ensuring the cluster is under enough load to trigger Bigtable \\[autoscaling\\] (if enabled).\n\nThe [app profile](https://cloud.google.com/bigtable/docs/app-profiles) associated with these requests must be configured for [single-cluster routing](https://cloud.google.com/bigtable/docs/routing#single-cluster). See [`google::cloud::bigtable::AppProfileIdOption`](/cpp/docs/reference/bigtable/latest/structgoogle_1_1cloud_1_1bigtable_1_1AppProfileIdOption).\n| **Note:** This option must be supplied to [`MakeDataConnection()`](/cpp/docs/reference/bigtable/latest/namespacegoogle_1_1cloud_1_1bigtable) in order to take effect.\n\n###### See Also\n\n\u003chttps://cloud.google.com/bigtable/docs/writes#flow-control\u003e\n\nType Aliases\n------------\n\n### Type\n\n**Alias Of** : `bool`"]]
