google-cloud-bigquery 1.26.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c2f8d8d7a564df2c916cced8adf4c0b621a1e11250a3a04decfce08995a4a24
-  data.tar.gz: 57bbda27d4c54e0522b564b8cdc62fb5e9dce8b26c91d3f0604c624ff113f057
+  metadata.gz: 334d37be375f513da083f7338e1324413409a6c30554456c08290ed1337c2701
+  data.tar.gz: f21c7793b5a9f82d0c3840aa5915fd10ef43644ccc1d9ea996a63860fa8b16ed
 SHA512:
-  metadata.gz: f445a86a5435cafc236d82faf91df46a06c6cee8612d8e6c4011450c93b73b61a883510909c6bb25e72516ae1a57c8a605736d82e0b63f0b10ad25cab90a1280
-  data.tar.gz: 43423f2bea5cea82c6c19bcf639bfb690f4718b0450140d299616ece59b147258ef877cafbc17b99c68274c310a0cd0123ae6b6db0b37bba2fb08be0395837f0
+  metadata.gz: 187d0549552613c40f85001fdf82197db01af5b5e285dfd6f7615a64c62ed74807c0ea31ac560d2a1516dae0c91f14fcc08b143882fcf8437b8d7c964f256348
+  data.tar.gz: e6b80ed9ccff8ffb2f8537a009a6d41a7930ee080f50800001b0afa9f7706a85af58180d091051f34a2499d66ca15f5c084a74cbbff244d8c22d266fc62713db

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Release History
 
+### 1.27.0 / 2021-02-10
+
+#### Features
+
+* Add Job#reservation_usage
+* Add Routine#determinism_level
+  * Add Routine#determinism_level
+  * Add Routine#determinism_level=
+  * Add Routine#determinism_level_deterministic?
+  * Add Routine#determinism_level_not_deterministic?
+  * Add Routine::Updater#determinism_level=
+
 ### 1.26.0 / 2021-01-13
 
 #### Features

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

@@ -215,6 +215,17 @@ module Google
           @gapi.statistics.parent_job_id
         end
 
+        ##
+        # An array containing the job resource usage breakdown by reservation, if present. Reservation usage statistics
+        # are only reported for jobs that are executed within reservations.  On-demand jobs do not report this data.
+        #
+        # @return [Array<Google::Cloud::Bigquery::Job::ReservationUsage>, nil] The reservation usage, if present.
+        #
+        def reservation_usage
+          return nil unless @gapi.statistics.reservation_usage
+          Array(@gapi.statistics.reservation_usage).map { |g| ReservationUsage.from_gapi g }
+        end
+
         ##
         # The statistics including stack frames for a child job of a script.
         #
@@ -489,6 +500,29 @@ module Google
           end
         end
 
+        ##
+        # Represents Job resource usage breakdown by reservation.
+        #
+        # @attr_reader [String] name The reservation name or "unreserved" for on-demand resources usage.
+        # @attr_reader [Fixnum] slot_ms The slot-milliseconds the job spent in the given reservation.
+        #
+        class ReservationUsage
+          attr_reader :name, :slot_ms
+
+          ##
+          # @private Creates a new ReservationUsage instance.
+          def initialize name, slot_ms
+            @name = name
+            @slot_ms = slot_ms
+          end
+
+          ##
+          # @private New ReservationUsage from a statistics.reservation_usage value.
+          def self.from_gapi gapi
+            new gapi.name, gapi.slot_ms
+          end
+        end
+
         ##
         # Represents statistics for a child job of a script.
         #
@@ -547,7 +581,7 @@ module Google
           end
 
           ##
-          # @private New ScriptStatistics from a statistics.script_statistics object.
+          # @private New ScriptStatistics from a statistics.script_statistics value.
           def self.from_gapi gapi
             frames = Array(gapi.stack_frames).map { |g| ScriptStackFrame.from_gapi g }
             new gapi.evaluation_kind, frames

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

@@ -603,6 +603,93 @@ module Google
           update_gapi!
         end
 
