google-apis-bigquery_v2 0.71.0 → 0.73.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ea5bafbc02acad773631d6715b9e33deda84719df82c08d022163a24822584b5
-  data.tar.gz: e07f63a83dcef6c6979605fed92d91007b8b34597fa16c8b5d0649051d155451
+  metadata.gz: c6cf3a4ec4c0427cfb9f75ce9d56761bb2fafa4963f3427e715553fbc019daa6
+  data.tar.gz: c9c7e7a99bf5c49cf1268a955b926b4a9cc4a35b4c43923a650d96708d478818
 SHA512:
-  metadata.gz: efaf209becb06b656ab7f8b24f10c1b17d0a9589b245f423576260aff614667f00f620b906a19c293df49c111873998a065a5862fc03195caa7cb7c932bdd62b
-  data.tar.gz: 52ee5f852512ecf423398c056297e7d4bf1a8462e138e0864fa986a5f7346fefbbe01a466827a89d7887713ca8ecb6a0bbc178bc16983ebae5f7b556c508622c
+  metadata.gz: bd26b7e773dd49ebceea4179bf6ea698e5b916a8c8128b71f6964dea0c3c64b16b49a747b7e9243f964cb6c7bb7dcde10754391d672ad0ab9789769aaccf61fe
+  data.tar.gz: 624835be67d08cf72a28455703848b9581fa52a18952bc13882debc4efa4525541ebc2b746987e0c6a717834e4672a5ce9a4103dfcc95ff14a7f0ab753374eef

data/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Release history for google-apis-bigquery_v2
 
+### v0.73.0 (2024-07-25)
+
+* Regenerated from discovery document revision 20240629
+
+### v0.72.0 (2024-06-26)
+
+* Regenerated from discovery document revision 20240616
+
 ### v0.71.0 (2024-06-09)
 
 * Regenerated from discovery document revision 20240602

data/lib/google/apis/bigquery_v2/classes.rb

@@ -667,8 +667,8 @@ module Google
       
         # Required. The connection specifying the credentials to be used to read and
         # write to external storage, such as Cloud Storage. The connection_id can have
-        # the form "<project\_id>.<location\_id>.<connection\_id>" or "projects/<project\
-        # _id>/locations/<location\_id>/connections/<connection\_id>".
+        # the form ``project`.`location`.`connection_id`` or `projects/`project`/
+        # locations/`location`/connections/`connection_id`".
         # Corresponds to the JSON property `connectionId`
         # @return [String]
         attr_accessor :connection_id
@@ -680,7 +680,7 @@ module Google
       
         # Required. The fully qualified location prefix of the external folder where
         # table data is stored. The '*' wildcard character is not allowed. The URI
-        # should be in the format "gs://bucket/path_to_table/"
+        # should be in the format `gs://bucket/path_to_table/`
         # Corresponds to the JSON property `storageUri`
         # @return [String]
         attr_accessor :storage_uri
@@ -758,10 +758,10 @@ module Google
         alias_method :only_read_latest?, :only_read_latest
       
         # [Required] Qualifier of the column. Columns in the parent column family that
-        # has this exact qualifier are exposed as . field. If the qualifier is valid UTF-
-        # 8 string, it can be specified in the qualifier_string field. Otherwise, a base-
-        # 64 encoded value must be set to qualifier_encoded. The column field name is
-        # the same as the column qualifier. However, if the qualifier is not a valid
+        # has this exact qualifier are exposed as `.` field. If the qualifier is valid
+        # UTF-8 string, it can be specified in the qualifier_string field. Otherwise, a
+        # base-64 encoded value must be set to qualifier_encoded. The column field name
+        # is the same as the column qualifier. However, if the qualifier is not a valid
         # BigQuery field identifier i.e. does not match a-zA-Z*, a valid identifier must
         # be provided as field_name.
         # Corresponds to the JSON property `qualifierEncoded`
@@ -805,8 +805,8 @@ module Google
       
         # Optional. Lists of columns that should be exposed as individual fields as
         # opposed to a list of (column name, value) pairs. All columns whose qualifier
-        # matches a qualifier in this list can be accessed as .. Other columns can be
-        # accessed as a list through .Column field.
+        # matches a qualifier in this list can be accessed as `.`. Other columns can be
+        # accessed as a list through the `.Column` field.
         # Corresponds to the JSON property `columns`
         # @return [Array<Google::Apis::BigqueryV2::BigtableColumn>]
         attr_accessor :columns
