google-cloud-bigquery 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 65c8bae8c365c4fde7d54e75abe9c15aa4eba702b2e6300371843bc97bbc27f7
-  data.tar.gz: 5457cacd3331a717f63b0d71b907aa5e68702256118cd41d16f90be672f187e4
+  metadata.gz: 3d887921d9819a9fae907aa50bb5f7ca805514b7911edeee335d7caa82bcca8a
+  data.tar.gz: 45abf44f843328b5e9d0f7dad0780735dfb12b5766ded4b12dc35c0a5f949555
 SHA512:
-  metadata.gz: b7f0438c001bccc0854ecf13b81909c056635a50489d074c8d91beb13ba3f5e00826663b20371ef7b0669a6cfcb3ee058da8eefc6ffcfd410e9da18d1dd82167
-  data.tar.gz: 05f8d06e52e06625655730e0c31ae57a8b6bec5c771809d73814413db90122477b143d494d0e8236f43782766673a0f0230b48480f9ce0cddb125b55065cc68a
+  metadata.gz: 754714cfca94ca584b8900bf5dbe483693594d873f0344051fa71b41dfcacec8a642720d34939db881ba9e9f2cf7ca6baeb4a3a98c67430e046062bcc91d5b06
+  data.tar.gz: 24b37f4222cd43dee18edef1150db12cdc0d25e686b70ee1429f474b6670a30e5cacb26b809fc484be6cb55e9f9a63ef693d1acb0c44902a20e1cb633b1f2274

data/CHANGELOG.md

@@ -1,5 +1,14 @@
 # Release History
 
+### 1.20.0 / 2020-03-11
+
+#### Features
+
+* Add Range Partitioning
+  * Add range partitioning methods to Table and Table::Updater
+  * Add range partitioning methods to LoadJob
+  * Add range partitioning methods to QueryJob
+
 ### 1.19.0 / 2020-02-11
 
 #### Features

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

@@ -555,6 +555,40 @@ module Google
         #     end
         #   end
         #
+        # @example With time partitioning and clustering.
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #
+        #   table = dataset.create_table "my_table" do |t|
+        #     t.schema do |schema|
+        #       schema.timestamp "dob", mode: :required
+        #       schema.string "first_name", mode: :required
+        #       schema.string "last_name", mode: :required
+        #     end
+        #     t.time_partitioning_type  = "DAY"
+        #     t.time_partitioning_field = "dob"
+        #     t.clustering_fields = ["last_name", "first_name"]
+        #   end
+        #
+        # @example With range partitioning.
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #
+        #   table = dataset.create_table "my_table" do |t|
+        #     t.schema do |schema|
+        #       schema.integer "my_table_id", mode: :required
+        #       schema.string "my_table_data", mode: :required
+        #     end
+        #     t.range_partitioning_field = "my_table_id"
+        #     t.range_partitioning_start = 0
+        #     t.range_partitioning_interval = 10
+        #     t.range_partitioning_end = 100
+        #   end
+        #
         # @!group Table
         #
         def create_table table_id, name: nil, description: nil

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

@@ -348,7 +348,71 @@ module Google
         end
 
         ###
-        # Checks if the destination table will be time-partitioned. See
+        # Checks if the destination table will be range partitioned. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Boolean] `true` when the table is range partitioned, or `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning?
+          !@gapi.configuration.load.range_partitioning.nil?
+        end
+
+        ###
+        # The field on which the destination table will be range partitioned, if any. The field must be a
+        # top-level `NULLABLE/REQUIRED` field. The only supported type is `INTEGER/INT64`. See
+        # [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [String, nil] The partition field, if a field was configured, or `nil` if not range partitioned.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_field
+          @gapi.configuration.load.range_partitioning.field if range_partitioning?
+        end
+
+        ###
+        # The start of range partitioning, inclusive. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The start of range partitioning, inclusive, or `nil` if not range partitioned.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_start
+          @gapi.configuration.load.range_partitioning.range.start if range_partitioning?
+        end
+
+        ###
+        # The width of each interval. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The width of each interval, for data in range partitions, or `nil` if not range
+        #   partitioned.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_interval
+          return nil unless range_partitioning?
+          @gapi.configuration.load.range_partitioning.range.interval
+        end
+
+        ###
+        # The end of range partitioning, exclusive. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The end of range partitioning, exclusive, or `nil` if not range partitioned.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_end
+          @gapi.configuration.load.range_partitioning.range.end if range_partitioning?
+        end
+
+        ###
+        # Checks if the destination table will be time partitioned. See
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
         # @return [Boolean, nil] `true` when the table will be time-partitioned,
