google-cloud-bigquery 1.52.1 → 1.55.0

data/lib/google/cloud/bigquery/query_job.rb

@@ -723,6 +723,8 @@ module Google
         #   identifying the result set.
         # @param [Integer] max Maximum number of results to return.
         # @param [Integer] start Zero-based index of the starting row to read.
+        # @param [Boolean] format_options_use_int64_timestamp Output timestamp
+        #   as usec int64. Default is true.
         #
         # @return [Google::Cloud::Bigquery::Data] An object providing access to
         #   data read from the destination table for the job.
@@ -745,20 +747,21 @@ module Google
         #   # Retrieve the next page of results
         #   data = data.next if data.next?
         #
-        def data token: nil, max: nil, start: nil
+        def data token: nil, max: nil, start: nil, format_options_use_int64_timestamp: true
           return nil unless done?
-          return Data.from_gapi_json({ rows: [] }, nil, @gapi, service) if dryrun?
+          return Data.from_gapi_json({ rows: [] }, nil, @gapi, service, format_options_use_int64_timestamp) if dryrun?
           if ddl? || dml? || !ensure_schema!
             data_hash = { totalRows: nil, rows: [] }
-            return Data.from_gapi_json data_hash, nil, @gapi, service
+            return Data.from_gapi_json data_hash, nil, @gapi, service, format_options_use_int64_timestamp
           end
 
           data_hash = service.list_tabledata destination_table_dataset_id,
                                              destination_table_table_id,
                                              token: token,
                                              max: max,
-                                             start: start
-          Data.from_gapi_json data_hash, destination_table_gapi, @gapi, service
+                                             start: start,
+                                             format_options_use_int64_timestamp: format_options_use_int64_timestamp
+          Data.from_gapi_json data_hash, destination_table_gapi, @gapi, service, format_options_use_int64_timestamp
         end
         alias query_results data
 

data/lib/google/cloud/bigquery/routine.rb

@@ -690,6 +690,59 @@ module Google
           @gapi.determinism_level == "NOT_DETERMINISTIC"
         end
 
+        ##
+        # The data governance type of the routine. Optional.
+        #
+        # If set to `DATA_MASKING`, the function is validated and made
+        # available as a masking function. For more information, see [Create custom
+        # masking routines](https://cloud.google.com/bigquery/docs/user-defined-functions#custom-mask).
+        #
+        # @return [String, nil] The data governance type, or `nil` if not set or the object is a reference
+        #   (see {#reference?}).
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   routine = dataset.routine "my_routine"
+        #
+        #   routine.data_governance_type #=> "DATA_MASKING"
+        #
+        # @!group Attributes
+        #
+        def data_governance_type
+          return nil if reference?
+          ensure_full_data!
+          @gapi.data_governance_type
+        end
+
+        ##
+        # Updates the data governance type of the routine. Optional.
+        #
+        # If set to `DATA_MASKING`, the function is validated and made
+        # available as a masking function. For more information, see [Create custom
+        # masking routines](https://cloud.google.com/bigquery/docs/user-defined-functions#custom-mask).
+        #
+        # @param [String, nil] new_data_governance_type The new data governance type. `nil` to unset.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   routine = dataset.routine "my_routine"
+        #
+        #   routine.data_governance_type = "DATA_MASKING"
+        #
+        # @!group Attributes
+        #
+        def data_governance_type= new_data_governance_type
+          ensure_full_data!
+          @gapi.data_governance_type = new_data_governance_type
+          update_gapi!
+        end
+
         ##
         # Updates the routine with changes made in the given block in a single update request. The following attributes
         # may be set: {Updater#routine_type=}, {Updater#language=}, {Updater#arguments=}, {Updater#return_type=},
@@ -1198,6 +1251,30 @@ module Google
             @gapi.determinism_level = new_determinism_level
           end
 
+          ##
+          # Updates the data governance type of the routine. Optional.
+          #
+          # If set to `DATA_MASKING`, the function is validated and made
+          # available as a masking function. For more information, see [Create custom
+          # masking routines](https://cloud.google.com/bigquery/docs/user-defined-functions#custom-mask).
+          #
+          # @param [String, nil] new_data_governance_type The new data governance type. `nil` to unset.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   routine = dataset.routine "my_routine"
+          #
+          #   routine.data_governance_type = "DATA_MASKING"
+          #
+          # @!group Attributes
+          #
+          def data_governance_type= new_data_governance_type
+            @gapi.data_governance_type = new_data_governance_type
+          end
+
           def update
             raise "not implemented in #{self.class}"
           end

