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 These [QueryOptions](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/classgoogle_1_1cloud_1_1spanner_1_1QueryOptions) allow users to configure features about how their SQL queries executes on the server.

> [!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) [`QueryOptimizerVersionOption`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1QueryOptimizerVersionOption), [`QueryOptimizerStatisticsPackageOption`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1QueryOptimizerStatisticsPackageOption), [`RequestPriorityOption`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1RequestPriorityOption), or [`RequestTagOption`](https://docs.cloud.google.com/cpp/docs/reference/spanner/latest/structgoogle_1_1cloud_1_1spanner_1_1RequestTagOption).

###### See Also

<https://cloud.google.com/spanner/docs/reference/rest/v1/QueryOptions>

###### See Also

<http://cloud/spanner/docs/query-optimizer/manage-query-optimizer>

## Constructors

### QueryOptions()

### QueryOptions(QueryOptions const \&)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
|   | `QueryOptions const &` |

### QueryOptions(QueryOptions \&\&)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
|   | `QueryOptions &&` |

### QueryOptions(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=(QueryOptions const \&)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
|   | `QueryOptions const &` |

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

### operator=(QueryOptions \&\&)

| **Parameter** ||
|---|---|
| **Name** | **Description** |
|   | `QueryOptions &&` |

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

### 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

### optimizer_version() const

Returns the optimizer version.

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

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

Sets the optimizer version to the specified integer string.
Setting to the empty string will use the database default. Use the string "latest" to use the latest available optimizer version.

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

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

### optimizer_statistics_package() const

Returns the optimizer statistics package.

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

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

Sets the optimizer statistics package to the specified string.
Setting to the empty string will use the database default.

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

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

### request_priority() const

Returns the request priority.

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

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

Sets the request priority.

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

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

### request_tag() const

Returns the request tag.

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

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

Sets the request tag.

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

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