@@ -361,10 +425,10 @@ module Google
         end
 
         ###
-        # The period for which the destination table will be partitioned, if
+        # The period for which the destination table will be time partitioned, if
         # any. See [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
-        # @return [String, nil] The partition type. Currently the only supported
+        # @return [String, nil] The time partition type. Currently the only supported
         #   value is "DAY", or `nil` if not present.
         #
         # @!group Attributes
@@ -374,13 +438,13 @@ module Google
         end
 
         ###
-        # The field on which the destination table will be partitioned, if any.
-        # If not set, the destination table will be partitioned by pseudo column
-        # `_PARTITIONTIME`; if set, the table will be partitioned by this field.
+        # The field on which the destination table will be time partitioned, if any.
+        # If not set, the destination table will be time partitioned by pseudo column
+        # `_PARTITIONTIME`; if set, the table will be time partitioned by this field.
         # See [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
-        # @return [String, nil] The partition field, if a field was configured.
-        #   `nil` if not partitioned or not set (partitioned by pseudo column
+        # @return [String, nil] The time partition field, if a field was configured.
+        #   `nil` if not time partitioned or not set (partitioned by pseudo column
         #   '_PARTITIONTIME').
         #
         # @!group Attributes
@@ -390,12 +454,12 @@ module Google
         end
 
         ###
-        # The expiration for the destination table partitions, if any, in
+        # The expiration for the destination table time partitions, if any, in
         # seconds. See [Partitioned
         # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
         # @return [Integer, nil] The expiration time, in seconds, for data in
-        #   partitions, or `nil` if not present.
+        #   time partitions, or `nil` if not present.
         #
         # @!group Attributes
         #
@@ -408,11 +472,11 @@ module Google
 
         ###
         # If set to true, queries over the destination table will require a
-        # partition filter that can be used for partition elimination to be
+        # time partition filter that can be used for partition elimination to be
         # specified. See [Partitioned
         # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
-        # @return [Boolean] `true` when a partition filter will be required,
+        # @return [Boolean] `true` when a time partition filter will be required,
         #   or `false` otherwise.
         #
         # @!group Attributes
@@ -1253,14 +1317,180 @@ module Google
           end
 
           ##