data/lib/google/cloud/bigquery/service.rb

@@ -109,29 +109,29 @@ module Google
 
         ##
         # Returns the dataset specified by datasetID.
-        def get_dataset dataset_id
-          get_project_dataset @project, dataset_id
+        def get_dataset dataset_id, access_policy_version: nil
+          get_project_dataset @project, dataset_id, access_policy_version: access_policy_version
         end
 
         ##
         # Gets the specified dataset resource by full dataset reference.
-        def get_project_dataset project_id, dataset_id
+        def get_project_dataset project_id, dataset_id, access_policy_version: nil
           # The get operation is considered idempotent
           execute backoff: true do
-            service.get_dataset project_id, dataset_id
+            service.get_dataset project_id, dataset_id, access_policy_version: access_policy_version
           end
         end
 
         ##
         # Creates a new empty dataset.
-        def insert_dataset new_dataset_gapi
-          execute { service.insert_dataset @project, new_dataset_gapi }
+        def insert_dataset new_dataset_gapi, access_policy_version: nil
+          execute { service.insert_dataset @project, new_dataset_gapi, access_policy_version: access_policy_version }
         end
 
         ##
         # Updates information in an existing dataset, only replacing
         # fields that are provided in the submitted dataset resource.
-        def patch_dataset dataset_id, patched_dataset_gapi
+        def patch_dataset dataset_id, patched_dataset_gapi, access_policy_version: nil
           patch_with_backoff = false
           options = {}
           if patched_dataset_gapi.etag
@@ -140,7 +140,8 @@ module Google
             patch_with_backoff = true
           end
           execute backoff: patch_with_backoff do
-            service.patch_dataset @project, dataset_id, patched_dataset_gapi, options: options
+            service.patch_dataset @project, dataset_id, patched_dataset_gapi, options: options,
+access_policy_version: access_policy_version
           end
         end
 
@@ -244,7 +245,8 @@ module Google
 
         ##
         # Retrieves data from the table.
-        def list_tabledata dataset_id, table_id, max: nil, token: nil, start: nil
+        def list_tabledata dataset_id, table_id, max: nil, token: nil, start: nil,
+                           format_options_use_int64_timestamp: nil
           # The list operation is considered idempotent
           execute backoff: true do
             json_txt = service.list_table_data \
@@ -252,7 +254,8 @@ module Google
               max_results: max,
               page_token:  token,
               start_index: start,
-              options:     { skip_deserialization: true }
+              options:     { skip_deserialization: true },
+              format_options_use_int64_timestamp: format_options_use_int64_timestamp
             JSON.parse json_txt, symbolize_names: true
           end
         end
@@ -456,7 +459,8 @@ module Google
 
         ##
         # Returns the query data for the job
-        def job_query_results job_id, location: nil, max: nil, token: nil, start: nil, timeout: nil
+        def job_query_results job_id, location: nil, max: nil, token: nil,
+                              start: nil, timeout: nil, format_options_use_int64_timestamp: nil
           # The get operation is considered idempotent
           execute backoff: true do
             service.get_job_query_results @project, job_id,
@@ -464,7 +468,8 @@ module Google
                                           max_results: max,
                                           page_token:  token,
                                           start_index: start,
-                                          timeout_ms:  timeout
+                                          timeout_ms:  timeout,
+                                          format_options_use_int64_timestamp: format_options_use_int64_timestamp
           end
         end
 

data/lib/google/cloud/bigquery/table.rb

@@ -1017,6 +1017,77 @@ module Google
           patch_gapi! :labels
         end
 
