Reference documentation and code samples for the Cloud Spanner V1 Client class Priority.
The relative priority for requests. Note that priority is not applicable
forBeginTransaction.
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 atPRIORITY_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.
[[["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;`"]]