-          # Sets the partitioning for the destination table. See [Partitioned
+          # Sets the field on which to range partition the table. See [Creating and using integer range partitioned
+          # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # See {#range_partitioning_start=}, {#range_partitioning_interval=} and {#range_partitioning_end=}.
+          #
+          # You can only set range partitioning when creating a table. BigQuery does not allow you to change
+          # partitioning on an existing table.
+          #
+          # @param [String] field The range partition field. the destination table is partitioned by this
+          #   field. The field must be a top-level `NULLABLE/REQUIRED` field. The only supported
+          #   type is `INTEGER/INT64`.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   gs_url = "gs://my-bucket/file-name.csv"
+          #   load_job = dataset.load_job "my_new_table", gs_url do |job|
+          #     job.schema do |schema|
+          #       schema.integer "my_table_id", mode: :required
+          #       schema.string "my_table_data", mode: :required
+          #     end
+          #     job.range_partitioning_field = "my_table_id"
+          #     job.range_partitioning_start = 0
+          #     job.range_partitioning_interval = 10
+          #     job.range_partitioning_end = 100
+          #   end
+          #
+          #   load_job.wait_until_done!
+          #   load_job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_field= field
+            @gapi.configuration.load.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.configuration.load.range_partitioning.field = field
+          end
+
+          ##
+          # Sets the start of range partitioning, inclusive, for the destination table. See [Creating and using integer
+          # range partitioned tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table. BigQuery does not allow you to change
+          # partitioning on an existing table.
+          #
+          # See {#range_partitioning_field=}, {#range_partitioning_interval=} and {#range_partitioning_end=}.
+          #
+          # @param [Integer] range_start The start of range partitioning, inclusive.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   gs_url = "gs://my-bucket/file-name.csv"
+          #   load_job = dataset.load_job "my_new_table", gs_url do |job|
+          #     job.schema do |schema|
+          #       schema.integer "my_table_id", mode: :required
+          #       schema.string "my_table_data", mode: :required
+          #     end
+          #     job.range_partitioning_field = "my_table_id"
+          #     job.range_partitioning_start = 0
+          #     job.range_partitioning_interval = 10
+          #     job.range_partitioning_end = 100
+          #   end
+          #
+          #   load_job.wait_until_done!
+          #   load_job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_start= range_start
+            @gapi.configuration.load.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.configuration.load.range_partitioning.range.start = range_start
+          end
+
+          ##
+          # Sets width of each interval for data in range partitions. See [Creating and using integer range partitioned
+          # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table. BigQuery does not allow you to change
+          # partitioning on an existing table.
+          #
+          # See {#range_partitioning_field=}, {#range_partitioning_start=} and {#range_partitioning_end=}.
+          #
+          # @param [Integer] range_interval The width of each interval, for data in partitions.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   gs_url = "gs://my-bucket/file-name.csv"
+          #   load_job = dataset.load_job "my_new_table", gs_url do |job|
+          #     job.schema do |schema|
+          #       schema.integer "my_table_id", mode: :required
+          #       schema.string "my_table_data", mode: :required
+          #     end
+          #     job.range_partitioning_field = "my_table_id"
+          #     job.range_partitioning_start = 0
+          #     job.range_partitioning_interval = 10
+          #     job.range_partitioning_end = 100
+          #   end
+          #
+          #   load_job.wait_until_done!
+          #   load_job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_interval= range_interval
+            @gapi.configuration.load.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.configuration.load.range_partitioning.range.interval = range_interval
+          end
+
+          ##
+          # Sets the end of range partitioning, exclusive, for the destination table. See [Creating and using integer
+          # range partitioned tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table. BigQuery does not allow you to change
+          # partitioning on an existing table.
+          #
+          # See {#range_partitioning_start=}, {#range_partitioning_interval=} and {#range_partitioning_field=}.
+          #
+          # @param [Integer] range_end The end of range partitioning, exclusive.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   gs_url = "gs://my-bucket/file-name.csv"
+          #   load_job = dataset.load_job "my_new_table", gs_url do |job|
+          #     job.schema do |schema|
+          #       schema.integer "my_table_id", mode: :required
+          #       schema.string "my_table_data", mode: :required
+          #     end
+          #     job.range_partitioning_field = "my_table_id"
+          #     job.range_partitioning_start = 0
+          #     job.range_partitioning_interval = 10
+          #     job.range_partitioning_end = 100
+          #   end
+          #
+          #   load_job.wait_until_done!
+          #   load_job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_end= range_end
+            @gapi.configuration.load.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.configuration.load.range_partitioning.range.end = range_end
+          end
+
+          ##
+          # Sets the time partitioning for the destination table. See [Partitioned
           # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
           #
-          # You can only set the partitioning field while creating a table.
+          # You can only set the time partitioning field while creating a table.
           # BigQuery does not allow you to change partitioning on an existing
           # table.
           #
-          # @param [String] type The partition type. Currently the only
+          # @param [String] type The time partition type. Currently the only
           #   supported value is "DAY".
           #
           # @example
@@ -1285,20 +1515,20 @@ module Google
           end
 
           ##
-          # Sets the field on which to partition the destination table. If not
-          # set, the destination table is partitioned by pseudo column
-          # `_PARTITIONTIME`; if set, the table is partitioned by this field.
+          # Sets the field on which to time partition the destination table. If not
+          # set, the destination table is time partitioned by pseudo column
+          # `_PARTITIONTIME`; if set, the table is time partitioned by this field.
           # See [Partitioned
           # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
           #
-          # The destination table must also be partitioned. See
+          # The destination table must also be time partitioned. See
           # {#time_partitioning_type=}.
           #
-          # You can only set the partitioning field while creating a table.
+          # You can only set the time partitioning field while creating a table.
           # BigQuery does not allow you to change partitioning on an existing
           # table.
           #
-          # @param [String] field The partition field. The field must be a
+          # @param [String] field The time partition field. The field must be a
           #   top-level TIMESTAMP or DATE field. Its mode must be NULLABLE or
           #   REQUIRED.
           #
@@ -1328,15 +1558,15 @@ module Google
           end
 
           ##
-          # Sets the partition expiration for the destination table. See
+          # Sets the time partition expiration for the destination table. See
           # [Partitioned
           # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
           #
-          # The destination table must also be partitioned. See
+          # The destination table must also be time partitioned. See
           # {#time_partitioning_type=}.
           #
           # @param [Integer] expiration An expiration time, in seconds,
-          #   for data in partitions.
+          #   for data in time partitions.
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -1362,12 +1592,12 @@ module Google
 
           ##
           # If set to true, queries over the destination table will require a
