feat: Automated regeneration of Spanner client (googleapis#12810)

Auto-created at 2025-01-14 13:10:31 +0000 using the toys pull request generator.

Author: yoshi-code-bot

clients/spanner/README.md

@@ -11,7 +11,7 @@ Install this package from [Hex](https://hex.pm) by adding
 
 ```elixir
 def deps do
-  [{:google_api_spanner, "~> 0.47"}]
+  [{:google_api_spanner, "~> 0.48"}]
 end
 ```
 

clients/spanner/lib/google_api/spanner/v1/api/projects.ex

@@ -5171,7 +5171,7 @@ defmodule GoogleApi.Spanner.V1.Api.Projects do
   end
 
   @doc """
-  Executes an SQL statement, returning all results in a single reply. This method cannot be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be fetched in streaming fashion by calling ExecuteStreamingSql instead.
+  Executes an SQL statement, returning all results in a single reply. This method cannot be used to return a result set larger than 10 MiB; if the query yields more data than that, the query fails with a `FAILED_PRECONDITION` error. Operations inside read-write transactions might return `ABORTED`. If this occurs, the application should restart the transaction from the beginning. See Transaction for more details. Larger result sets can be fetched in streaming fashion by calling ExecuteStreamingSql instead. The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
 
   ## Parameters
 
@@ -5243,7 +5243,7 @@ defmodule GoogleApi.Spanner.V1.Api.Projects do
   end
 
   @doc """
-  Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql, there is no limit on the size of the returned result set. However, no individual row in the result set can exceed 100 MiB, and no column value can exceed 10 MiB.
+  Like ExecuteSql, except returns the result set as a stream. Unlike ExecuteSql, there is no limit on the size of the returned result set. However, no individual row in the result set can exceed 100 MiB, and no column value can exceed 10 MiB. The query string can be SQL or [Graph Query Language (GQL)](https://cloud.google.com/spanner/docs/reference/standard-sql/graph-intro).
 
   ## Parameters
 

clients/spanner/lib/google_api/spanner/v1/metadata.ex

@@ -20,7 +20,7 @@ defmodule GoogleApi.Spanner.V1 do
   API client metadata for GoogleApi.Spanner.V1.
   """
 
-  @discovery_revision "20241218"
+  @discovery_revision "20241220"
 
   def discovery_revision(), do: @discovery_revision
 end

clients/spanner/lib/google_api/spanner/v1/model/crontab_spec.ex

@@ -22,7 +22,7 @@ defmodule GoogleApi.Spanner.V1.Model.CrontabSpec do
   ## Attributes
 
   *   `creationWindow` (*type:* `String.t`, *default:* `nil`) - Output only. Schedule backups will contain an externally consistent copy of the database at the version time specified in `schedule_spec.cron_spec`. However, Spanner may not initiate the creation of the scheduled backups at that version time. Spanner will initiate the creation of scheduled backups within the time window bounded by the version_time specified in `schedule_spec.cron_spec` and version_time + `creation_window`.
-  *   `text` (*type:* `String.t`, *default:* `nil`) - Required. Textual representation of the crontab. User can customize the backup frequency and the backup version time using the cron expression. The version time must be in UTC timzeone. The backup will contain an externally consistent copy of the database at the version time. Allowed frequencies are 12 hour, 1 day, 1 week and 1 month. Examples of valid cron specifications: * `0 2/12 * * * ` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * * ` : every 12 hours at (2,14) hours past midnight in UTC. * `0 2 * * * ` : once a day at 2 past midnight in UTC. * `0 2 * * 0 ` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * * ` : once a month on 8th day at 2 past midnight in UTC.
+  *   `text` (*type:* `String.t`, *default:* `nil`) - Required. Textual representation of the crontab. User can customize the backup frequency and the backup version time using the cron expression. The version time must be in UTC timezone. The backup will contain an externally consistent copy of the database at the version time. Full backups must be scheduled a minimum of 12 hours apart and incremental backups must be scheduled a minimum of 4 hours apart. Examples of valid cron specifications: * `0 2/12 * * *` : every 12 hours at (2, 14) hours past midnight in UTC. * `0 2,14 * * *` : every 12 hours at (2,14) hours past midnight in UTC. * `0 */4 * * *` : (incremental backups only) every 4 hours at (0, 4, 8, 12, 16, 20) hours past midnight in UTC. * `0 2 * * *` : once a day at 2 past midnight in UTC. * `0 2 * * 0` : once a week every Sunday at 2 past midnight in UTC. * `0 2 8 * *` : once a month on 8th day at 2 past midnight in UTC.
   *   `timeZone` (*type:* `String.t`, *default:* `nil`) - Output only. The time zone of the times in `CrontabSpec.text`. Currently only UTC is supported.
   """
 

clients/spanner/lib/google_api/spanner/v1/model/execute_batch_dml_request.ex

@@ -21,6 +21,7 @@ defmodule GoogleApi.Spanner.V1.Model.ExecuteBatchDmlRequest do
 
   ## Attributes
 
+  *   `lastStatements` (*type:* `boolean()`, *default:* `nil`) - Optional. If set to true, this request marks the end of the transaction. The transaction should be committed or aborted after these statements execute, and attempts to execute any other requests against this transaction (including reads and queries) will be rejected. Setting this option may cause some error reporting to be deferred until commit time (e.g. validation of unique constraints). Given this, successful execution of statements should not be assumed until a subsequent Commit call completes successfully.
   *   `requestOptions` (*type:* `GoogleApi.Spanner.V1.Model.RequestOptions.t`, *default:* `nil`) - Common options for this request.
   *   `seqno` (*type:* `String.t`, *default:* `nil`) - Required. A per-transaction sequence number used to identify this request. This field makes each request idempotent such that if the request is received multiple times, at most one will succeed. The sequence number must be monotonically increasing within the transaction. If a request arrives for the first time with an out-of-order sequence number, the transaction may be aborted. Replays of previously handled requests will yield the same response as the first execution.
   *   `statements` (*type:* `list(GoogleApi.Spanner.V1.Model.Statement.t)`, *default:* `nil`) - Required. The list of statements to execute in this batch. Statements are executed serially, such that the effects of statement `i` are visible to statement `i+1`. Each statement must be a DML statement. Execution stops at the first failed statement; the remaining statements are not executed. Callers must provide at least one statement.
@@ -30,12 +31,14 @@ defmodule GoogleApi.Spanner.V1.Model.ExecuteBatchDmlRequest do
   use GoogleApi.Gax.ModelBase
 
   @type t :: %__MODULE__{
+          :lastStatements => boolean() | nil,
           :requestOptions => GoogleApi.Spanner.V1.Model.RequestOptions.t() | nil,
           :seqno => String.t() | nil,
           :statements => list(GoogleApi.Spanner.V1.Model.Statement.t()) | nil,
           :transaction => GoogleApi.Spanner.V1.Model.TransactionSelector.t() | nil
         }
 
+  field(:lastStatements)
   field(:requestOptions, as: GoogleApi.Spanner.V1.Model.RequestOptions)
   field(:seqno)
   field(:statements, as: GoogleApi.Spanner.V1.Model.Statement, type: :list)

clients/spanner/lib/google_api/spanner/v1/model/execute_sql_request.ex

@@ -23,6 +23,7 @@ defmodule GoogleApi.Spanner.V1.Model.ExecuteSqlRequest do
 
   *   `dataBoostEnabled` (*type:* `boolean()`, *default:* `nil`) - If this is for a partitioned query and this field is set to `true`, the request is executed with Spanner Data Boost independent compute resources. If the field is set to `true` but the request does not set `partition_token`, the API returns an `INVALID_ARGUMENT` error.
   *   `directedReadOptions` (*type:* `GoogleApi.Spanner.V1.Model.DirectedReadOptions.t`, *default:* `nil`) - Directed read options for this request.
+  *   `lastStatement` (*type:* `boolean()`, *default:* `nil`) - Optional. If set to true, this statement marks the end of the transaction. The transaction should be committed or aborted after this statement executes, and attempts to execute any other requests against this transaction (including reads and queries) will be rejected. For DML statements, setting this option may cause some error reporting to be deferred until commit time (e.g. validation of unique constraints). Given this, successful execution of a DML statement should not be assumed until a subsequent Commit call completes successfully.
   *   `paramTypes` (*type:* `%{optional(String.t) => GoogleApi.Spanner.V1.Model.Type.t}`, *default:* `nil`) - It is not always possible for Cloud Spanner to infer the right SQL type from a JSON value. For example, values of type `BYTES` and values of type `STRING` both appear in params as JSON strings. In these cases, `param_types` can be used to specify the exact SQL type for some or all of the SQL statement parameters. See the definition of Type for more information about SQL types.
   *   `params` (*type:* `map()`, *default:* `nil`) - Parameter names and values that bind to placeholders in the SQL string. A parameter placeholder consists of the `@` character followed by the parameter name (for example, `@firstName`). Parameter names must conform to the naming requirements of identifiers as specified at https://cloud.google.com/spanner/docs/lexical#identifiers. Parameters can appear anywhere that a literal value is expected. The same parameter name can be used more than once, for example: `"WHERE id > @msg_id AND id < @msg_id + 100"` It is an error to execute a SQL statement with unbound parameters.
   *   `partitionToken` (*type:* `String.t`, *default:* `nil`) - If present, results will be restricted to the specified partition previously created using PartitionQuery(). There must be an exact match for the values of fields common to this message and the PartitionQueryRequest message used to create this partition_token.
@@ -40,6 +41,7 @@ defmodule GoogleApi.Spanner.V1.Model.ExecuteSqlRequest do
   @type t :: %__MODULE__{
           :dataBoostEnabled => boolean() | nil,
           :directedReadOptions => GoogleApi.Spanner.V1.Model.DirectedReadOptions.t() | nil,
+          :lastStatement => boolean() | nil,
           :paramTypes => %{optional(String.t()) => GoogleApi.Spanner.V1.Model.Type.t()} | nil,
           :params => map() | nil,
           :partitionToken => String.t() | nil,
@@ -54,6 +56,7 @@ defmodule GoogleApi.Spanner.V1.Model.ExecuteSqlRequest do
 
   field(:dataBoostEnabled)
   field(:directedReadOptions, as: GoogleApi.Spanner.V1.Model.DirectedReadOptions)
+  field(:lastStatement)
   field(:paramTypes, as: GoogleApi.Spanner.V1.Model.Type, type: :map)
   field(:params, type: :map)
   field(:partitionToken)

clients/spanner/lib/google_api/spanner/v1/model/instance.ex

@@ -24,7 +24,7 @@ defmodule GoogleApi.Spanner.V1.Model.Instance do
   *   `autoscalingConfig` (*type:* `GoogleApi.Spanner.V1.Model.AutoscalingConfig.t`, *default:* `nil`) - Optional. The autoscaling configuration. Autoscaling is enabled if this field is set. When autoscaling is enabled, node_count and processing_units are treated as OUTPUT_ONLY fields and reflect the current compute capacity allocated to the instance.
   *   `config` (*type:* `String.t`, *default:* `nil`) - Required. The name of the instance's configuration. Values are of the form `projects//instanceConfigs/`. See also InstanceConfig and ListInstanceConfigs.
   *   `createTime` (*type:* `DateTime.t`, *default:* `nil`) - Output only. The time at which the instance was created.
-  *   `defaultBackupScheduleType` (*type:* `String.t`, *default:* `nil`) - Optional. Controls the default backup behavior for new databases within the instance. Note that `AUTOMATIC` is not permitted for free instances, as backups and backup schedules are not allowed for free instances. In the `GetInstance` or `ListInstances` response, if the value of default_backup_schedule_type is unset or NONE, no default backup schedule will be created for new databases within the instance.
+  *   `defaultBackupScheduleType` (*type:* `String.t`, *default:* `nil`) - Optional. Controls the default backup schedule behavior for new databases within the instance. By default, a backup schedule is created automatically when a new database is created in a new instance. Note that the `AUTOMATIC` value isn't permitted for free instances, as backups and backup schedules aren't supported for free instances. In the `GetInstance` or `ListInstances` response, if the value of `default_backup_schedule_type` isn't set, or set to `NONE`, Spanner doesn't create a default backup schedule for new databases in the instance.
   *   `displayName` (*type:* `String.t`, *default:* `nil`) - Required. The descriptive name for this instance as it appears in UIs. Must be unique per project and between 4 and 30 characters in length.
   *   `edition` (*type:* `String.t`, *default:* `nil`) - Optional. The `Edition` of the current instance.
   *   `endpointUris` (*type:* `list(String.t)`, *default:* `nil`) - Deprecated. This field is not populated.

clients/spanner/lib/google_api/spanner/v1/model/update_database_ddl_request.ex

@@ -22,7 +22,7 @@ defmodule GoogleApi.Spanner.V1.Model.UpdateDatabaseDdlRequest do
   ## Attributes
 
   *   `operationId` (*type:* `String.t`, *default:* `nil`) - If empty, the new update request is assigned an automatically-generated operation ID. Otherwise, `operation_id` is used to construct the name of the resulting Operation. Specifying an explicit operation ID simplifies determining whether the statements were executed in the event that the UpdateDatabaseDdl call is replayed, or the return value is otherwise lost: the database and `operation_id` fields can be combined to form the `name` of the resulting longrunning.Operation: `/operations/`. `operation_id` should be unique within the database, and must be a valid identifier: `a-z*`. Note that automatically-generated operation IDs always begin with an underscore. If the named operation already exists, UpdateDatabaseDdl returns `ALREADY_EXISTS`.
-  *   `protoDescriptors` (*type:* `String.t`, *default:* `nil`) - Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements. Contains a protobuf-serialized [google.protobufFileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). To generate it, [install](https://grpc.io/docs/protoc-installation/) and run `protoc` with --include_imports and --descriptor_set_out. For example, to generate for moon/shot/app.proto, run ``` $protoc --proto_path=/app_path --proto_path=/lib_path \\ --include_imports \\ --descriptor_set_out=descriptors.data \\ moon/shot/app.proto ``` For more details, see protobuffer [self description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
+  *   `protoDescriptors` (*type:* `String.t`, *default:* `nil`) - Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements. Contains a protobuf-serialized [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto). To generate it, [install](https://grpc.io/docs/protoc-installation/) and run `protoc` with --include_imports and --descriptor_set_out. For example, to generate for moon/shot/app.proto, run ``` $protoc --proto_path=/app_path --proto_path=/lib_path \\ --include_imports \\ --descriptor_set_out=descriptors.data \\ moon/shot/app.proto ``` For more details, see protobuffer [self description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
   *   `statements` (*type:* `list(String.t)`, *default:* `nil`) - Required. DDL statements to be applied to the database.
   """
 

clients/spanner/mix.exs

@@ -18,7 +18,7 @@
 defmodule GoogleApi.Spanner.Mixfile do
   use Mix.Project
 
-  @version "0.47.2"
+  @version "0.48.0"
 
   def project() do
     [