+        ##
+        # The resource tags associated with this table. Tag keys are globally unique.
+        #
+        # @see https://cloud.google.com/iam/docs/tags-access-control#definitions
+        #   For additional information on tags.
+        #
+        # The returned hash is frozen and changes are not allowed. Use
+        # {#resource_tags=} to replace the entire hash.
+        #
+        # @return [Hash<String, String>, nil] A hash containing key/value pairs.
+        #
+        #   * The key is the namespaced friendly name of the tag key, e.g.
+        #     "12345/environment" where 12345 is the ID of the parent organization
+        #     or project resource for this tag key.
+        #   * The value is the friendly short name of the tag value, e.g. "production".
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.table "my_table"
+        #
+        #   resource_tags = table.resource_tags
+        #   resource_tags["12345/environment"] #=> "production"
+        #
+        # @!group Attributes
+        #
+        def resource_tags
+          return nil if reference?
+          m = @gapi.resource_tags
+          m = m.to_h if m.respond_to? :to_h
+          m.dup.freeze
+        end
+
+        ##
+        # Updates the resource tags associated with this table. Tag keys are globally
+        # unique.
+        #
+        # @see https://cloud.google.com/iam/docs/tags-access-control#definitions
+        #   For additional information on tags.
+        #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
+        # @param [Hash<String, String>] resource_tags A hash containing key/value
+        #   pairs.
+        #
+        #   * The key is the namespaced friendly name of the tag key, e.g.
+        #     "12345/environment" where 12345 is the ID of the parent organization
+        #     or project resource for this tag key.
+        #   * The value is the friendly short name of the tag value, e.g. "production".
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   table = dataset.table "my_table"
+        #
+        #   table.resource_tags = { "12345/environment" => "production" }
+        #
+        # @!group Attributes
+        #
+        def resource_tags= resource_tags
+          reload! unless resource_full?
+          @gapi.resource_tags = resource_tags
+          patch_gapi! :resource_tags
+        end
+
         ##
         # Returns the table's schema. If the table is not a view (See {#view?}),
         # this method can also be used to set, replace, or add to the schema by
@@ -1630,6 +1701,8 @@ module Google
         #
         # @param [Integer] max Maximum number of results to return.
         # @param [Integer] start Zero-based index of the starting row to read.
+        # @param [Boolean] format_options_use_int64_timestamp Output timestamp
+        #   as usec int64. Default is true.
         #
         # @return [Google::Cloud::Bigquery::Data]
         #
@@ -1664,11 +1737,12 @@ module Google
         #
         # @!group Data
         #
-        def data token: nil, max: nil, start: nil
+        def data token: nil, max: nil, start: nil, format_options_use_int64_timestamp: true
           ensure_service!
           reload! unless resource_full?
-          data_json = service.list_tabledata dataset_id, table_id, token: token, max: max, start: start
-          Data.from_gapi_json data_json, gapi, nil, service
+          data_json = service.list_tabledata dataset_id, table_id, token: token, max: max, start: start,
+format_options_use_int64_timestamp: format_options_use_int64_timestamp
+          Data.from_gapi_json data_json, gapi, nil, service, format_options_use_int64_timestamp
         end
 
         ##

data/lib/google/cloud/bigquery/version.rb

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigquery
-      VERSION = "1.52.1".freeze
+      VERSION = "1.55.0".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery
 version: !ruby/object:Gem::Version
-  version: 1.52.1
+  version: 1.55.0
 platform: ruby
 authors:
 - Mike Moore
 - Chris Smith
 bindir: bin
 cert_chain: []
-date: 2025-04-25 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -56,16 +56,22 @@ dependencies:
   name: google-apis-core
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.18'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0.18'
+    - - "<"
       - !ruby/object:Gem::Version
-        version: '0.13'
+        version: '2'
 - !ruby/object:Gem::Dependency
   name: googleauth
   requirement: !ruby/object:Gem::Requirement
@@ -128,6 +134,7 @@ files:
 - lib/google-cloud-bigquery.rb
 - lib/google/cloud/bigquery.rb
 - lib/google/cloud/bigquery/argument.rb
+- lib/google/cloud/bigquery/condition.rb
 - lib/google/cloud/bigquery/convert.rb
 - lib/google/cloud/bigquery/copy_job.rb
 - lib/google/cloud/bigquery/credentials.rb
@@ -187,7 +194,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.6.5
+rubygems_version: 3.6.9
 specification_version: 4
 summary: API Client library for Google BigQuery
 test_files: []