-          # partition filter that can be used for partition elimination to be
+          # time partition filter that can be used for time partition elimination to be
           # specified. See [Partitioned
           # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
           #
           # @param [Boolean] val Indicates if queries over the destination table
-          #   will require a partition filter. The default value is `false`.
+          #   will require a time partition filter. The default value is `false`.
           #
           # @!group Attributes
           #

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

@@ -410,6 +410,69 @@ module Google
           EncryptionConfiguration.from_gapi @gapi.configuration.query.destination_encryption_configuration
         end
 
+        ###
+        # Checks if the destination table will be range partitioned. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Boolean] `true` when the table is range partitioned, or `false` otherwise.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning?
+          !@gapi.configuration.query.range_partitioning.nil?
+        end
+
+        ###
+        # The field on which the destination table will be range partitioned, if any. The field must be a
+        # top-level `NULLABLE/REQUIRED` field. The only supported type is `INTEGER/INT64`. See
+        # [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [String, nil] The partition field, if a field was configured, or `nil` if not range partitioned.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_field
+          @gapi.configuration.query.range_partitioning.field if range_partitioning?
+        end
+
+        ###
+        # The start of range partitioning, inclusive. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The start of range partitioning, inclusive, or `nil` if not range partitioned.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_start
+          @gapi.configuration.query.range_partitioning.range.start if range_partitioning?
+        end
+
+        ###
+        # The width of each interval. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The width of each interval, for data in range partitions, or `nil` if not range
+        #   partitioned.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_interval
+          @gapi.configuration.query.range_partitioning.range.interval if range_partitioning?
+        end
+
+        ###
+        # The end of range partitioning, exclusive. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The end of range partitioning, exclusive, or `nil` if not range partitioned.
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_end
+          @gapi.configuration.query.range_partitioning.range.end if range_partitioning?
+        end
+
         ###
         # Checks if the destination table will be time-partitioned. See
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
@@ -1028,6 +1091,164 @@ module Google
             @gapi.configuration.query.update! destination_encryption_configuration: val.to_gapi
           end
 
+          ##
+          # Sets the field on which to range partition the table. See [Creating and using integer range partitioned
+          # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # See {#range_partitioning_start=}, {#range_partitioning_interval=} and {#range_partitioning_end=}.
+          #
+          # You can only set range partitioning when creating a table. BigQuery does not allow you to change
+          # partitioning on an existing table.
+          #
+          # @param [String] field The range partition field. the destination table is partitioned by this
+          #   field. The field must be a top-level `NULLABLE/REQUIRED` field. The only supported
+          #   type is `INTEGER/INT64`.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   destination_table = dataset.table "my_destination_table",
+          #                                     skip_lookup: true
+          #
+          #   job = bigquery.query_job "SELECT num FROM UNNEST(GENERATE_ARRAY(0, 99)) AS num" do |job|
+          #     job.table = destination_table
+          #     job.range_partitioning_field = "num"
+          #     job.range_partitioning_start = 0
+          #     job.range_partitioning_interval = 10
+          #     job.range_partitioning_end = 100
+          #   end
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_field= field
+            @gapi.configuration.query.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.configuration.query.range_partitioning.field = field
+          end
+
+          ##
+          # Sets the start of range partitioning, inclusive, for the destination table. See [Creating and using integer
+          # range partitioned tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table. BigQuery does not allow you to change
+          # partitioning on an existing table.
+          #
+          # See {#range_partitioning_field=}, {#range_partitioning_interval=} and {#range_partitioning_end=}.
+          #
+          # @param [Integer] range_start The start of range partitioning, inclusive.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   destination_table = dataset.table "my_destination_table",
+          #                                     skip_lookup: true
+          #
+          #   job = bigquery.query_job "SELECT num FROM UNNEST(GENERATE_ARRAY(0, 99)) AS num" do |job|
+          #     job.table = destination_table
+          #     job.range_partitioning_field = "num"
+          #     job.range_partitioning_start = 0
+          #     job.range_partitioning_interval = 10
+          #     job.range_partitioning_end = 100
+          #   end
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_start= range_start
+            @gapi.configuration.query.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.configuration.query.range_partitioning.range.start = range_start
+          end
+
+          ##
+          # Sets width of each interval for data in range partitions. See [Creating and using integer range partitioned
+          # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table. BigQuery does not allow you to change
+          # partitioning on an existing table.
+          #
+          # See {#range_partitioning_field=}, {#range_partitioning_start=} and {#range_partitioning_end=}.
+          #
+          # @param [Integer] range_interval The width of each interval, for data in partitions.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   destination_table = dataset.table "my_destination_table",
+          #                                     skip_lookup: true
+          #
+          #   job = bigquery.query_job "SELECT num FROM UNNEST(GENERATE_ARRAY(0, 99)) AS num" do |job|
+          #     job.table = destination_table
+          #     job.range_partitioning_field = "num"
+          #     job.range_partitioning_start = 0
+          #     job.range_partitioning_interval = 10
+          #     job.range_partitioning_end = 100
+          #   end
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_interval= range_interval
+            @gapi.configuration.query.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.configuration.query.range_partitioning.range.interval = range_interval
+          end
+
+          ##
+          # Sets the end of range partitioning, exclusive, for the destination table. See [Creating and using integer
+          # range partitioned tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table. BigQuery does not allow you to change
+          # partitioning on an existing table.
+          #
+          # See {#range_partitioning_start=}, {#range_partitioning_interval=} and {#range_partitioning_field=}.
+          #
+          # @param [Integer] range_end The end of range partitioning, exclusive.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   destination_table = dataset.table "my_destination_table",
+          #                                     skip_lookup: true
+          #
+          #   job = bigquery.query_job "SELECT num FROM UNNEST(GENERATE_ARRAY(0, 99)) AS num" do |job|
+          #     job.table = destination_table
+          #     job.range_partitioning_field = "num"
+          #     job.range_partitioning_start = 0
+          #     job.range_partitioning_interval = 10
+          #     job.range_partitioning_end = 100
+          #   end
+          #
+          #   job.wait_until_done!
+          #   job.done? #=> true
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_end= range_end
+            @gapi.configuration.query.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.configuration.query.range_partitioning.range.end = range_end
+          end
+
           ##
           # Sets the partitioning for the destination table. See [Partitioned
           # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).

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

