A per-request tag which can be applied to queries or reads, used for
statistics collection.
Both request_tag and transaction_tag can be specified for a read or query
that belongs to a transaction.
This field is ignored for requests where it's not applicable (e.g.
CommitRequest).
Legal characters for request_tag values are all printable characters
(ASCII 32 - 126) and the length of a request_tag is limited to 50
characters. Values that exceed this limit are truncated.
Any leading underscore (_) characters will be removed from the string.
A per-request tag which can be applied to queries or reads, used for
statistics collection.
Both request_tag and transaction_tag can be specified for a read or query
that belongs to a transaction.
This field is ignored for requests where it's not applicable (e.g.
CommitRequest).
Legal characters for request_tag values are all printable characters
(ASCII 32 - 126) and the length of a request_tag is limited to 50
characters. Values that exceed this limit are truncated.
Any leading underscore (_) characters will be removed from the string.
A tag used for statistics collection about this transaction.
Both request_tag and transaction_tag can be specified for a read or query
that belongs to a transaction.
The value of transaction_tag should be the same for all requests belonging
to the same transaction.
If this request doesn't belong to any transaction, transaction_tag will be
ignored.
Legal characters for transaction_tag values are all printable characters
(ASCII 32 - 126) and the length of a transaction_tag is limited to 50
characters. Values that exceed this limit are truncated.
Any leading underscore (_) characters will be removed from the string.
A tag used for statistics collection about this transaction.
Both request_tag and transaction_tag can be specified for a read or query
that belongs to a transaction.
The value of transaction_tag should be the same for all requests belonging
to the same transaction.
If this request doesn't belong to any transaction, transaction_tag will be
ignored.
Legal characters for transaction_tag values are all printable characters
(ASCII 32 - 126) and the length of a transaction_tag is limited to 50
characters. Values that exceed this limit are truncated.
Any leading underscore (_) characters will be removed from the string.
[[["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-08-28 UTC."],[],[],null,["# Interface RequestOptionsOrBuilder (6.98.1)\n\nVersion latestkeyboard_arrow_down\n\n- [6.98.1 (latest)](/java/docs/reference/google-cloud-spanner/latest/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.98.0](/java/docs/reference/google-cloud-spanner/6.98.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.97.1](/java/docs/reference/google-cloud-spanner/6.97.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.96.1](/java/docs/reference/google-cloud-spanner/6.96.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.95.1](/java/docs/reference/google-cloud-spanner/6.95.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.94.0](/java/docs/reference/google-cloud-spanner/6.94.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.93.0](/java/docs/reference/google-cloud-spanner/6.93.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.89.0](/java/docs/reference/google-cloud-spanner/6.89.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.88.0](/java/docs/reference/google-cloud-spanner/6.88.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.87.0](/java/docs/reference/google-cloud-spanner/6.87.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.86.0](/java/docs/reference/google-cloud-spanner/6.86.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.85.0](/java/docs/reference/google-cloud-spanner/6.85.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.83.0](/java/docs/reference/google-cloud-spanner/6.83.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.82.0](/java/docs/reference/google-cloud-spanner/6.82.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.80.1](/java/docs/reference/google-cloud-spanner/6.80.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.79.0](/java/docs/reference/google-cloud-spanner/6.79.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.77.0](/java/docs/reference/google-cloud-spanner/6.77.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.74.1](/java/docs/reference/google-cloud-spanner/6.74.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.72.0](/java/docs/reference/google-cloud-spanner/6.72.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.71.0](/java/docs/reference/google-cloud-spanner/6.71.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.69.0](/java/docs/reference/google-cloud-spanner/6.69.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.68.0](/java/docs/reference/google-cloud-spanner/6.68.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.66.0](/java/docs/reference/google-cloud-spanner/6.66.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.65.1](/java/docs/reference/google-cloud-spanner/6.65.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.62.0](/java/docs/reference/google-cloud-spanner/6.62.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.60.0](/java/docs/reference/google-cloud-spanner/6.60.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.58.0](/java/docs/reference/google-cloud-spanner/6.58.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.57.0](/java/docs/reference/google-cloud-spanner/6.57.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.56.0](/java/docs/reference/google-cloud-spanner/6.56.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.55.0](/java/docs/reference/google-cloud-spanner/6.55.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.54.0](/java/docs/reference/google-cloud-spanner/6.54.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.53.0](/java/docs/reference/google-cloud-spanner/6.53.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.52.1](/java/docs/reference/google-cloud-spanner/6.52.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.51.0](/java/docs/reference/google-cloud-spanner/6.51.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.50.1](/java/docs/reference/google-cloud-spanner/6.50.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.49.0](/java/docs/reference/google-cloud-spanner/6.49.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.25.1](/java/docs/reference/google-cloud-spanner/6.25.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.24.0](/java/docs/reference/google-cloud-spanner/6.24.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.23.4](/java/docs/reference/google-cloud-spanner/6.23.4/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.22.0](/java/docs/reference/google-cloud-spanner/6.22.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.21.2](/java/docs/reference/google-cloud-spanner/6.21.2/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.20.0](/java/docs/reference/google-cloud-spanner/6.20.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.19.1](/java/docs/reference/google-cloud-spanner/6.19.1/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.18.0](/java/docs/reference/google-cloud-spanner/6.18.0/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.17.4](/java/docs/reference/google-cloud-spanner/6.17.4/com.google.spanner.v1.RequestOptionsOrBuilder)\n- [6.14.1](/java/docs/reference/google-cloud-spanner/6.14.1/com.google.spanner.v1.RequestOptionsOrBuilder) \n\n public interface RequestOptionsOrBuilder extends MessageOrBuilder\n\nImplements\n----------\n\n[MessageOrBuilder](https://cloud.google.com/java/docs/reference/protobuf/latest/com.google.protobuf.MessageOrBuilder.html)\n\nMethods\n-------\n\n### getPriority()\n\n public abstract RequestOptions.Priority getPriority()\n\nPriority for the request.\n\n`.google.spanner.v1.RequestOptions.Priority priority = 1;`\n\n### getPriorityValue()\n\n public abstract int getPriorityValue()\n\nPriority for the request.\n\n`.google.spanner.v1.RequestOptions.Priority priority = 1;`\n\n### getRequestTag()\n\n public abstract String getRequestTag()\n\nA per-request tag which can be applied to queries or reads, used for\nstatistics collection.\nBoth request_tag and transaction_tag can be specified for a read or query\nthat belongs to a transaction.\nThis field is ignored for requests where it's not applicable (e.g.\nCommitRequest).\nLegal characters for `request_tag` values are all printable characters\n(ASCII 32 - 126) and the length of a request_tag is limited to 50\ncharacters. Values that exceed this limit are truncated.\nAny leading underscore (_) characters will be removed from the string.\n\n`string request_tag = 2;`\n\n### getRequestTagBytes()\n\n public abstract ByteString getRequestTagBytes()\n\nA per-request tag which can be applied to queries or reads, used for\nstatistics collection.\nBoth request_tag and transaction_tag can be specified for a read or query\nthat belongs to a transaction.\nThis field is ignored for requests where it's not applicable (e.g.\nCommitRequest).\nLegal characters for `request_tag` values are all printable characters\n(ASCII 32 - 126) and the length of a request_tag is limited to 50\ncharacters. Values that exceed this limit are truncated.\nAny leading underscore (_) characters will be removed from the string.\n\n`string request_tag = 2;`\n\n### getTransactionTag()\n\n public abstract String getTransactionTag()\n\nA tag used for statistics collection about this transaction.\nBoth request_tag and transaction_tag can be specified for a read or query\nthat belongs to a transaction.\nThe value of transaction_tag should be the same for all requests belonging\nto the same transaction.\nIf this request doesn't belong to any transaction, transaction_tag will be\nignored.\nLegal characters for `transaction_tag` values are all printable characters\n(ASCII 32 - 126) and the length of a transaction_tag is limited to 50\ncharacters. Values that exceed this limit are truncated.\nAny leading underscore (_) characters will be removed from the string.\n\n`string transaction_tag = 3;`\n\n### getTransactionTagBytes()\n\n public abstract ByteString getTransactionTagBytes()\n\nA tag used for statistics collection about this transaction.\nBoth request_tag and transaction_tag can be specified for a read or query\nthat belongs to a transaction.\nThe value of transaction_tag should be the same for all requests belonging\nto the same transaction.\nIf this request doesn't belong to any transaction, transaction_tag will be\nignored.\nLegal characters for `transaction_tag` values are all printable characters\n(ASCII 32 - 126) and the length of a transaction_tag is limited to 50\ncharacters. Values that exceed this limit are truncated.\nAny leading underscore (_) characters will be removed from the string.\n\n`string transaction_tag = 3;`"]]