google-cloud-bigquery 1.34.0 → 1.37.0

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

@@ -287,7 +287,7 @@ module Google
         # Adds a string field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -314,7 +314,7 @@ module Google
         # Adds an integer field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -334,7 +334,7 @@ module Google
         # Adds a floating-point number field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -365,7 +365,7 @@ module Google
         # for financial calculations.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -412,7 +412,7 @@ module Google
         # for financial calculations.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -448,7 +448,7 @@ module Google
         # Adds a boolean field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -468,7 +468,7 @@ module Google
         # Adds a bytes field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -490,7 +490,7 @@ module Google
         # Adds a timestamp field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -510,7 +510,7 @@ module Google
         # Adds a time field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -530,7 +530,7 @@ module Google
         # Adds a datetime field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -550,7 +550,7 @@ module Google
         # Adds a date field to the schema.
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.
@@ -566,6 +566,28 @@ module Google
           add_field name, :date, description: description, mode: mode, policy_tags: policy_tags
         end
 
+        ##
+        # Adds a geography field to the schema.
+        #
+        # @see https://cloud.google.com/bigquery/docs/gis-data Working with BigQuery GIS data
+        #
+        # @param [String] name The field name. The name must contain only
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
+        #   start with a letter or underscore. The maximum length is 128
+        #   characters.
+        # @param [String] description A description of the field.
+        # @param [Symbol] mode The field's mode. The possible values are
+        #   `:nullable`, `:required`, and `:repeated`. The default value is
+        #   `:nullable`.
+        # @param [Array<String>, String] policy_tags The policy tag list or
+        #   single policy tag for the field. Policy tag identifiers are of
+        #   the form `projects/*/locations/*/taxonomies/*/policyTags/*`.
+        #   At most 1 policy tag is currently allowed.
+        #
+        def geography name, description: nil, mode: :nullable, policy_tags: nil
+          add_field name, :geography, description: description, mode: mode, policy_tags: policy_tags
+        end
+
         ##
         # Adds a record field to the schema. A block must be passed describing
         # the nested fields of the record. For more information about nested
@@ -574,7 +596,7 @@ module Google
         # ](https://cloud.google.com/bigquery/docs/loading-data#loading_denormalized_nested_and_repeated_data).
         #
         # @param [String] name The field name. The name must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
         #   start with a letter or underscore. The maximum length is 128
         #   characters.
         # @param [String] description A description of the field.

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

@@ -418,6 +418,14 @@ module Google
           end
         end
 
+        ##
+        # Deletes the job specified by jobId and location (required).
+        def delete_job job_id, location: nil
+          execute do
+            service.delete_job @project, job_id, location: location
+          end
+        end
+
         ##
         # Returns the query data for the job
         def job_query_results job_id, location: nil, max: nil, token: nil, start: nil, timeout: nil
@@ -601,7 +609,7 @@ module Google
 
           protected
 
-          def retry? result, current_retries #:nodoc:
+          def retry? result, current_retries
             if current_retries < @retries && retry_error_reason?(result)
               return true
             end

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

@@ -110,6 +110,7 @@ module Google
           # | `BIGNUMERIC` | `String`                             | Pass as `String` to avoid rounding to scale 9.     |
           # | `DATETIME`   | `DateTime`                           | `DATETIME` does not support time zone.             |
           # | `DATE`       | `Date`                               |                                                    |
+          # | `GEOGRAPHY`  | `String`                             |                                                    |
           # | `TIMESTAMP`  | `Time`                               |                                                    |
           # | `TIME`       | `Google::Cloud::BigQuery::Time`      |                                                    |
           # | `BYTES`      | `File`, `IO`, `StringIO`, or similar |                                                    |

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

@@ -119,8 +119,8 @@ module Google
         ##
         # A unique ID for this table.
         #
-        # @return [String] The ID must contain only letters (a-z, A-Z), numbers
-        #   (0-9), or underscores (_). The maximum length is 1,024 characters.
+        # @return [String] The ID must contain only letters (`[A-Za-z]`), numbers
+        #   (`[0-9]`), or underscores (`_`). The maximum length is 1,024 characters.
         #
         # @!group Attributes
         #
@@ -132,8 +132,8 @@ module Google
         ##
         # The ID of the `Dataset` containing this table.
         #
-        # @return [String] The ID must contain only letters (a-z, A-Z), numbers
-        #   (0-9), or underscores (_). The maximum length is 1,024 characters.
+        # @return [String] The ID must contain only letters (`[A-Za-z]`), numbers
+        #   (`[0-9]`), or underscores (`_`). The maximum length is 1,024 characters.
         #
         # @!group Attributes
         #