@@ -232,8 +232,8 @@ module Google
         #
         #   bigquery = Google::Cloud::Bigquery.new
         #   dataset = bigquery.dataset "my_dataset"
-        #   table = dataset.table "my_table" do |table|
-        #     table.schema.load File.read("path/to/schema.json")
+        #   table = dataset.table "my_table" do |t|
+        #     t.schema.load File.read("path/to/schema.json")
         #   end
         #
         def load source

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

@@ -155,10 +155,87 @@ module Google
         end
 
         ###
-        # Checks if the table is time-partitioned. See [Partitioned
+        # Checks if the table is range partitioned. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Boolean, nil] `true` when the table is range partitioned, or
+        #   `false` otherwise, if the object is a resource (see {#resource?});
+        #   `nil` if the object is a reference (see {#reference?}).
+        #
+        # @!group Attributes
+        #
+        def range_partitioning?
+          return nil if reference?
+          !@gapi.range_partitioning.nil?
+        end
+
+        ###
+        # The field on which the table is range partitioned, if any. The field must be a top-level `NULLABLE/REQUIRED`
+        # field. The only supported type is `INTEGER/INT64`. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The range partition field, or `nil` if not range partitioned or the object is a
+        #   reference (see {#reference?}).
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_field
+          return nil if reference?
+          ensure_full_data!
+          @gapi.range_partitioning.field if range_partitioning?
+        end
+
+        ###
+        # The start of range partitioning, inclusive. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The start of range partitioning, inclusive, or `nil` if not range partitioned or the
+        #   object is a reference (see {#reference?}).
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_start
+          return nil if reference?
+          ensure_full_data!
+          @gapi.range_partitioning.range.start if range_partitioning?
+        end
+
+        ###
+        # The width of each interval. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The width of each interval, for data in range partitions, or `nil` if not range
+        #   partitioned or the object is a reference (see {#reference?}).
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_interval
+          return nil if reference?
+          ensure_full_data!
+          return nil unless range_partitioning?
+          @gapi.range_partitioning.range.interval
+        end
+
+        ###
+        # The end of range partitioning, exclusive. See [Creating and using integer range partitioned
+        # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+        #
+        # @return [Integer, nil] The end of range partitioning, exclusive, or `nil` if not range partitioned or the
+        #   object is a reference (see {#reference?}).
+        #
+        # @!group Attributes
+        #
+        def range_partitioning_end
+          return nil if reference?
+          ensure_full_data!
+          @gapi.range_partitioning.range.end if range_partitioning?
+        end
+
+        ###
+        # Checks if the table is time partitioned. See [Partitioned
         # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