@@ -1495,9 +1495,12 @@ module Google
       # If set, all subsequent queries in a script or session will have this label.
       # For the format in which a you can specify a query label, see labels in the
       # JobConfiguration resource type: https://cloud.google.com/bigquery/docs/
-      # reference/rest/v2/Job#jobconfiguration Additional properties are allowed, but
-      # ignored. Specifying multiple connection properties with the same key returns
-      # an error.
+      # reference/rest/v2/Job#jobconfiguration * **service_account**: indicates the
+      # service account to use to run a continuous query. If set, the query job uses
+      # the service account to access Google Cloud resources. Service account access
+      # is bounded by the IAM permissions that you have granted to the service account.
+      # Additional properties are allowed, but ignored. Specifying multiple
+      # connection properties with the same key returns an error.
       class ConnectionProperty
         include Google::Apis::Core::Hashable
       
@@ -1698,7 +1701,7 @@ module Google
         end
       end
       
-      # 
+      # Represents a BigQuery dataset.
       class Dataset
         include Google::Apis::Core::Hashable
       
@@ -1720,7 +1723,7 @@ module Google
         # @return [Fixnum]
         attr_accessor :creation_time
       
-        # Required. A reference that identifies the dataset.
+        # Identifier for a dataset.
         # Corresponds to the JSON property `datasetReference`
         # @return [Google::Apis::BigqueryV2::DatasetReference]
         attr_accessor :dataset_reference
@@ -1737,10 +1740,7 @@ module Google
         # @return [String]
         attr_accessor :default_collation
       
-        # The default encryption key for all tables in the dataset. After this property
-        # is set, the encryption key of all newly-created tables in the dataset is set
-        # to this value unless the table creation request or query explicitly overrides
-        # the key.
+        # Configuration for Cloud KMS encryption settings.
         # Corresponds to the JSON property `defaultEncryptionConfiguration`
         # @return [Google::Apis::BigqueryV2::EncryptionConfiguration]
         attr_accessor :default_encryption_configuration
@@ -1834,7 +1834,9 @@ module Google
       
         # The labels associated with this dataset. You can use these to organize and
         # group your datasets. You can set this property when inserting or updating a
-        # dataset. See Creating and Updating Dataset Labels for more information.
+        # dataset. See [Creating and Updating Dataset Labels](https://cloud.google.com/
+        # bigquery/docs/creating-managing-labels#creating_and_updating_dataset_labels)
+        # for more information.
         # Corresponds to the JSON property `labels`
         # @return [Hash<String,String>]
         attr_accessor :labels
@@ -1992,11 +1994,11 @@ module Google
           attr_accessor :iam_member
         
           # An IAM role ID that should be granted to the user, group, or domain specified
-          # in this access entry. The following legacy mappings will be applied: OWNER <=>
-          # roles/bigquery.dataOwner WRITER <=> roles/bigquery.dataEditor READER <=> roles/
-          # bigquery.dataViewer This field will accept any of the above formats, but will
-          # return only the legacy format. For example, if you set this field to "roles/
-          # bigquery.dataOwner", it will be returned back as "OWNER".
+          # in this access entry. The following legacy mappings will be applied: * `OWNER`:
+          # `roles/bigquery.dataOwner` * `WRITER`: `roles/bigquery.dataEditor` * `READER`:
+          # `roles/bigquery.dataViewer` This field will accept any of the above formats,
+          # but will return only the legacy format. For example, if you set this field to "
+          # roles/bigquery.dataOwner", it will be returned back as "OWNER".
           # Corresponds to the JSON property `role`
           # @return [String]
           attr_accessor :role
@@ -2006,9 +2008,9 @@ module Google
           # @return [Google::Apis::BigqueryV2::RoutineReference]
           attr_accessor :routine
         
-          # [Pick one] A special group to grant access to. Possible values include:
-          # projectOwners: Owners of the enclosing project. projectReaders: Readers of the
-          # enclosing project. projectWriters: Writers of the enclosing project.
+          # [Pick one] A special group to grant access to. Possible values include: *
+          # projectOwners: Owners of the enclosing project. * projectReaders: Readers of
+          # the enclosing project. * projectWriters: Writers of the enclosing project. *
           # allAuthenticatedUsers: All authenticated BigQuery users. Maps to similarly-
           # named IAM members.
           # Corresponds to the JSON property `specialGroup`
@@ -2084,7 +2086,7 @@ module Google
       class DatasetAccessEntry
         include Google::Apis::Core::Hashable
       
-        # The dataset this entry applies to
+        # Identifier for a dataset.
         # Corresponds to the JSON property `dataset`
         # @return [Google::Apis::BigqueryV2::DatasetReference]
         attr_accessor :dataset