@@ -1633,8 +1633,8 @@ module Google
         #   * `empty` - An error will be returned if the destination table
         #     already contains data.
         # @param [String] job_id A user-defined ID for the copy job. The ID
-        #   must contain only letters (a-z, A-Z), numbers (0-9), underscores
-        #   (_), or dashes (-). The maximum length is 1,024 characters. If
+        #   must contain only letters (`[A-Za-z]`), numbers (`[0-9]`), underscores
+        #   (`_`), or dashes (`-`). The maximum length is 1,024 characters. If
         #   `job_id` is provided, then `prefix` will not be used.
         #
         #   See [Generating a job
@@ -1643,8 +1643,8 @@ module Google
         #   prepended to a generated value to produce a unique job ID. For
         #   example, the prefix `daily_import_job_` can be given to generate a
         #   job ID such as `daily_import_job_12vEDtMQ0mbp1Mo5Z7mzAFQJZazh`. The
-        #   prefix must contain only letters (a-z, A-Z), numbers (0-9),
-        #   underscores (_), or dashes (-). The maximum length of the entire ID
+        #   prefix must contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
+        #   underscores (`_`), or dashes (`-`). The maximum length of the entire ID
         #   is 1,024 characters. If `job_id` is provided, then `prefix` will not
         #   be used.
         # @param [Hash] labels A hash of user-provided labels associated with
@@ -1822,8 +1822,8 @@ module Google
         # @param [Boolean] header Whether to print out a header row in the
         #   results. Default is `true`.
         # @param [String] job_id A user-defined ID for the extract job. The ID
-        #   must contain only letters (a-z, A-Z), numbers (0-9), underscores
-        #   (_), or dashes (-). The maximum length is 1,024 characters. If
+        #   must contain only letters (`[A-Za-z]`), numbers (`[0-9]`), underscores
+        #   (`_`), or dashes (`-`). The maximum length is 1,024 characters. If
         #   `job_id` is provided, then `prefix` will not be used.
         #
         #   See [Generating a job
@@ -1832,8 +1832,8 @@ module Google
         #   prepended to a generated value to produce a unique job ID. For
         #   example, the prefix `daily_import_job_` can be given to generate a
         #   job ID such as `daily_import_job_12vEDtMQ0mbp1Mo5Z7mzAFQJZazh`. The
-        #   prefix must contain only letters (a-z, A-Z), numbers (0-9),
-        #   underscores (_), or dashes (-). The maximum length of the entire ID
+        #   prefix must contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
+        #   underscores (`_`), or dashes (`-`). The maximum length of the entire ID
         #   is 1,024 characters. If `job_id` is provided, then `prefix` will not
         #   be used.
         # @param [Hash] labels A hash of user-provided labels associated with
@@ -2070,8 +2070,8 @@ module Google
         #   value is `0`. This property is useful if you have header rows in the
         #   file that should be skipped.
         # @param [String] job_id A user-defined ID for the load job. The ID
-        #   must contain only letters (a-z, A-Z), numbers (0-9), underscores
-        #   (_), or dashes (-). The maximum length is 1,024 characters. If
+        #   must contain only letters (`[A-Za-z]`), numbers (`[0-9]`), underscores
+        #   (`_`), or dashes (`-`). The maximum length is 1,024 characters. If
         #   `job_id` is provided, then `prefix` will not be used.
         #
         #   See [Generating a job
@@ -2080,8 +2080,8 @@ module Google
         #   prepended to a generated value to produce a unique job ID. For
         #   example, the prefix `daily_import_job_` can be given to generate a
         #   job ID such as `daily_import_job_12vEDtMQ0mbp1Mo5Z7mzAFQJZazh`. The
-        #   prefix must contain only letters (a-z, A-Z), numbers (0-9),
-        #   underscores (_), or dashes (-). The maximum length of the entire ID
+        #   prefix must contain only letters (`[A-Za-z]`), numbers (`[0-9]`),
+        #   underscores (`_`), or dashes (`-`). The maximum length of the entire ID
         #   is 1,024 characters. If `job_id` is provided, then `prefix` will not
         #   be used.
         # @param [Hash] labels A hash of user-provided labels associated with
