google-cloud-bigquery 1.18.1 → 1.19.0

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

@@ -1217,8 +1217,7 @@ module Google
         def data token: nil, max: nil, start: nil
           ensure_service!
           reload! unless resource_full?
-          options = { token: token, max: max, start: start }
-          data_json = service.list_tabledata dataset_id, table_id, options
+          data_json = service.list_tabledata dataset_id, table_id, token: token, max: max, start: start
           Data.from_gapi_json data_json, gapi, nil, service
         end
 
@@ -1978,12 +1977,13 @@ module Google
         #
         # @param [Hash, Array<Hash>] rows A hash object or array of hash objects
         #   containing the data. Required.
-        # @param [Array<String>] insert_ids A unique ID for each row. BigQuery
-        #   uses this property to detect duplicate insertion requests on a
-        #   best-effort basis. For more information, see [data
-        #   consistency](https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataconsistency).
-        #   Optional. If not provided, the client library will assign a UUID to
-        #   each row before the request is sent.
+        # @param [Array<String|Symbol>, Symbol] insert_ids A unique ID for each row. BigQuery uses this property to
+        #   detect duplicate insertion requests on a best-effort basis. For more information, see [data
+        #   consistency](https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataconsistency). Optional. If
+        #   not provided, the client library will assign a UUID to each row before the request is sent.
+        #
+        #  The value `:skip` can be provided to skip the generation of IDs for all rows, or to skip the generation of an
+        #  ID for a specific row in the array.
         # @param [Boolean] skip_invalid Insert all valid rows of a request, even
         #   if invalid rows exist. The default value is `false`, which causes
         #   the entire request to fail if any invalid rows exist.
@@ -2023,12 +2023,14 @@ module Google
         #
         def insert rows, insert_ids: nil, skip_invalid: nil, ignore_unknown: nil
           rows = [rows] if rows.is_a? Hash
+          raise ArgumentError, "No rows provided" if rows.empty?
+
+          insert_ids = Array.new(rows.count) { :skip } if insert_ids == :skip
           insert_ids = Array insert_ids
           if insert_ids.count.positive? && insert_ids.count != rows.count
             raise ArgumentError, "insert_ids must be the same size as rows"
           end
-          rows = [rows] if rows.is_a? Hash
-          raise ArgumentError, "No rows provided" if rows.empty?
+
           ensure_service!
           options = { skip_invalid: skip_invalid, ignore_unknown: ignore_unknown, insert_ids: insert_ids }
           gapi = service.insert_tabledata dataset_id, table_id, rows, options
@@ -2162,7 +2164,7 @@ module Google
         #   table = dataset.table "my_table", skip_lookup: true
         #   table.exists? # true
         #
-        def exists? force: nil
+        def exists? force: false
           return gapi_exists? if force
           # If we have a value, return it
           return @exists unless @exists.nil?
@@ -2276,7 +2278,7 @@ module Google
         end
 
         ##
-        # @private New lazy Table object without making an HTTP request.
+        # @private New lazy Table object without making an HTTP request, for use with the skip_lookup option.
         def self.new_reference project_id, dataset_id, table_id, service
           raise ArgumentError, "dataset_id is required" unless dataset_id
           raise ArgumentError, "table_id is required" unless table_id
@@ -2505,14 +2507,14 @@ module Google
         end
 
         ##
-        # Yielded to a block to accumulate changes for a patch request.
+        # Yielded to a block to accumulate changes for a create request. See {Dataset#create_table}.
         class Updater < Table
           ##
-          # A list of attributes that were updated.
+          # @private A list of attributes that were updated.
           attr_reader :updates
 
           ##
-          # Create an Updater object.
+          # @private Create an Updater object.
           def initialize gapi
             @updates = []
             @gapi = gapi
@@ -2955,8 +2957,97 @@ module Google
             schema.record name, description: description, mode: mode, &block
           end
 