@@ -2161,8 +2163,7 @@ module Google
         class Dataset
           include Google::Apis::Core::Hashable
         
-          # The dataset reference. Use this property to access specific parts of the
-          # dataset's ID, such as project ID or dataset ID.
+          # Identifier for a dataset.
           # Corresponds to the JSON property `datasetReference`
           # @return [Google::Apis::BigqueryV2::DatasetReference]
           attr_accessor :dataset_reference
@@ -2210,7 +2211,7 @@ module Google
         end
       end
       
-      # 
+      # Identifier for a dataset.
       class DatasetReference
         include Google::Apis::Core::Hashable
       
@@ -2502,7 +2503,7 @@ module Google
         end
       end
       
-      # 
+      # Configuration for Cloud KMS encryption settings.
       class EncryptionConfiguration
         include Google::Apis::Core::Hashable
       
@@ -3076,8 +3077,8 @@ module Google
       
         # Optional. The connection specifying the credentials to be used to read
         # external storage, such as Azure Blob, Cloud Storage, or S3. The connection_id
-        # can have the form "<project\_id>.<location\_id>.<connection\_id>" or "projects/
-        # <project\_id>/locations/<location\_id>/connections/<connection\_id>".
+        # can have the form ``project_id`.`location_id`;`connection_id`` or `projects/`
+        # project_id`/locations/`location_id`/connections/`connection_id``.
         # Corresponds to the JSON property `connectionId`
         # @return [String]
         attr_accessor :connection_id
@@ -4572,7 +4573,7 @@ module Google
         # @return [Array<String>]
         attr_accessor :decimal_target_types
       
-        # Custom encryption configuration (e.g., Cloud KMS keys)
+        # Configuration for Cloud KMS encryption settings.
         # Corresponds to the JSON property `destinationEncryptionConfiguration`
         # @return [Google::Apis::BigqueryV2::EncryptionConfiguration]
         attr_accessor :destination_encryption_configuration
@@ -4905,16 +4906,12 @@ module Google
         attr_accessor :create_session
         alias_method :create_session?, :create_session
       
-        # Optional. Specifies the default dataset to use for unqualified table names in
-        # the query. This setting does not alter behavior of unqualified dataset names.
-        # Setting the system variable `@@dataset_id` achieves the same behavior. See
-        # https://cloud.google.com/bigquery/docs/reference/system-variables for more
-        # information on system variables.
+        # Identifier for a dataset.
         # Corresponds to the JSON property `defaultDataset`
         # @return [Google::Apis::BigqueryV2::DatasetReference]
         attr_accessor :default_dataset
       
-        # Custom encryption configuration (e.g., Cloud KMS keys)
+        # Configuration for Cloud KMS encryption settings.
         # Corresponds to the JSON property `destinationEncryptionConfiguration`
         # @return [Google::Apis::BigqueryV2::EncryptionConfiguration]
         attr_accessor :destination_encryption_configuration
@@ -5116,7 +5113,7 @@ module Google
         # @return [String]
         attr_accessor :create_disposition
       
-        # Custom encryption configuration (e.g., Cloud KMS keys).
+        # Configuration for Cloud KMS encryption settings.
         # Corresponds to the JSON property `destinationEncryptionConfiguration`
         # @return [Google::Apis::BigqueryV2::EncryptionConfiguration]
         attr_accessor :destination_encryption_configuration
@@ -5557,7 +5554,7 @@ module Google
         attr_accessor :cache_hit
         alias_method :cache_hit?, :cache_hit
       
-        # Output only. Referenced dataset for DCL statement.
+        # Identifier for a dataset.
         # Corresponds to the JSON property `dclTargetDataset`
         # @return [Google::Apis::BigqueryV2::DatasetReference]
         attr_accessor :dcl_target_dataset
@@ -5590,8 +5587,7 @@ module Google
         # @return [String]
         attr_accessor :ddl_operation_performed
       
-        # Output only. The DDL target dataset. Present only for CREATE/ALTER/DROP SCHEMA(
-        # dataset) queries.
+        # Identifier for a dataset.
         # Corresponds to the JSON property `ddlTargetDataset`
         # @return [Google::Apis::BigqueryV2::DatasetReference]
         attr_accessor :ddl_target_dataset
@@ -6161,7 +6157,7 @@ module Google
       class LinkedDatasetSource
         include Google::Apis::Core::Hashable
       
-        # The source dataset reference contains project numbers and not project ids.
+        # Identifier for a dataset.
         # Corresponds to the JSON property `sourceDataset`
         # @return [Google::Apis::BigqueryV2::DatasetReference]
         attr_accessor :source_dataset