-        # @return [Boolean, nil] `true` when the table is time-partitioned, or
+        # @return [Boolean, nil] `true` when the table is time partitioned, or
         #   `false` otherwise, if the object is a resource (see {#resource?});
         #   `nil` if the object is a reference (see {#reference?}).
         #
@@ -170,10 +247,10 @@ module Google
         end
 
         ###
-        # The period for which the table is partitioned, if any. See
+        # The period for which the table is time partitioned, if any. See
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
-        # @return [String, nil] The partition type. Currently the only supported
+        # @return [String, nil] The time partition type. Currently the only supported
         #   value is "DAY", or `nil` if the object is a reference (see
         #   {#reference?}).
         #
@@ -186,14 +263,14 @@ module Google
         end
 
         ##
-        # Sets the partitioning for the table. See [Partitioned
+        # Sets the time partitioning type for the table. See [Partitioned
         # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
-        # You can only set partitioning when creating a table as in
-        # the example below. BigQuery does not allow you to change partitioning
+        # You can only set time partitioning when creating a table as in
+        # the example below. BigQuery does not allow you to change time partitioning
         # on an existing table.
         #
-        # @param [String] type The partition type. Currently the only
+        # @param [String] type The time partition type. Currently the only
         #   supported value is "DAY".
         #
         # @example
@@ -201,8 +278,12 @@ module Google
         #
         #   bigquery = Google::Cloud::Bigquery.new
         #   dataset = bigquery.dataset "my_dataset"
-        #   table = dataset.create_table "my_table" do |table|
-        #     table.time_partitioning_type = "DAY"
+        #   table = dataset.create_table "my_table" do |t|
+        #     t.schema do |schema|
+        #       schema.timestamp "dob", mode: :required
+        #     end
+        #     t.time_partitioning_type  = "DAY"
+        #     t.time_partitioning_field = "dob"
         #   end
         #
         # @!group Attributes
@@ -215,13 +296,13 @@ module Google
         end
 
         ###
-        # The field on which the table is partitioned, if any. If not
-        # set, the destination table is partitioned by pseudo column
-        # `_PARTITIONTIME`; if set, the table is partitioned by this field. See
+        # The field on which the table is time partitioned, if any. If not
+        # set, the destination table is time partitioned by pseudo column
+        # `_PARTITIONTIME`; if set, the table is time partitioned by this field. See
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
-        # @return [String, nil] The partition field, if a field was configured.
-        #   `nil` if not partitioned, not set (partitioned by pseudo column
+        # @return [String, nil] The time partition field, if a field was configured.
+        #   `nil` if not time partitioned, not set (time partitioned by pseudo column
         #   '_PARTITIONTIME') or the object is a reference (see {#reference?}).
         #
         # @!group Attributes
@@ -233,19 +314,19 @@ module Google
         end
 
         ##
-        # Sets the field on which to partition the table. If not
-        # set, the destination table is partitioned by pseudo column
-        # `_PARTITIONTIME`; if set, the table is partitioned by this field. See
+        # Sets the field on which to time partition the table. If not
+        # set, the destination table is time partitioned by pseudo column
+        # `_PARTITIONTIME`; if set, the table is time partitioned by this field. See
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
-        # The table must also be partitioned.
+        # The table must also be time partitioned.
         #
         # See {Table#time_partitioning_type=}.
         #
-        # You can only set the partitioning field while creating a table as in
-        # the example below. BigQuery does not allow you to change partitioning
+        # You can only set the time partitioning field while creating a table as in
+        # the example below. BigQuery does not allow you to change time partitioning
         # on an existing table.
         #
-        # @param [String] field The partition field. The field must be a
+        # @param [String] field The time partition field. The field must be a
         #   top-level TIMESTAMP or DATE field. Its mode must be NULLABLE or
         #   REQUIRED.
         #
@@ -254,12 +335,12 @@ module Google
         #
         #   bigquery = Google::Cloud::Bigquery.new
         #   dataset = bigquery.dataset "my_dataset"
-        #   table = dataset.create_table "my_table" do |table|
-        #     table.time_partitioning_type  = "DAY"
-        #     table.time_partitioning_field = "dob"
-        #     table.schema do |schema|
+        #   table = dataset.create_table "my_table" do |t|
+        #     t.schema do |schema|
         #       schema.timestamp "dob", mode: :required
         #     end
