feat: [Spanner] add field order_by in spanner.proto

Spanner/src/V1/Gapic/SpannerGapicClient.php

@@ -1730,6 +1730,19 @@ public function partitionRead(
      *
      *           If the field is set to `true` but the request does not set
      *           `partition_token`, the API returns an `INVALID_ARGUMENT` error.
+     *     @type int $orderBy
+     *           Optional. Order for the returned rows.
+     *
+     *           By default, Spanner will return result rows in primary key order except for
+     *           PartitionRead requests. For applications that do not require rows to be
+     *           returned in primary key (`ORDER_BY_PRIMARY_KEY`) order, setting
+     *           `ORDER_BY_NO_ORDER` option allows Spanner to optimize row retrieval,
+     *           resulting in lower latencies in certain cases (e.g. bulk point lookups).
+     *           For allowed values, use constants defined on {@see \Google\Cloud\Spanner\V1\ReadRequest\OrderBy}
+     *     @type int $lockHint
+     *           Optional. Lock Hint for the request, it can only be used with read-write
+     *           transactions.
+     *           For allowed values, use constants defined on {@see \Google\Cloud\Spanner\V1\ReadRequest\LockHint}
      *     @type RetrySettings|array $retrySettings
      *           Retry settings to use for this call. Can be a {@see RetrySettings} object, or an
      *           associative array of retry settings parameters. See the documentation on
@@ -1788,6 +1801,14 @@ public function read(
             $request->setDataBoostEnabled($optionalArgs['dataBoostEnabled']);
         }
 
+        if (isset($optionalArgs['orderBy'])) {
+            $request->setOrderBy($optionalArgs['orderBy']);
+        }
+
+        if (isset($optionalArgs['lockHint'])) {
+            $request->setLockHint($optionalArgs['lockHint']);
+        }
+
         $requestParams = new RequestParamsHeaderDescriptor(
             $requestParamHeaders
         );
@@ -1943,6 +1964,19 @@ public function rollback($session, $transactionId, array $optionalArgs = [])
      *
      *           If the field is set to `true` but the request does not set
      *           `partition_token`, the API returns an `INVALID_ARGUMENT` error.
+     *     @type int $orderBy
+     *           Optional. Order for the returned rows.
+     *
+     *           By default, Spanner will return result rows in primary key order except for
+     *           PartitionRead requests. For applications that do not require rows to be
+     *           returned in primary key (`ORDER_BY_PRIMARY_KEY`) order, setting
+     *           `ORDER_BY_NO_ORDER` option allows Spanner to optimize row retrieval,
+     *           resulting in lower latencies in certain cases (e.g. bulk point lookups).
+     *           For allowed values, use constants defined on {@see \Google\Cloud\Spanner\V1\ReadRequest\OrderBy}
+     *     @type int $lockHint
+     *           Optional. Lock Hint for the request, it can only be used with read-write
+     *           transactions.
+     *           For allowed values, use constants defined on {@see \Google\Cloud\Spanner\V1\ReadRequest\LockHint}
      *     @type int $timeoutMillis
      *           Timeout to use for this call.
      * }
@@ -1999,6 +2033,14 @@ public function streamingRead(
             $request->setDataBoostEnabled($optionalArgs['dataBoostEnabled']);
         }
 
+        if (isset($optionalArgs['orderBy'])) {
+            $request->setOrderBy($optionalArgs['orderBy']);
+        }
+
+        if (isset($optionalArgs['lockHint'])) {
+            $request->setLockHint($optionalArgs['lockHint']);
+        }
+
         $requestParams = new RequestParamsHeaderDescriptor(
             $requestParamHeaders
         );