@@ -6578,10 +6574,7 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Custom encryption configuration (e.g., Cloud KMS keys). This shows the
-        # encryption configuration of the model data while stored in BigQuery storage.
-        # This field can be used with PatchModel to update encryption key for an already
-        # encrypted model.
+        # Configuration for Cloud KMS encryption settings.
         # Corresponds to the JSON property `encryptionConfiguration`
         # @return [Google::Apis::BigqueryV2::EncryptionConfiguration]
         attr_accessor :encryption_configuration
@@ -6912,7 +6905,7 @@ module Google
       class PartitionedColumn
         include Google::Apis::Core::Hashable
       
-        # Output only. The name of the partition column.
+        # Required. The name of the partition column.
         # Corresponds to the JSON property `field`
         # @return [String]
         attr_accessor :field
@@ -6927,14 +6920,19 @@ module Google
         end
       end
       
-      # The partitioning information, which includes managed table and external table
-      # partition information.
+      # The partitioning information, which includes managed table, external table and
+      # metastore partitioned table partition information.
       class PartitioningDefinition
         include Google::Apis::Core::Hashable
       
-        # Output only. Details about each partitioning column. BigQuery native tables
-        # only support 1 partitioning column. Other table types may support 0, 1 or more
-        # partitioning columns.
+        # Optional. Details about each partitioning column. This field is output only
+        # for all partitioning types other than metastore partitioned tables. BigQuery
+        # native tables only support 1 partitioning column. Other table types may
+        # support 0, 1 or more partitioning columns. For metastore partitioned tables,
+        # the order must match the definition order in the Hive Metastore, where it must
+        # match the physical layout of the table. For example, CREATE TABLE a_table(id
+        # BIGINT, name STRING) PARTITIONED BY (city STRING, state STRING). In this case
+        # the values must be ['city', 'state'] in that order.
         # Corresponds to the JSON property `partitionedColumn`
         # @return [Array<Google::Apis::BigqueryV2::PartitionedColumn>]
         attr_accessor :partitioned_column
@@ -7443,9 +7441,7 @@ module Google
         attr_accessor :create_session
         alias_method :create_session?, :create_session
       
-        # Optional. Specifies the default datasetId and projectId to assume for any
-        # unqualified table names in the query. If not set, all table names in the query
-        # string must be qualified in the format 'datasetId.tableId'.
+        # Identifier for a dataset.
         # Corresponds to the JSON property `defaultDataset`
         # @return [Google::Apis::BigqueryV2::DatasetReference]
         attr_accessor :default_dataset
@@ -9251,7 +9247,7 @@ module Google
         # @return [String]
         attr_accessor :description
       
-        # Custom encryption configuration (e.g., Cloud KMS keys).
+        # Configuration for Cloud KMS encryption settings.
         # Corresponds to the JSON property `encryptionConfiguration`
         # @return [Google::Apis::BigqueryV2::EncryptionConfiguration]
         attr_accessor :encryption_configuration
@@ -9421,8 +9417,8 @@ module Google
         # @return [Fixnum]
         attr_accessor :num_total_physical_bytes
       
-        # The partitioning information, which includes managed table and external table
-        # partition information.
+        # The partitioning information, which includes managed table, external table and
+        # metastore partitioned table partition information.
         # Corresponds to the JSON property `partitionDefinition`
         # @return [Google::Apis::BigqueryV2::PartitioningDefinition]
         attr_accessor :partition_definition
@@ -10293,6 +10289,12 @@ module Google
         # @return [String]
         attr_accessor :explanation
       
+        # Duration since last refresh as of this job for managed tables (indicates
+        # metadata cache staleness as seen by this job).
+        # Corresponds to the JSON property `staleness`
+        # @return [String]
+        attr_accessor :staleness
+      
         # Metadata caching eligible table referenced in the query.
         # Corresponds to the JSON property `tableReference`
         # @return [Google::Apis::BigqueryV2::TableReference]
@@ -10315,6 +10317,7 @@ module Google
         # Update properties of this object
         def update!(**args)
           @explanation = args[:explanation] if args.key?(:explanation)
+          @staleness = args[:staleness] if args.key?(:staleness)
           @table_reference = args[:table_reference] if args.key?(:table_reference)
           @table_type = args[:table_type] if args.key?(:table_type)
           @unused_reason = args[:unused_reason] if args.key?(:unused_reason)

data/lib/google/apis/bigquery_v2/gem_version.rb