+        #     t.time_partitioning_type  = "DAY"
+        #     t.time_partitioning_field = "dob"
         #   end
         #
         # @!group Attributes
@@ -272,11 +353,11 @@ module Google
         end
 
         ###
-        # The expiration for the table partitions, if any, in seconds. See
+        # The expiration for the time  partitions, if any, in seconds. See
         # [Partitioned Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
         #
         # @return [Integer, nil] The expiration time, in seconds, for data in
-        #   partitions, or `nil` if not present or the object is a reference
+        #   time partitions, or `nil` if not present or the object is a reference
         #   (see {#reference?}).
         #
         # @!group Attributes
@@ -290,9 +371,9 @@ module Google
         end
 
         ##
-        # Sets the partition expiration for the table. See [Partitioned
+        # Sets the time partition expiration for the table. See [Partitioned
         # Tables](https://cloud.google.com/bigquery/docs/partitioned-tables).
-        # The table must also be partitioned.
+        # The table must also be time partitioned.
         #
         # See {Table#time_partitioning_type=}.
         #
@@ -301,16 +382,20 @@ module Google
         # the update to comply with ETag-based optimistic concurrency control.
         #
         # @param [Integer] expiration An expiration time, in seconds,
-        #   for data in partitions.
+        #   for data in time partitions.
         #
         # @example
         #   require "google/cloud/bigquery"
         #
         #   bigquery = Google::Cloud::Bigquery.new
         #   dataset = bigquery.dataset "my_dataset"
-        #   table = dataset.create_table "my_table" do |table|
-        #     table.time_partitioning_type = "DAY"
-        #     table.time_partitioning_expiration = 86_400
+        #   table = dataset.create_table "my_table" do |t|
+        #     t.schema do |schema|
+        #       schema.timestamp "dob", mode: :required
+        #     end
+        #     t.time_partitioning_type = "DAY"
+        #     t.time_partitioning_field = "dob"
+        #     t.time_partitioning_expiration = 86_400
         #   end
         #
         # @!group Attributes
@@ -356,8 +441,8 @@ module Google
         #
         #   bigquery = Google::Cloud::Bigquery.new
         #   dataset = bigquery.dataset "my_dataset"
-        #   table = dataset.create_table "my_table" do |table|
-        #     table.require_partition_filter = true
+        #   table = dataset.create_table "my_table" do |t|
+        #     t.require_partition_filter = true
         #   end
         #
         # @!group Attributes
@@ -387,7 +472,7 @@ module Google
 
         ###
         # One or more fields on which data should be clustered. Must be
-        # specified with time-based partitioning, data in the table will be
+        # specified with time partitioning, data in the table will be
         # first partitioned and subsequently clustered. The order of the
         # returned fields determines the sort order of the data.
         #
@@ -2521,6 +2606,168 @@ module Google
             @schema = nil
           end
 
