3.7.0-rc 3.6.0 (latest) 3.5.0 3.4.0 3.3.0 3.2.0 2.48.0-rc 2.47.1 2.46.0 2.45.0 2.44.0 2.43.0 2.42.0 2.41.0 2.40.0 2.39.0 2.38.0 2.37.0 2.36.0 2.35.0 2.34.0 2.33.0 2.32.0 2.31.0 2.30.0 2.29.0 2.28.0 2.27.0 2.26.0 2.25.1 2.24.0 2.23.0 2.22.1 2.21.0 2.20.0 2.19.0 2.18.0 2.17.0 2.16.0 2.15.1 2.14.0 2.13.0 2.12.0 2.11.0 Set options on calls to [`spanner::Client::Commit()`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9).

> [!WARNING]
> **Deprecated:** Use [`Options`](https://docs.cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html) instead, and set (as needed) [`CommitReturnStatsOption`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitReturnStatsOption), [`RequestPriorityOption`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1RequestPriorityOption), or [`TransactionTagOption`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1TransactionTagOption).

###### Example

      auto commit = client.Commit(
          spanner::Mutations{
              spanner::UpdateMutationBuilder(
                  "Albums", {"SingerId", "AlbumId", "MarketingBudget"})
                  .EmplaceRow(1, 1, 200000)
                  .EmplaceRow(2, 2, 400000)
                  .Build()},
          google::cloud::Options{}.set<spanner::CommitReturnStatsOption>(true));

## Constructors

### CommitOptions()

Default options: no stats.

### CommitOptions(Options const \&)

Constructs from the new, recommended way to represent options of all varieties, [`google::cloud::Options`](https://docs.cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html).

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `opts` | `Options const &` |

## Operators

### operator Options() const

Converts to the new, recommended way to represent options of all varieties, [`google::cloud::Options`](https://docs.cloud.google.com/cpp/docs/reference/common/latest/classgoogle_1_1cloud_1_1Options.html).

## Functions

### set_return_stats(bool)

Set whether the [`CommitResult`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitResult) should contain [`CommitStats`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitStats).

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `return_stats` | `bool` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `CommitOptions &` |   |

### return_stats() const

Whether the [`CommitResult`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitResult) should contain [`CommitStats`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1CommitStats).

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `bool` |   |

### set_request_priority(std::optional\< RequestPriority \>)

Set the priority of the [`spanner::Client::Commit()`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) call.

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `request_priority` | `std::optional< RequestPriority >` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `CommitOptions &` |   |

### request_priority() const

The priority of the [`spanner::Client::Commit()`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) call.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `std::optional< RequestPriority >` |   |

### set_transaction_tag(std::optional\< std::string \>)

Set the transaction tag for the [`spanner::Client::Commit()`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) call.
Ignored for the overload that already takes a [`spanner::Transaction`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Transaction).

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `transaction_tag` | `std::optional< std::string >` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `CommitOptions &` |   |

### transaction_tag() const

The transaction tag for the [`spanner::Client::Commit()`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1Client#classgoogle_1_1cloud_1_1spanner_1_1Client_1ae83521aef8045ac04b0a5dc85b08a2d9) call.

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `std::optional< std::string > const &` |   |

### set_max_commit_delay(std::optional\< std::chrono::milliseconds \>)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
| `max_commit_delay` | `std::optional< std::chrono::milliseconds >` |

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `CommitOptions &` |   |

### max_commit_delay() const

| **Returns** ||
|---|---|
| **Type** | **Description** |
| `std::optional< std::chrono::milliseconds > const &` |   |