@@ -2369,12 +2369,15 @@ module Google
         # | `BIGNUMERIC` | `String`                             | Pass as `String` to avoid rounding to scale 9.     |
         # | `DATETIME`   | `DateTime`                           | `DATETIME` does not support time zone.             |
         # | `DATE`       | `Date`                               |                                                    |
+        # | `GEOGRAPHY`  | `String`                             | Well-known text (WKT) or GeoJSON.                  |
         # | `TIMESTAMP`  | `Time`                               |                                                    |
         # | `TIME`       | `Google::Cloud::BigQuery::Time`      |                                                    |
         # | `BYTES`      | `File`, `IO`, `StringIO`, or similar |                                                    |
         # | `ARRAY`      | `Array`                              | Nested arrays, `nil` values are not supported.     |
         # | `STRUCT`     | `Hash`                               | Hash keys may be strings or symbols.               |
         #
+        # For `GEOGRAPHY` data, see [Working with BigQuery GIS data](https://cloud.google.com/bigquery/docs/gis-data).
+        #
         # Because BigQuery's streaming API is designed for high insertion rates,
         # modifications to the underlying table metadata are eventually
         # consistent when interacting with the streaming system. In most cases
@@ -3231,7 +3234,7 @@ module Google
           # See {Schema#string}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3265,7 +3268,7 @@ module Google
           # See {Schema#integer}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3297,7 +3300,7 @@ module Google
           # See {Schema#float}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3340,7 +3343,7 @@ module Google
           # See {Schema#numeric}
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3398,7 +3401,7 @@ module Google
           # See {Schema#bignumeric}
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3445,7 +3448,7 @@ module Google
           # See {Schema#boolean}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3477,7 +3480,7 @@ module Google
           # See {Schema#bytes}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3511,7 +3514,7 @@ module Google
           # See {Schema#timestamp}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3543,7 +3546,7 @@ module Google
           # See {Schema#time}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3575,7 +3578,7 @@ module Google
           # See {Schema#datetime}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3607,7 +3610,7 @@ module Google
           # See {Schema#date}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.
@@ -3633,6 +3636,37 @@ module Google
             schema.date name, description: description, mode: mode, policy_tags: policy_tags
           end
 
+          ##
+          # Adds a geography field to the schema.
+          #
+          # @see https://cloud.google.com/bigquery/docs/gis-data Working with BigQuery GIS data
+          #
+          # @param [String] name The field name. The name must contain only
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
+          #   start with a letter or underscore. The maximum length is 128
+          #   characters.
+          # @param [String] description A description of the field.
+          # @param [Symbol] mode The field's mode. The possible values are
+          #   `:nullable`, `:required`, and `:repeated`. The default value is
+          #   `:nullable`.
+          # @param [Array<String>, String] policy_tags The policy tag list or
+          #   single policy tag for the field. Policy tag identifiers are of
+          #   the form `projects/*/locations/*/taxonomies/*/policyTags/*`.
+          #   At most 1 policy tag is currently allowed.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   table = dataset.create_table "my_table" do |schema|
+          #     schema.geography "home", mode: :required
+          #   end
+          #
+          def geography name, description: nil, mode: :nullable, policy_tags: nil
+            schema.geography name, description: description, mode: mode, policy_tags: policy_tags
+          end
+
           ##
           # Adds a record field to the schema. A block must be passed describing
           # the nested fields of the record. For more information about nested
@@ -3643,7 +3677,7 @@ module Google
           # See {Schema#record}.
           #
           # @param [String] name The field name. The name must contain only
-          #   letters (a-z, A-Z), numbers (0-9), or underscores (_), and must
+          #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`), and must
           #   start with a letter or underscore. The maximum length is 128
           #   characters.
           # @param [String] description A description of the field.

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigquery
-      VERSION = "1.34.0".freeze
+      VERSION = "1.37.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.34.0
+  version: 1.37.0
 platform: ruby
 authors:
 - Mike Moore
@@ -9,7 +9,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-07-20 00:00:00.000000000 Z
+date: 2021-10-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: concurrent-ruby
@@ -270,6 +270,7 @@ files:
 - lib/google/cloud/bigquery/dataset/list.rb
 - lib/google/cloud/bigquery/encryption_configuration.rb
 - lib/google/cloud/bigquery/external.rb
+- lib/google/cloud/bigquery/external/avro_source.rb
 - lib/google/cloud/bigquery/external/bigtable_source.rb
 - lib/google/cloud/bigquery/external/bigtable_source/column.rb
 - lib/google/cloud/bigquery/external/bigtable_source/column_family.rb