chore: update googleapis committish at Tue Jun 4 20:52:33 UTC 2024

.repo-metadata.json

@@ -2,21 +2,18 @@
   "api_shortname": "spanner",
   "name_pretty": "Cloud Spanner",
   "product_documentation": "https://cloud.google.com/spanner/docs/",
-  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-spanner/latest/history",
   "api_description": "is a fully managed, mission-critical, \nrelational database service that offers transactional consistency at global scale, \nschemas, SQL (ANSI 2011 with extensions), and automatic, synchronous replication \nfor high availability.\n\nBe sure to activate the Cloud Spanner API on the Developer's Console to\nuse Cloud Spanner from your project.",
-  "issue_tracker": "https://issuetracker.google.com/issues?q=componentid:190851%2B%20status:open",
+  "client_documentation": "https://cloud.google.com/java/docs/reference/google-cloud-spanner/latest/history",
   "release_level": "stable",
+  "transport": "both",
   "language": "java",
-  "min_java_version": 8,
   "repo": "googleapis/java-spanner",
   "repo_short": "java-spanner",
   "distribution_name": "com.google.cloud:google-cloud-spanner",
   "api_id": "spanner.googleapis.com",
-  "transport": "grpc",
+  "library_type": "GAPIC_COMBO",
   "requires_billing": true,
   "codeowner_team": "@googleapis/api-spanner-java",
-  "library_type": "GAPIC_COMBO",
   "excluded_poms": "google-cloud-spanner-bom",
-  "recommended_package": "com.google.cloud.spanner"
-}
-
+  "issue_tracker": "https://issuetracker.google.com/issues?q=componentid:190851%2B%20status:open"
+}

README.md

@@ -50,20 +50,20 @@ If you are using Maven without the BOM, add this to your dependencies:
 If you are using Gradle 5.x or later, add this to your dependencies:
 
 ```Groovy
-implementation platform('com.google.cloud:libraries-bom:26.39.0')
+implementation platform('com.google.cloud:libraries-bom:26.40.0')
 
 implementation 'com.google.cloud:google-cloud-spanner'
 ```
 If you are using Gradle without BOM, add this to your dependencies:
 
 ```Groovy
-implementation 'com.google.cloud:google-cloud-spanner:6.67.0'
+implementation 'com.google.cloud:google-cloud-spanner:6.68.1'
 ```
 
 If you are using SBT, add this to your dependencies:
 
 ```Scala
-libraryDependencies += "com.google.cloud" % "google-cloud-spanner" % "6.67.0"
+libraryDependencies += "com.google.cloud" % "google-cloud-spanner" % "6.68.1"
 ```
 <!-- {x-version-update-end} -->
 
