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>

Author: yoshi-automation

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>