@@ -16,13 +16,13 @@ module Google
   module Apis
     module BigqueryV2
       # Version of the google-apis-bigquery_v2 gem
-      GEM_VERSION = "0.71.0"
+      GEM_VERSION = "0.73.0"
 
       # Version of the code generator used to generate this client
       GENERATOR_VERSION = "0.15.0"
 
       # Revision of the discovery document this client was generated from
-      REVISION = "20240602"
+      REVISION = "20240629"
     end
   end
 end

data/lib/google/apis/bigquery_v2/representations.rb

@@ -3863,6 +3863,7 @@ module Google
         # @private
         class Representation < Google::Apis::Core::JsonRepresentation
           property :explanation, as: 'explanation'
+          property :staleness, as: 'staleness'
           property :table_reference, as: 'tableReference', class: Google::Apis::BigqueryV2::TableReference, decorator: Google::Apis::BigqueryV2::TableReference::Representation
       
           property :table_type, as: 'tableType'

data/lib/google/apis/bigquery_v2/service.rb

@@ -167,9 +167,9 @@ module Google
         #   Whether to list all datasets, including hidden ones
         # @param [String] filter
         #   An expression for filtering the results of the request by label. The syntax is
-        #   \"labels.<name>[:<value>]\". Multiple filters can be ANDed together by
-        #   connecting with a space. Example: \"labels.department:receiving labels.active\"
-        #   . See [Filtering datasets using labels](/bigquery/docs/filtering-labels#
+        #   `labels.[:]`. Multiple filters can be ANDed together by connecting with a
+        #   space. Example: `labels.department:receiving labels.active`. See [Filtering
+        #   datasets using labels](https://cloud.google.com/bigquery/docs/filtering-labels#
         #   filtering_datasets_using_labels) for details.
         # @param [Fixnum] max_results
         #   The maximum number of results to return in a single response page. Leverage
@@ -331,8 +331,8 @@ module Google
         #   Required. Job ID of the job to cancel
         # @param [String] location
         #   The geographic location of the job. You must specify the location to run the
-        #   job for the following scenarios: - If the location to run a job is not in the `
-        #   us` or the `eu` multi-regional location - If the job's location is in a single
+        #   job for the following scenarios: * If the location to run a job is not in the `
+        #   us` or the `eu` multi-regional location * If the job's location is in a single
         #   region (for example, `us-central1`) For more information, see https://cloud.
         #   google.com/bigquery/docs/locations#specifying_your_location.
         # @param [String] fields
@@ -411,8 +411,8 @@ module Google
         #   Required. Job ID of the requested job.
         # @param [String] location
         #   The geographic location of the job. You must specify the location to run the
-        #   job for the following scenarios: - If the location to run a job is not in the `
-        #   us` or the `eu` multi-regional location - If the job's location is in a single
+        #   job for the following scenarios: * If the location to run a job is not in the `
+        #   us` or the `eu` multi-regional location * If the job's location is in a single
         #   region (for example, `us-central1`) For more information, see https://cloud.
         #   google.com/bigquery/docs/locations#specifying_your_location.
         # @param [String] fields
@@ -453,8 +453,8 @@ module Google
         #   Optional. Output timestamp as usec int64. Default is false.
         # @param [String] location
         #   The geographic location of the job. You must specify the location to run the
-        #   job for the following scenarios: - If the location to run a job is not in the `
-        #   us` or the `eu` multi-regional location - If the job's location is in a single
+        #   job for the following scenarios: * If the location to run a job is not in the `
+        #   us` or the `eu` multi-regional location * If the job's location is in a single
         #   region (for example, `us-central1`) For more information, see https://cloud.
         #   google.com/bigquery/docs/locations#specifying_your_location.
         # @param [Fixnum] max_results

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-apis-bigquery_v2
 version: !ruby/object:Gem::Version
-  version: 0.71.0
+  version: 0.73.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-06-09 00:00:00.000000000 Z
+date: 2024-07-25 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-apis-core
@@ -58,7 +58,7 @@ licenses:
 metadata:
   bug_tracker_uri: https://github.com/googleapis/google-api-ruby-client/issues
   changelog_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-bigquery_v2/CHANGELOG.md
-  documentation_uri: https://googleapis.dev/ruby/google-apis-bigquery_v2/v0.71.0
+  documentation_uri: https://googleapis.dev/ruby/google-apis-bigquery_v2/v0.73.0
   source_code_uri: https://github.com/googleapis/google-api-ruby-client/tree/main/generated/google-apis-bigquery_v2
 post_install_message: 
 rdoc_options: []