+          # rubocop:disable Style/MethodDefParentheses
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def data(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def copy_job(*)
+            raise "not implemented in #{self.class}"
+          end
+
           ##
-          # Make sure any access changes are saved
+          # @raise [RuntimeError] not implemented
+          def copy(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def extract_job(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def extract(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def load_job(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def load(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def insert(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def insert_async(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def delete
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def query_job(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def query(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def external(*)
+            raise "not implemented in #{self.class}"
+          end
+
+          ##
+          # @raise [RuntimeError] not implemented
+          def reload!
+            raise "not implemented in #{self.class}"
+          end
+          alias refresh! reload!
+
+          # rubocop:enable Style/MethodDefParentheses
+
+          ##
+          # @private Make sure any access changes are saved
           def check_for_mutated_schema!
             return if @schema.nil?
             return unless @schema.changed?
@@ -2964,6 +3055,8 @@ module Google
             patch_gapi! :schema
           end
 
+          ##
+          # @private
           def to_gapi
             check_for_mutated_schema!
             @gapi

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

@@ -113,12 +113,13 @@ module Google
           #
           # @param [Hash, Array<Hash>] rows A hash object or array of hash
           #   objects containing the data.
-          # @param [Array<String>] insert_ids A unique ID for each row. BigQuery
-          #   uses this property to detect duplicate insertion requests on a
-          #   best-effort basis. For more information, see [data
-          #   consistency](https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataconsistency).
-          #   Optional. If not provided, the client library will assign a UUID
-          #   to each row before the request is sent.
+          # @param [Array<String|Symbol>, Symbol] insert_ids A unique ID for each row. BigQuery uses this property to
+          #   detect duplicate insertion requests on a best-effort basis. For more information, see [data
+          #   consistency](https://cloud.google.com/bigquery/streaming-data-into-bigquery#dataconsistency). Optional. If
+          #   not provided, the client library will assign a UUID to each row before the request is sent.
+          #
+          #  The value `:skip` can be provided to skip the generation of IDs for all rows, or to skip the generation of
+          #  an ID for a specific row in the array.
           #
           def insert rows, insert_ids: nil
             return nil if rows.nil?
@@ -224,10 +225,14 @@ module Google
 
           def validate_insert_args rows, insert_ids
             rows = [rows] if rows.is_a? Hash
+            raise ArgumentError, "No rows provided" if rows.empty?
+
+            insert_ids = Array.new(rows.count) { :skip } if insert_ids == :skip
             insert_ids = Array insert_ids
             if insert_ids.count.positive? && insert_ids.count != rows.count
               raise ArgumentError, "insert_ids must be the same size as rows"
             end
+
             [rows, insert_ids]
           end
 
@@ -332,8 +337,13 @@ module Google
             end
 
             def addl_bytes_for json_row, insert_id
-              # "{\"insertId\":\"\",\"json\":},".bytesize #=> 24
-              24 + json_row.to_json.bytesize + insert_id.bytesize
+              if insert_id == :skip
+                # "{\"json\":},".bytesize #=> 10
+                10 + json_row.to_json.bytesize
+              else
+                # "{\"insertId\":\"\",\"json\":},".bytesize #=> 24
+                24 + json_row.to_json.bytesize + insert_id.bytesize
+              end
             end
           end
 

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

@@ -78,8 +78,7 @@ module Google
           def next
             return nil unless next?
             ensure_service!
-            options = { token: token, max: @max }
-            gapi = @service.list_tables @dataset_id, options
+            gapi = @service.list_tables @dataset_id, token: token, max: @max
             self.class.from_gapi gapi, @service, @dataset_id, @max
           end
 

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigquery
-      VERSION = "1.18.1".freeze
+      VERSION = "1.19.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.18.1
+  version: 1.19.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-12-20 00:00:00.000000000 Z
+date: 2020-02-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -240,6 +240,7 @@ files:
 - TROUBLESHOOTING.md
 - lib/google-cloud-bigquery.rb
 - lib/google/cloud/bigquery.rb
+- lib/google/cloud/bigquery/argument.rb
 - lib/google/cloud/bigquery/convert.rb
 - lib/google/cloud/bigquery/copy_job.rb
 - lib/google/cloud/bigquery/credentials.rb
@@ -259,6 +260,8 @@ files:
 - lib/google/cloud/bigquery/project.rb
 - lib/google/cloud/bigquery/project/list.rb
 - lib/google/cloud/bigquery/query_job.rb
+- lib/google/cloud/bigquery/routine.rb
+- lib/google/cloud/bigquery/routine/list.rb
 - lib/google/cloud/bigquery/schema.rb
 - lib/google/cloud/bigquery/schema/field.rb
 - lib/google/cloud/bigquery/service.rb