+          ##
+          # Sets the field on which to range partition the table. See [Creating and using integer range partitioned
+          # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # See {Table::Updater#range_partitioning_start=}, {Table::Updater#range_partitioning_interval=} and
+          # {Table::Updater#range_partitioning_end=}.
+          #
+          # You can only set range partitioning when creating a table as in the example below. BigQuery does not allow
+          # you to change partitioning on an existing table.
+          #
+          # @param [String] field The range partition field. The table is partitioned by this
+          #   field. The field must be a top-level `NULLABLE/REQUIRED` field. The only supported
+          #   type is `INTEGER/INT64`.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   table = dataset.create_table "my_table" do |t|
+          #     t.schema do |schema|
+          #       schema.integer "my_table_id", mode: :required
+          #       schema.string "my_table_data", mode: :required
+          #     end
+          #     t.range_partitioning_field = "my_table_id"
+          #     t.range_partitioning_start = 0
+          #     t.range_partitioning_interval = 10
+          #     t.range_partitioning_end = 100
+          #   end
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_field= field
+            reload! unless resource_full?
+            @gapi.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.range_partitioning.field = field
+            patch_gapi! :range_partitioning
+          end
+
+          ##
+          # Sets the start of range partitioning, inclusive, for the table. See [Creating and using integer range
+          # partitioned tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table as in the example below. BigQuery does not allow
+          # you to change partitioning on an existing table.
+          #
+          # See {Table::Updater#range_partitioning_field=}, {Table::Updater#range_partitioning_interval=} and
+          # {Table::Updater#range_partitioning_end=}.
+          #
+          # @param [Integer] range_start The start of range partitioning, inclusive.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   table = dataset.create_table "my_table" do |t|
+          #     t.schema do |schema|
+          #       schema.integer "my_table_id", mode: :required
+          #       schema.string "my_table_data", mode: :required
+          #     end
+          #     t.range_partitioning_field = "my_table_id"
+          #     t.range_partitioning_start = 0
+          #     t.range_partitioning_interval = 10
+          #     t.range_partitioning_end = 100
+          #   end
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_start= range_start
+            reload! unless resource_full?
+            @gapi.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.range_partitioning.range.start = range_start
+            patch_gapi! :range_partitioning
+          end
+
+          ##
+          # Sets width of each interval for data in range partitions. See [Creating and using integer range partitioned
+          # tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table as in the example below. BigQuery does not allow
+          # you to change partitioning on an existing table.
+          #
+          # See {Table::Updater#range_partitioning_field=}, {Table::Updater#range_partitioning_start=} and
+          # {Table::Updater#range_partitioning_end=}.
+          #
+          # @param [Integer] range_interval The width of each interval, for data in partitions.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   table = dataset.create_table "my_table" do |t|
+          #     t.schema do |schema|
+          #       schema.integer "my_table_id", mode: :required
+          #       schema.string "my_table_data", mode: :required
+          #     end
+          #     t.range_partitioning_field = "my_table_id"
+          #     t.range_partitioning_start = 0
+          #     t.range_partitioning_interval = 10
+          #     t.range_partitioning_end = 100
+          #   end
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_interval= range_interval
+            reload! unless resource_full?
+            @gapi.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.range_partitioning.range.interval = range_interval
+            patch_gapi! :range_partitioning
+          end
+
+          ##
+          # Sets the end of range partitioning, exclusive, for the table. See [Creating and using integer range
+          # partitioned tables](https://cloud.google.com/bigquery/docs/creating-integer-range-partitions).
+          #
+          # You can only set range partitioning when creating a table as in the example below. BigQuery does not allow
+          # you to change partitioning on an existing table.
+          #
+          # See {Table::Updater#range_partitioning_start=}, {Table::Updater#range_partitioning_interval=} and
+          # {Table::Updater#range_partitioning_field=}.
+          #
+          # @param [Integer] range_end The end of range partitioning, exclusive.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #
+          #   table = dataset.create_table "my_table" do |t|
+          #     t.schema do |schema|
+          #       schema.integer "my_table_id", mode: :required
+          #       schema.string "my_table_data", mode: :required
+          #     end
+          #     t.range_partitioning_field = "my_table_id"
+          #     t.range_partitioning_start = 0
+          #     t.range_partitioning_interval = 10
+          #     t.range_partitioning_end = 100
+          #   end
+          #
+          # @!group Attributes
+          #
+          def range_partitioning_end= range_end
+            reload! unless resource_full?
+            @gapi.range_partitioning ||= Google::Apis::BigqueryV2::RangePartitioning.new(
+              range: Google::Apis::BigqueryV2::RangePartitioning::Range.new
+            )
+            @gapi.range_partitioning.range.end = range_end
+            patch_gapi! :range_partitioning
+          end
+
           ##
           # Sets one or more fields on which data should be clustered. Must be
           # specified with time-based partitioning, data in the table will be
@@ -2552,15 +2799,15 @@ module Google
           #
           #   bigquery = Google::Cloud::Bigquery.new
           #   dataset = bigquery.dataset "my_dataset"
-          #   table = dataset.create_table "my_table" do |table|
-          #     table.time_partitioning_type  = "DAY"
-          #     table.time_partitioning_field = "dob"
-          #     table.schema do |schema|
+          #   table = dataset.create_table "my_table" do |t|
+          #     t.schema do |schema|
           #       schema.timestamp "dob", mode: :required
           #       schema.string "first_name", mode: :required
           #       schema.string "last_name", mode: :required
           #     end
-          #     table.clustering_fields = ["last_name", "first_name"]
+          #     t.time_partitioning_type  = "DAY"
+          #     t.time_partitioning_field = "dob"
+          #     t.clustering_fields = ["last_name", "first_name"]
           #   end
           #
           # @!group Attributes

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigquery
-      VERSION = "1.19.0".freeze
+      VERSION = "1.20.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.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-02-12 00:00:00.000000000 Z
+date: 2020-03-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -185,14 +185,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0.18'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '0.18'
 - !ruby/object:Gem::Dependency
   name: yard
   requirement: !ruby/object:Gem::Requirement