Reference documentation and code samples for the Cloud Spanner V1 Client class Priority.
The relative priority for requests. Note that priority is not applicable
for BeginTransaction.
The priority acts as a hint to the Cloud Spanner scheduler and does not
guarantee priority or order of execution. For example:
Some parts of a write operation always execute at PRIORITY_HIGH,
regardless of the specified priority. This may cause you to see an
increase in high priority workload even when executing a low priority
request. This can also potentially cause a priority inversion where a
lower priority request will be fulfilled ahead of a higher priority
request.
If a transaction contains multiple operations with different priorities,
Cloud Spanner does not guarantee to process the higher priority
operations first. There may be other constraints to satisfy, such as
order of operations.
Protobuf type google.spanner.v1.RequestOptions.Priority
Namespace
Google \ Cloud \ Spanner \ V1 \ RequestOptions
Methods
static::name
Parameter
Name
Description
value
mixed
static::value
Parameter
Name
Description
name
mixed
Constants
PRIORITY_UNSPECIFIED
Value: 0
PRIORITY_UNSPECIFIED is equivalent to PRIORITY_HIGH.
Generated from protobuf enum PRIORITY_UNSPECIFIED = 0;
PRIORITY_LOW
Value: 1
This specifies that the request is low priority.
Generated from protobuf enum PRIORITY_LOW = 1;
PRIORITY_MEDIUM
Value: 2
This specifies that the request is medium priority.
[[["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-09-04 UTC."],[],[],null,["# Cloud Spanner V1 Client - Class Priority (1.104.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.104.0 (latest)](/php/docs/reference/cloud-spanner/latest/V1.RequestOptions.Priority)\n- [1.103.0](/php/docs/reference/cloud-spanner/1.103.0/V1.RequestOptions.Priority)\n- [1.102.0](/php/docs/reference/cloud-spanner/1.102.0/V1.RequestOptions.Priority)\n- [1.101.0](/php/docs/reference/cloud-spanner/1.101.0/V1.RequestOptions.Priority)\n- [1.100.0](/php/docs/reference/cloud-spanner/1.100.0/V1.RequestOptions.Priority)\n- [1.98.0](/php/docs/reference/cloud-spanner/1.98.0/V1.RequestOptions.Priority)\n- [1.97.0](/php/docs/reference/cloud-spanner/1.97.0/V1.RequestOptions.Priority)\n- [1.96.0](/php/docs/reference/cloud-spanner/1.96.0/V1.RequestOptions.Priority)\n- [1.95.0](/php/docs/reference/cloud-spanner/1.95.0/V1.RequestOptions.Priority)\n- [1.94.0](/php/docs/reference/cloud-spanner/1.94.0/V1.RequestOptions.Priority)\n- [1.93.1](/php/docs/reference/cloud-spanner/1.93.1/V1.RequestOptions.Priority)\n- [1.92.1](/php/docs/reference/cloud-spanner/1.92.1/V1.RequestOptions.Priority)\n- [1.91.0](/php/docs/reference/cloud-spanner/1.91.0/V1.RequestOptions.Priority)\n- [1.90.0](/php/docs/reference/cloud-spanner/1.90.0/V1.RequestOptions.Priority)\n- [1.89.0](/php/docs/reference/cloud-spanner/1.89.0/V1.RequestOptions.Priority)\n- [1.88.0](/php/docs/reference/cloud-spanner/1.88.0/V1.RequestOptions.Priority)\n- [1.87.0](/php/docs/reference/cloud-spanner/1.87.0/V1.RequestOptions.Priority)\n- [1.86.0](/php/docs/reference/cloud-spanner/1.86.0/V1.RequestOptions.Priority)\n- [1.85.0](/php/docs/reference/cloud-spanner/1.85.0/V1.RequestOptions.Priority)\n- [1.84.0](/php/docs/reference/cloud-spanner/1.84.0/V1.RequestOptions.Priority)\n- [1.83.0](/php/docs/reference/cloud-spanner/1.83.0/V1.RequestOptions.Priority)\n- [1.82.0](/php/docs/reference/cloud-spanner/1.82.0/V1.RequestOptions.Priority)\n- [1.81.0](/php/docs/reference/cloud-spanner/1.81.0/V1.RequestOptions.Priority)\n- [1.80.0](/php/docs/reference/cloud-spanner/1.80.0/V1.RequestOptions.Priority)\n- [1.79.0](/php/docs/reference/cloud-spanner/1.79.0/V1.RequestOptions.Priority)\n- [1.78.0](/php/docs/reference/cloud-spanner/1.78.0/V1.RequestOptions.Priority)\n- [1.77.0](/php/docs/reference/cloud-spanner/1.77.0/V1.RequestOptions.Priority)\n- [1.76.1](/php/docs/reference/cloud-spanner/1.76.1/V1.RequestOptions.Priority)\n- [1.68.0](/php/docs/reference/cloud-spanner/1.68.0/V1.RequestOptions.Priority)\n- [1.67.0](/php/docs/reference/cloud-spanner/1.67.0/V1.RequestOptions.Priority)\n- [1.66.0](/php/docs/reference/cloud-spanner/1.66.0/V1.RequestOptions.Priority)\n- [1.65.0](/php/docs/reference/cloud-spanner/1.65.0/V1.RequestOptions.Priority)\n- [1.64.0](/php/docs/reference/cloud-spanner/1.64.0/V1.RequestOptions.Priority)\n- [1.63.2](/php/docs/reference/cloud-spanner/1.63.2/V1.RequestOptions.Priority)\n- [1.62.1](/php/docs/reference/cloud-spanner/1.62.1/V1.RequestOptions.Priority)\n- [1.61.0](/php/docs/reference/cloud-spanner/1.61.0/V1.RequestOptions.Priority)\n- [1.60.0](/php/docs/reference/cloud-spanner/1.60.0/V1.RequestOptions.Priority)\n- [1.59.0](/php/docs/reference/cloud-spanner/1.59.0/V1.RequestOptions.Priority)\n- [1.58.4](/php/docs/reference/cloud-spanner/1.58.4/V1.RequestOptions.Priority)\n- [1.57.0](/php/docs/reference/cloud-spanner/1.57.0/V1.RequestOptions.Priority)\n- [1.56.0](/php/docs/reference/cloud-spanner/1.56.0/V1.RequestOptions.Priority)\n- [1.55.0](/php/docs/reference/cloud-spanner/1.55.0/V1.RequestOptions.Priority)\n- [1.54.2](/php/docs/reference/cloud-spanner/1.54.2/V1.RequestOptions.Priority) \nReference documentation and code samples for the Cloud Spanner V1 Client class Priority.\n\nThe relative priority for requests. Note that priority is not applicable\nfor BeginTransaction.\n\nThe priority acts as a hint to the Cloud Spanner scheduler and does not\nguarantee priority or order of execution. For example:\n\n- Some parts of a write operation always execute at `PRIORITY_HIGH`, regardless of the specified priority. This may cause you to see an increase in high priority workload even when executing a low priority request. This can also potentially cause a priority inversion where a lower priority request will be fulfilled ahead of a higher priority request.\n- If a transaction contains multiple operations with different priorities, Cloud Spanner does not guarantee to process the higher priority operations first. There may be other constraints to satisfy, such as order of operations.\n\nProtobuf type `google.spanner.v1.RequestOptions.Priority`\n\nNamespace\n---------\n\nGoogle \\\\ Cloud \\\\ Spanner \\\\ V1 \\\\ RequestOptions\n\nMethods\n-------\n\n### static::name\n\n### static::value\n\nConstants\n---------\n\n### PRIORITY_UNSPECIFIED\n\n Value: 0\n\n`PRIORITY_UNSPECIFIED` is equivalent to `PRIORITY_HIGH`.\n\nGenerated from protobuf enum `PRIORITY_UNSPECIFIED = 0;`\n\n### PRIORITY_LOW\n\n Value: 1\n\nThis specifies that the request is low priority.\n\nGenerated from protobuf enum `PRIORITY_LOW = 1;`\n\n### PRIORITY_MEDIUM\n\n Value: 2\n\nThis specifies that the request is medium priority.\n\nGenerated from protobuf enum `PRIORITY_MEDIUM = 2;`\n\n### PRIORITY_HIGH\n\n Value: 3\n\nThis specifies that the request is high priority.\n\nGenerated from protobuf enum `PRIORITY_HIGH = 3;`"]]