feat: add QueryOptions proto (#84)

* feat: Add QueryOptions proto

* Ignore ExecuteSqlRequestOrBuilder interface change.

This is an auto-generated interface only intended to be used internally.

Co-authored-by: Shanika Kuruppu <skuruppu@google.com>

google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/instance/v1/InstanceAdminClient.java

@@ -1003,12 +1003,13 @@ public final UnaryCallable<CreateInstanceRequest, Operation> createInstanceCalla
    *
    * @param instance Required. The instance to update, which must always include the instance name.
    *     Otherwise, only fields mentioned in
-   *     [][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be included.
+   *     [field_mask][google.spanner.admin.instance.v1.UpdateInstanceRequest.field_mask] need be
+   *     included.
    * @param fieldMask Required. A mask specifying which fields in
-   *     [][google.spanner.admin.instance.v1.UpdateInstanceRequest.instance] should be updated. The
-   *     field mask must always be specified; this prevents any future fields in
-   *     [][google.spanner.admin.instance.v1.Instance] from being erased accidentally by clients
-   *     that do not know about them.
+   *     [Instance][google.spanner.admin.instance.v1.Instance] should be updated. The field mask
+   *     must always be specified; this prevents any future fields in
+   *     [Instance][google.spanner.admin.instance.v1.Instance] from being erased accidentally by
+   *     clients that do not know about them.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   @BetaApi(

google-cloud-spanner/src/main/java/com/google/cloud/spanner/v1/SpannerClient.java

@@ -193,7 +193,7 @@ public SpannerStub getStub() {
    * queries use a transaction internally, and count toward the one transaction limit.
    *
    * <p>Active sessions use additional server resources, so it is a good idea to delete idle and
-   * unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+   * unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no
    * operations are sent for more than an hour. If a session is deleted, requests to it return
    * `NOT_FOUND`.
    *
@@ -231,7 +231,7 @@ public final Session createSession(DatabaseName database) {
    * queries use a transaction internally, and count toward the one transaction limit.
    *
    * <p>Active sessions use additional server resources, so it is a good idea to delete idle and
-   * unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+   * unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no
    * operations are sent for more than an hour. If a session is deleted, requests to it return
    * `NOT_FOUND`.
    *
@@ -266,7 +266,7 @@ public final Session createSession(String database) {
    * queries use a transaction internally, and count toward the one transaction limit.
    *
    * <p>Active sessions use additional server resources, so it is a good idea to delete idle and
-   * unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+   * unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no
    * operations are sent for more than an hour. If a session is deleted, requests to it return
    * `NOT_FOUND`.
    *
@@ -303,7 +303,7 @@ public final Session createSession(CreateSessionRequest request) {
    * queries use a transaction internally, and count toward the one transaction limit.
    *
    * <p>Active sessions use additional server resources, so it is a good idea to delete idle and
-   * unneeded sessions. Aside from explicit deletes, Cloud Spanner can delete sessions for which no
+   * unneeded sessions. Aside from explicit deletes, Cloud Spanner may delete sessions for which no
    * operations are sent for more than an hour. If a session is deleted, requests to it return
    * `NOT_FOUND`.
    *

grpc-google-cloud-spanner-admin-database-v1/src/main/java/com/google/spanner/admin/database/v1/DatabaseAdminGrpc.java

@@ -591,8 +591,8 @@ public void listDatabases(
      * have a name of the format `<database_name>/operations/<operation_id>` and
      * can be used to track preparation of the database. The
      * [metadata][google.longrunning.Operation.metadata] field type is
-     * [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-     * The [response][google.longrunning.Operation.response] field type is
+     * [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+     * [response][google.longrunning.Operation.response] field type is
      * [Database][google.spanner.admin.database.v1.Database], if successful.
      * </pre>
      */
@@ -626,8 +626,7 @@ public void getDatabase(
      * the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and can be used to
      * track execution of the schema change(s). The
      * [metadata][google.longrunning.Operation.metadata] field type is
-     * [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-     * The operation has no response.
+     * [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].  The operation has no response.
      * </pre>
      */
     public void updateDatabaseDdl(
@@ -830,8 +829,8 @@ public void listDatabases(
      * have a name of the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and
      * can be used to track preparation of the database. The
      * [metadata][google.longrunning.Operation.metadata] field type is
-     * [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-     * The [response][google.longrunning.Operation.response] field type is
+     * [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+     * [response][google.longrunning.Operation.response] field type is
      * [Database][google.spanner.admin.database.v1.Database], if successful.
      * </pre>
      */
@@ -871,8 +870,7 @@ public void getDatabase(
      * the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and can be used to
      * track execution of the schema change(s). The
      * [metadata][google.longrunning.Operation.metadata] field type is
-     * [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-     * The operation has no response.
+     * [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].  The operation has no response.
      * </pre>
      */
     public void updateDatabaseDdl(
@@ -1028,8 +1026,8 @@ public com.google.spanner.admin.database.v1.ListDatabasesResponse listDatabases(
      * have a name of the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and
      * can be used to track preparation of the database. The
      * [metadata][google.longrunning.Operation.metadata] field type is
-     * [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-     * The [response][google.longrunning.Operation.response] field type is
+     * [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+     * [response][google.longrunning.Operation.response] field type is
      * [Database][google.spanner.admin.database.v1.Database], if successful.
      * </pre>
      */
@@ -1062,8 +1060,7 @@ public com.google.spanner.admin.database.v1.Database getDatabase(
      * the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and can be used to
      * track execution of the schema change(s). The
      * [metadata][google.longrunning.Operation.metadata] field type is
-     * [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-     * The operation has no response.
+     * [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].  The operation has no response.
      * </pre>
      */
     public com.google.longrunning.Operation updateDatabaseDdl(
@@ -1198,8 +1195,8 @@ protected DatabaseAdminFutureStub build(
      * have a name of the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and
      * can be used to track preparation of the database. The
      * [metadata][google.longrunning.Operation.metadata] field type is
-     * [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata].
-     * The [response][google.longrunning.Operation.response] field type is
+     * [CreateDatabaseMetadata][google.spanner.admin.database.v1.CreateDatabaseMetadata]. The
+     * [response][google.longrunning.Operation.response] field type is
      * [Database][google.spanner.admin.database.v1.Database], if successful.
      * </pre>
      */
@@ -1233,8 +1230,7 @@ protected DatabaseAdminFutureStub build(
      * the format `&lt;database_name&gt;/operations/&lt;operation_id&gt;` and can be used to
      * track execution of the schema change(s). The
      * [metadata][google.longrunning.Operation.metadata] field type is
-     * [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].
-     * The operation has no response.
+     * [UpdateDatabaseDdlMetadata][google.spanner.admin.database.v1.UpdateDatabaseDdlMetadata].  The operation has no response.
      * </pre>
      */
     public com.google.common.util.concurrent.ListenableFuture<com.google.longrunning.Operation>