@@ -577,7 +577,7 @@ To get help, follow the instructions in the [shared Troubleshooting document][tr
 
 ## Transport
 
-Cloud Spanner uses gRPC for the transport layer.
+Cloud Spanner uses both gRPC and HTTP/JSON for the transport layer.
 
 ## Supported Java Versions
 
@@ -671,7 +671,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/java-spanner/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-spanner.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-spanner/6.67.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-spanner/6.68.1
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

generation_config.yaml

@@ -1,6 +1,6 @@
 gapic_generator_version: 2.41.0
 protoc_version: '25.3'
-googleapis_commitish: 6f289d775912966eb0cf04bda91e5e355c998d30
+googleapis_commitish: 573205a81b9b96ea6d4e0365373839b59f4b427e
 libraries_bom_version: 26.38.0
 template_excludes:
   - ".kokoro/continuous/common.cfg"

google-cloud-spanner-executor/src/main/resources/META-INF/native-image/com.google.cloud.spanner.executor.v1/reflect-config.json

@@ -4238,6 +4238,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.spanner.executor.v1.QueryCancellationAction",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.spanner.executor.v1.QueryCancellationAction$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.spanner.executor.v1.QueryResult",
     "queryAllDeclaredConstructors": true,
@@ -5363,6 +5381,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.spanner.v1.ReadRequest$LockHint",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.spanner.v1.ReadRequest$OrderBy",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.spanner.v1.RequestOptions",
     "queryAllDeclaredConstructors": true,

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

@@ -86,8 +86,8 @@
  * Service Description: Cloud Spanner Database Admin API
  *
  * <p>The Cloud Spanner Database Admin API can be used to: &#42; create, drop, and list databases
- * &#42; update the schema of pre-existing databases &#42; create, delete and list backups for a
- * database &#42; restore a database from an existing backup
+ * &#42; update the schema of pre-existing databases &#42; create, delete, copy and list backups for
+ * a database &#42; restore a database from an existing backup
  *
  * <p>This class provides the ability to make remote calls to the backing service through method
  * calls that map to API methods. Sample code to get started:
@@ -199,7 +199,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> UpdateDatabaseDdl</td>
- *      <td><p> Updates the schema of a Cloud Spanner database by creating/altering/dropping tables, columns, indexes, etc. The returned [long-running operation][google.longrunning.Operation] will have a name of 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.</td>
+ *      <td><p> Updates the schema of a Cloud Spanner database by creating/altering/dropping tables, columns, indexes, etc. The returned [long-running operation][google.longrunning.Operation] will have a name of 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.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -337,7 +337,7 @@
  *    </tr>
  *    <tr>
  *      <td><p> CopyBackup</td>
- *      <td><p> Starts copying a Cloud Spanner Backup. The returned backup [long-running operation][google.longrunning.Operation] will have a name of the format `projects/&lt;project&gt;/instances/&lt;instance&gt;/backups/&lt;backup&gt;/operations/&lt;operation_id&gt;` and can be used to track copying of the backup. The operation is associated with the destination backup. The [metadata][google.longrunning.Operation.metadata] field type is [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The [response][google.longrunning.Operation.response] field type is [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned operation will stop the copying and delete the backup. Concurrent CopyBackup requests can run on the same source backup.</td>
+ *      <td><p> Starts copying a Cloud Spanner Backup. The returned backup [long-running operation][google.longrunning.Operation] will have a name of the format `projects/&lt;project&gt;/instances/&lt;instance&gt;/backups/&lt;backup&gt;/operations/&lt;operation_id&gt;` and can be used to track copying of the backup. The operation is associated with the destination backup. The [metadata][google.longrunning.Operation.metadata] field type is [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The [response][google.longrunning.Operation.response] field type is [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned operation will stop the copying and delete the destination backup. Concurrent CopyBackup requests can run on the same source backup.</td>
  *      <td>
  *      <p>Request object method variants only take one parameter, a request object, which must be constructed before the call.</p>
  *      <ul>
@@ -2459,8 +2459,8 @@ public final UnaryCallable<CreateBackupRequest, Operation> createBackupCallable(
    * [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The
    * [response][google.longrunning.Operation.response] field type is
    * [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned
-   * operation will stop the copying and delete the backup. Concurrent CopyBackup requests can run
-   * on the same source backup.
+   * operation will stop the copying and delete the destination backup. Concurrent CopyBackup
+   * requests can run on the same source backup.
    *
    * <p>Sample code:
    *
@@ -2517,8 +2517,8 @@ public final OperationFuture<Backup, CopyBackupMetadata> copyBackupAsync(
    * [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The
    * [response][google.longrunning.Operation.response] field type is
    * [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned
-   * operation will stop the copying and delete the backup. Concurrent CopyBackup requests can run
-   * on the same source backup.
+   * operation will stop the copying and delete the destination backup. Concurrent CopyBackup
+   * requests can run on the same source backup.
    *
    * <p>Sample code:
    *
@@ -2575,8 +2575,8 @@ public final OperationFuture<Backup, CopyBackupMetadata> copyBackupAsync(
    * [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The
    * [response][google.longrunning.Operation.response] field type is
    * [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned
-   * operation will stop the copying and delete the backup. Concurrent CopyBackup requests can run
-   * on the same source backup.
+   * operation will stop the copying and delete the destination backup. Concurrent CopyBackup
+   * requests can run on the same source backup.
    *
    * <p>Sample code:
    *
@@ -2633,8 +2633,8 @@ public final OperationFuture<Backup, CopyBackupMetadata> copyBackupAsync(
    * [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The
    * [response][google.longrunning.Operation.response] field type is
    * [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned
-   * operation will stop the copying and delete the backup. Concurrent CopyBackup requests can run
-   * on the same source backup.
+   * operation will stop the copying and delete the destination backup. Concurrent CopyBackup
+   * requests can run on the same source backup.
    *
    * <p>Sample code:
    *
@@ -2691,8 +2691,8 @@ public final OperationFuture<Backup, CopyBackupMetadata> copyBackupAsync(
    * [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The
    * [response][google.longrunning.Operation.response] field type is
    * [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned
-   * operation will stop the copying and delete the backup. Concurrent CopyBackup requests can run
-   * on the same source backup.
+   * operation will stop the copying and delete the destination backup. Concurrent CopyBackup
+   * requests can run on the same source backup.
    *
    * <p>Sample code:
    *
@@ -2733,8 +2733,8 @@ public final OperationFuture<Backup, CopyBackupMetadata> copyBackupAsync(
    * [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The
    * [response][google.longrunning.Operation.response] field type is
    * [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned
-   * operation will stop the copying and delete the backup. Concurrent CopyBackup requests can run
-   * on the same source backup.
+   * operation will stop the copying and delete the destination backup. Concurrent CopyBackup
+   * requests can run on the same source backup.
    *
    * <p>Sample code:
    *
@@ -2775,8 +2775,8 @@ public final OperationFuture<Backup, CopyBackupMetadata> copyBackupAsync(
    * [CopyBackupMetadata][google.spanner.admin.database.v1.CopyBackupMetadata]. The
    * [response][google.longrunning.Operation.response] field type is
    * [Backup][google.spanner.admin.database.v1.Backup], if successful. Cancelling the returned
-   * operation will stop the copying and delete the backup. Concurrent CopyBackup requests can run
-   * on the same source backup.
+   * operation will stop the copying and delete the destination backup. Concurrent CopyBackup
+   * requests can run on the same source backup.
    *
    * <p>Sample code:
    *
@@ -4069,7 +4069,7 @@ public final ListBackupOperationsPagedResponse listBackupOperations(
    * }</pre>
    *
    * @param parent Required. The database whose roles should be listed. Values are of the form
-   *     `projects/&lt;project&gt;/instances/&lt;instance&gt;/databases/&lt;database&gt;/databaseRoles`.
+   *     `projects/&lt;project&gt;/instances/&lt;instance&gt;/databases/&lt;database&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListDatabaseRolesPagedResponse listDatabaseRoles(DatabaseName parent) {
@@ -4101,7 +4101,7 @@ public final ListDatabaseRolesPagedResponse listDatabaseRoles(DatabaseName paren
    * }</pre>
    *
    * @param parent Required. The database whose roles should be listed. Values are of the form
-   *     `projects/&lt;project&gt;/instances/&lt;instance&gt;/databases/&lt;database&gt;/databaseRoles`.
+   *     `projects/&lt;project&gt;/instances/&lt;instance&gt;/databases/&lt;database&gt;`.
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
    */
   public final ListDatabaseRolesPagedResponse listDatabaseRoles(String parent) {

google-cloud-spanner/src/main/java/com/google/cloud/spanner/admin/database/v1/package-info.java

@@ -24,8 +24,8 @@
  * <p>Service Description: Cloud Spanner Database Admin API
  *
  * <p>The Cloud Spanner Database Admin API can be used to: &#42; create, drop, and list databases
- * &#42; update the schema of pre-existing databases &#42; create, delete and list backups for a
- * database &#42; restore a database from an existing backup
+ * &#42; update the schema of pre-existing databases &#42; create, delete, copy and list backups for
+ * a database &#42; restore a database from an existing backup
  *
  * <p>Sample for DatabaseAdminClient:
  *

google-cloud-spanner/src/main/java/com/google/cloud/spanner/v1/stub/SpannerStubSettings.java

@@ -446,13 +446,19 @@ public static class Builder extends StubSettings.Builder<SpannerStubSettings, Bu
           ImmutableMap.builder();
       definitions.put(
           "retry_policy_3_codes",
-          ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList(StatusCode.Code.UNAVAILABLE)));
+          ImmutableSet.copyOf(
+              Lists.<StatusCode.Code>newArrayList(
+                  StatusCode.Code.UNAVAILABLE, StatusCode.Code.RESOURCE_EXHAUSTED)));
       definitions.put(
           "retry_policy_2_codes",
-          ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList(StatusCode.Code.UNAVAILABLE)));
+          ImmutableSet.copyOf(
+              Lists.<StatusCode.Code>newArrayList(
+                  StatusCode.Code.UNAVAILABLE, StatusCode.Code.RESOURCE_EXHAUSTED)));
       definitions.put(
           "retry_policy_1_codes",
-          ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList(StatusCode.Code.UNAVAILABLE)));
+          ImmutableSet.copyOf(
+              Lists.<StatusCode.Code>newArrayList(
+                  StatusCode.Code.UNAVAILABLE, StatusCode.Code.RESOURCE_EXHAUSTED)));
       definitions.put(
           "no_retry_0_codes", ImmutableSet.copyOf(Lists.<StatusCode.Code>newArrayList()));
       RETRYABLE_CODE_DEFINITIONS = definitions.build();

google-cloud-spanner/src/main/resources/META-INF/native-image/com.google.cloud.spanner.v1/reflect-config.json

@@ -1988,6 +1988,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.spanner.v1.ReadRequest$LockHint",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.spanner.v1.ReadRequest$OrderBy",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.spanner.v1.RequestOptions",
     "queryAllDeclaredConstructors": true,