+        ###
+        # The JavaScript UDF determinism level. Optional.
+        #
+        # * `DETERMINISTIC` - Deterministic indicates that two calls with the same input to a UDF yield the same output.
+        #   If all JavaScript UDFs are `DETERMINISTIC`, the query result is potentially cachable.
+        # * `NOT_DETERMINISTIC` - Not deterministic indicates that the output of the UDF is not guaranteed to yield the
+        #   same output each time for a given set of inputs. If any JavaScript UDF is `NOT_DETERMINISTIC`, the query
+        #   result is not cacheable.
+        #
+        # Even if a JavaScript UDF is deterministic, many other factors can prevent usage of cached query results.
+        # Example factors include but not limited to: DDL/DML, non-deterministic SQL function calls, update of
+        # referenced tables/views/UDFs or imported JavaScript libraries. SQL UDFs cannot have determinism specified.
+        # Their determinism is automatically determined.
+        #
+        # @return [String, nil] The routine determinism level in upper case, 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.determinism_level #=> "NOT_DETERMINISTIC"
+        #
+        # @!group Attributes
+        #
+        def determinism_level
+          return nil if reference?
+          ensure_full_data!
+          @gapi.determinism_level
+        end
+
+        ##
+        # Updates the JavaScript UDF determinism level. Optional.
+        #
+        # * `DETERMINISTIC` - Deterministic indicates that two calls with the same input to a UDF yield the same output.
+        #   If all JavaScript UDFs are `DETERMINISTIC`, the query result is potentially cachable.
+        # * `NOT_DETERMINISTIC` - Not deterministic indicates that the output of the UDF is not guaranteed to yield the
+        #   same output each time for a given set of inputs. If any JavaScript UDF is `NOT_DETERMINISTIC`, the query
+        #   result is not cacheable.
+        #
+        # @param [String, nil] new_determinism_level The new routine determinism level in upper case.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   routine = dataset.routine "my_routine"
+        #
+        #   routine.determinism_level #=> "NOT_DETERMINISTIC"
+        #   routine.determinism_level = "DETERMINISTIC"
+        #
+        # @!group Attributes
+        #
+        def determinism_level= new_determinism_level
+          ensure_full_data!
+          @gapi.determinism_level = new_determinism_level
+          update_gapi!
+        end
+
+        ##
+        # Checks if the value of {#determinism_level} is `DETERMINISTIC`. The default is `false`.
+        #
+        # @return [Boolean] `true` when `DETERMINISTIC` and the object is not a reference (see {#reference?}), `false`
+        #   otherwise.
+        #
+        # @!group Attributes
+        #
+        def determinism_level_deterministic?
+          @gapi.determinism_level == "DETERMINISTIC"
+        end
+
+        ##
+        # Checks if the value of {#determinism_level} is `NOT_DETERMINISTIC`. The default is `false`.
+        #
+        # @return [Boolean] `true` when `NOT_DETERMINISTIC` and the object is not a reference (see {#reference?}),
+        #   `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def determinism_level_not_deterministic?
+          @gapi.determinism_level == "NOT_DETERMINISTIC"
+        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=},
@@ -999,7 +1086,9 @@ module Google
           #   routine = dataset.routine "my_routine"
           #
           #   routine.return_type.type_kind #=> "INT64"
-          #   routine.return_type = "STRING"
+          #   routine.update do |r|
+          #     r.return_type = "STRING"
+          #   end
           #
           def return_type= new_return_type
             @gapi.return_type = StandardSql::DataType.gapi_from_string_or_data_type new_return_type
@@ -1019,9 +1108,11 @@ module Google
           #   dataset = bigquery.dataset "my_dataset"
           #   routine = dataset.routine "my_routine"
           #
-          #   routine.imported_libraries = [
-          #     "gs://cloud-samples-data/bigquery/udfs/max-value.js"
-          #   ]
+          #   routine.update do |r|
+          #     r.imported_libraries = [
+          #       "gs://cloud-samples-data/bigquery/udfs/max-value.js"
+          #     ]
+          #   end
           #
           def imported_libraries= new_imported_libraries
             @gapi.imported_libraries = new_imported_libraries
@@ -1069,12 +1160,43 @@ module Google
           #   routine = dataset.routine "my_routine"
           #
           #   routine.description #=> "My routine description"
-          #   routine.description = "My updated routine description"
+          #   routine.update do |r|
+          #     r.description = "My updated routine description"
+          #   end
           #
           def description= new_description
             @gapi.description = new_description
           end
 
+          ##
+          # Updates the JavaScript UDF determinism level. Optional.
+          #
+          # * `DETERMINISTIC` - Deterministic indicates that two calls with the same input to a UDF yield the same
+          #   output. If all JavaScript UDFs are `DETERMINISTIC`, the query result is potentially cachable.
+          # * `NOT_DETERMINISTIC` - Not deterministic indicates that the output of the UDF is not guaranteed to yield
+          #   the same output each time for a given set of inputs. If any JavaScript UDF is `NOT_DETERMINISTIC`, the
+          #   query result is not cacheable.
+          #
+          # @param [String, nil] new_determinism_level The new routine determinism level in upper case.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   routine = dataset.routine "my_routine"
+          #
+          #   routine.determinism_level #=> "NOT_DETERMINISTIC"
+          #   routine.update do |r|
+          #     r.determinism_level = "DETERMINISTIC"
+          #   end
+          #
+          # @!group Attributes
+          #
+          def determinism_level= new_determinism_level
+            @gapi.determinism_level = new_determinism_level
+          end
+
           def update
             raise "not implemented in #{self.class}"
           end

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

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-bigquery
 version: !ruby/object:Gem::Version
-  version: 1.26.0
+  version: 1.27.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-01-13 00:00:00.000000000 Z
+date: 2021-02-10 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -291,7 +291,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.4
+rubygems_version: 3.2.6
 signing_key: 
 specification_version: 4
 summary: API Client library for Google BigQuery