google-cloud-bigquery 1.34.0 → 1.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: e1868b74a16bb2b5b53c861f461c684bb5926e71c9c273a4d8f3bad9a02502a2
-  data.tar.gz: 582047d7174dc4063b0f9aaee2057136b4aff4eda687c05c2e9a931ba9dfc5b8
+  metadata.gz: d23511050f9602220787610566c2f1f62ed37ad3c014e9708e16a05bf4a079a1
+  data.tar.gz: 5a61cffca84ffd8a1561f28d6d2d545d7451389f4a363279bea40f907c1ec568
 SHA512:
-  metadata.gz: f4aaf252e3277bb47e9b1c27a083da4d74a3f37064506b7d288cc1f9dc720906d0403712917d1d8ada4fb5cef08e43a5f7db297848f428a007f197513fd4c72e
-  data.tar.gz: 42c4c862b05fbf0563bdb0721685dab1651243ceb5a803cbf6000b42203be58a5ac4504d4b7d0da9864825c041c379cd344c0efdd309bfb4aa5c7914de92fafd
+  metadata.gz: 4bbdca09750d11aabed55d8868b9b70501def5a8a12b35f4e0b92744c7d2a53e9ba503384771ccad85eb32ddc133b840d30a8434efc82260f4ff2fab2fbec6ac
+  data.tar.gz: 8990512c43041ad7b3b2e4d87c64d22b080a6a0bbc8d648fe09942504b2bc607a910809688b4f13410fb5c8fe2222f4b12ea8a613a9ac52864835319a1b56c66

data/CHANGELOG.md

@@ -1,5 +1,41 @@
 # Release History
 
+### 1.37.0 / 2021-10-21
+
+#### Features
+
+* Add support for Avro options to external data sources
+  * Add External::AvroSource
+
+### 1.36.0 / 2021-09-22
+
+#### Features
+
+* Add Job#delete
+
+#### Bug Fixes
+
+* Add precision and scale to Field#add_field
+
+### 1.35.1 / 2021-09-14
+
+#### Documentation
+
+* Wrap character class regex in backticks
+
+### 1.35.0 / 2021-08-12
+
+#### Features
+
+* Add GEOGRAPHY schema helpers
+  * Add LoadJob#geography
+  * Add Schema::Field#geography
+  * Add Table::Updater#geography
+* Add support for GEOGRAPHY type
+  * Add Schema#geography
+* Add support for multistatement transaction statistics in jobs
+  * Add Job#transaction_id
+
 ### 1.34.0 / 2021-07-20
 
 #### Features

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

@@ -38,6 +38,7 @@ module Google
       #   | `STRING`     | `String`                             |                                                    |
       #   | `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 |                                                    |
@@ -102,6 +103,8 @@ module Google
             ::Time.parse("#{value[:v]} UTC").to_datetime
           elsif field.type == "DATE"
             Date.parse value[:v]
+          elsif field.type == "GEOGRAPHY"
+            String value[:v]
           else
             value[:v]
           end

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

@@ -69,8 +69,8 @@ module Google
         ##
         # A unique ID for this dataset, without the project name.
         #
-        # @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
         #
@@ -501,7 +501,7 @@ module Google
         # you can pass the table's schema as a hash (see example.)
         #
         # @param [String] table_id The ID of the table. The ID must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`). The maximum
         #   length is 1,024 characters.
         # @param [String] name A descriptive name for the table.
         # @param [String] description A user-friendly description of the table.
@@ -630,7 +630,7 @@ module Google
         # @see https://cloud.google.com/bigquery/docs/views Creating views
         #
         # @param [String] table_id The ID of the view table. The ID must contain
-        #   only letters (a-z, A-Z), numbers (0-9), or underscores (_). The
+        #   only letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`). The
         #   maximum length is 1,024 characters.
         # @param [String] query The query that BigQuery executes when the view
         #   is referenced.
@@ -726,8 +726,8 @@ module Google
         #
         # @see https://cloud.google.com/bigquery/docs/materialized-views-intro Introduction to materialized views
         #
-        # @param [String] table_id The ID of the materialized view table. The ID must contain only letters (a-z, A-Z),
-        #   numbers (0-9), or underscores (_). The maximum length is 1,024 characters.
+        # @param [String] table_id The ID of the materialized view table. The ID must contain only letters (`[A-Za-z]`),
+        #   numbers (`[0-9]`), or underscores (`_`). The maximum length is 1,024 characters.
         # @param [String] query The query that BigQuery executes when the materialized view is referenced.
         # @param [String] name A descriptive name for the table.
         # @param [String] description A user-friendly description of the table.
@@ -954,7 +954,7 @@ module Google
         # {Routine::Updater#description=}.
         #
         # @param [String] routine_id The ID of the routine. The ID must contain only
-        #   letters (a-z, A-Z), numbers (0-9), or underscores (_). The maximum length
+        #   letters (`[A-Za-z]`), numbers (`[0-9]`), or underscores (`_`). The maximum length
         #   is 256 characters.
         # @yield [routine] A block for setting properties on the routine.
         # @yieldparam [Google::Cloud::Bigquery::Routine::Updater] routine An updater to set additional properties on the
@@ -1138,7 +1138,7 @@ module Google
         #   use named query parameters. When set, `legacy_sql` will automatically be set to false and `standard_sql` to
         #   true.
         #
-        #   Ruby types are mapped to BigQuery types as follows:
+        #   BigQuery types are converted from Ruby types as follows:
         #
         #   | BigQuery     | Ruby                                 | Notes                                              |
         #   |--------------|--------------------------------------|----------------------------------------------------|
@@ -1146,10 +1146,11 @@ module Google
         #   | `INT64`      | `Integer`                            |                                                    |
         #   | `FLOAT64`    | `Float`                              |                                                    |
         #   | `NUMERIC`    | `BigDecimal`                         | `BigDecimal` values will be rounded to scale 9.    |
-        #   | `BIGNUMERIC` |                                      | Query param values must be mapped in `types`.      |
+        #   | `BIGNUMERIC` | `BigDecimal`                         | NOT AUTOMATIC: Must be mapped using `types`, below.|
         #   | `STRING`     | `String`                             |                                                    |
         #   | `DATETIME`   | `DateTime`                           | `DATETIME` does not support time zone.             |
         #   | `DATE`       | `Date`                               |                                                    |
+        #   | `GEOGRAPHY`  | `String` (WKT or GeoJSON)            | NOT AUTOMATIC: Must be mapped using `types`, below.|
         #   | `TIMESTAMP`  | `Time`                               |                                                    |
         #   | `TIME`       | `Google::Cloud::BigQuery::Time`      |                                                    |
         #   | `BYTES`      | `File`, `IO`, `StringIO`, or similar |                                                    |
@@ -1157,7 +1158,8 @@ module Google
         #   | `STRUCT`     | `Hash`                               | Hash keys may be strings or symbols.               |
         #
         #   See [Data Types](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types) for an overview
-        #   of each BigQuery data type, including allowed values.
+        #   of each BigQuery data type, including allowed values. For the `GEOGRAPHY` type, see [Working with BigQuery
+        #   GIS data](https://cloud.google.com/bigquery/docs/gis-data).
         # @param [Array, Hash] types Standard SQL only. Types of the SQL parameters in `params`. It is not always
         #   possible to infer the right SQL type from a value in `params`. In these cases, `types` must be used to
         #   specify the SQL type for these values.
@@ -1174,6 +1176,7 @@ module Google
         #   * `:STRING`
         #   * `:DATETIME`
         #   * `:DATE`
+        #   * `:GEOGRAPHY`
         #   * `:TIMESTAMP`
         #   * `:TIME`
         #   * `:BYTES`
@@ -1246,8 +1249,8 @@ module Google
         #   (without incurring a charge). Optional. If unspecified, this will be
         #   set to your project default.
         # @param [String] job_id A user-defined ID for the query 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
@@ -1256,8 +1259,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
@@ -1481,7 +1484,7 @@ module Google
         #   use named query parameters. When set, `legacy_sql` will automatically be set to false and `standard_sql` to
         #   true.
         #
-        #   Ruby types are mapped to BigQuery types as follows:
+        #   BigQuery types are converted from Ruby types as follows:
         #
         #   | BigQuery     | Ruby                                 | Notes                                              |
         #   |--------------|--------------------------------------|----------------------------------------------------|
@@ -1489,10 +1492,11 @@ module Google
         #   | `INT64`      | `Integer`                            |                                                    |
         #   | `FLOAT64`    | `Float`                              |                                                    |
         #   | `NUMERIC`    | `BigDecimal`                         | `BigDecimal` values will be rounded to scale 9.    |
-        #   | `BIGNUMERIC` |                                      | Query param values must be mapped in `types`.      |
+        #   | `BIGNUMERIC` | `BigDecimal`                         | NOT AUTOMATIC: Must be mapped using `types`, below.|
         #   | `STRING`     | `String`                             |                                                    |
         #   | `DATETIME`   | `DateTime`                           | `DATETIME` does not support time zone.             |
         #   | `DATE`       | `Date`                               |                                                    |
+        #   | `GEOGRAPHY`  | `String` (WKT or GeoJSON)            | NOT AUTOMATIC: Must be mapped using `types`, below.|
         #   | `TIMESTAMP`  | `Time`                               |                                                    |
         #   | `TIME`       | `Google::Cloud::BigQuery::Time`      |                                                    |
         #   | `BYTES`      | `File`, `IO`, `StringIO`, or similar |                                                    |
@@ -1500,7 +1504,8 @@ module Google
         #   | `STRUCT`     | `Hash`                               | Hash keys may be strings or symbols.               |
         #
         #   See [Data Types](https://cloud.google.com/bigquery/docs/reference/standard-sql/data-types) for an overview
-        #   of each BigQuery data type, including allowed values.
+        #   of each BigQuery data type, including allowed values. For the `GEOGRAPHY` type, see [Working with BigQuery
+        #   GIS data](https://cloud.google.com/bigquery/docs/gis-data).
         # @param [Array, Hash] types Standard SQL only. Types of the SQL parameters in `params`. It is not always
         #   possible to infer the right SQL type from a value in `params`. In these cases, `types` must be used to
         #   specify the SQL type for these values.
@@ -1517,6 +1522,7 @@ module Google
         #   * `:STRING`
         #   * `:DATETIME`
         #   * `:DATE`
+        #   * `:GEOGRAPHY`
         #   * `:TIMESTAMP`
         #   * `:TIME`
         #   * `:BYTES`
@@ -1877,8 +1883,8 @@ module Google
         #   this option. Also note that for most use cases, the block yielded by
         #   this method is a more convenient way to configure the schema.
         # @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
@@ -1887,8 +1893,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
@@ -2421,6 +2427,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/external/avro_source.rb

@@ -0,0 +1,107 @@
+# Copyright 2021 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+
+require "google/apis/bigquery_v2"
+
+module Google
+  module Cloud
+    module Bigquery
+      module External
+        ##
+        # # AvroSource
+        #
+        # {External::AvroSource} is a subclass of {External::DataSource} and
+        # represents a Avro external data source that can be queried
+        # from directly, even though the data is not stored in BigQuery. Instead
+        # of loading or streaming the data, this object references the external
+        # data source.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   avro_url = "gs://bucket/path/to/*.avro"
+        #   avro_table = bigquery.external avro_url do |avro|
+        #     avro.use_avro_logical_types = 1
+        #   end
+        #
+        #   data = bigquery.query "SELECT * FROM my_ext_table",
+        #                         external: { my_ext_table: avro_table }
+        #
+        #   # Iterate over the first page of results
+        #   data.each do |row|
+        #     puts row[:name]
+        #   end
+        #   # Retrieve the next page of results
+        #   data = data.next if data.next?
+        #
+        class AvroSource < External::DataSource
+          ##
+          # @private Create an empty AvroSource object.
+          def initialize
+            super
+            @gapi.avro_options = Google::Apis::BigqueryV2::AvroOptions.new
+          end
+
+          ##
+          # Indicates whether to interpret logical types as the corresponding BigQuery data type (for example,
+          # `TIMESTAMP`), instead of using the raw type (for example, `INTEGER`).
+          #
+          # @return [Boolean]
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #
+          #   avro_url = "gs://bucket/path/to/*.avro"
+          #   avro_table = bigquery.external avro_url do |avro|
+          #     avro.use_avro_logical_types = true
+          #   end
+          #
+          #   avro_table.use_avro_logical_types #=> true
+          #
+          def use_avro_logical_types
+            @gapi.avro_options.use_avro_logical_types
+          end
+
+          ##
+          # Sets whether to interpret logical types as the corresponding BigQuery data type (for example, `TIMESTAMP`),
+          # instead of using the raw type (for example, `INTEGER`).
+          #
+          # @param [Boolean] new_use_avro_logical_types The new `use_avro_logical_types` value.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #
+          #   avro_url = "gs://bucket/path/to/*.avro"
+          #   avro_table = bigquery.external avro_url do |avro|
+          #     avro.use_avro_logical_types = true
+          #   end
+          #
+          #   avro_table.use_avro_logical_types #=> true
+          #
+          def use_avro_logical_types= new_use_avro_logical_types
+            frozen_check!
+            @gapi.avro_options.use_avro_logical_types = new_use_avro_logical_types
+          end
+        end
+      end
+    end
+  end
+end

data/lib/google/cloud/bigquery/external/data_source.rb

@@ -37,7 +37,7 @@ module Google
         #
         #   bigquery = Google::Cloud::Bigquery.new
         #
-        #   avro_url = "gs://bucket/path/to/data.avro"
+        #   avro_url = "gs://bucket/path/to/*.avro"
         #   avro_table = bigquery.external avro_url do |avro|
         #     avro.autodetect = true
         #   end
@@ -174,7 +174,7 @@ module Google
           #
           #   bigquery = Google::Cloud::Bigquery.new
           #
-          #   avro_url = "gs://bucket/path/to/data.avro"
+          #   avro_url = "gs://bucket/path/to/*.avro"
           #   avro_table = bigquery.external avro_url
           #
           #   avro_table.format #=> "AVRO"

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

@@ -14,6 +14,7 @@
 
 
 require "google/cloud/bigquery/external/data_source"
+require "google/cloud/bigquery/external/avro_source"
 require "google/cloud/bigquery/external/bigtable_source"
 require "google/cloud/bigquery/external/csv_source"
 require "google/cloud/bigquery/external/json_source"
@@ -101,28 +102,28 @@ module Google
         # @private Determine source_format from inputs
         def self.source_format_for urls, format
           val = {
-            "csv"                    => "CSV",
             "avro"                   => "AVRO",
-            "json"                   => "NEWLINE_DELIMITED_JSON",
-            "newline_delimited_json" => "NEWLINE_DELIMITED_JSON",
-            "sheets"                 => "GOOGLE_SHEETS",
-            "google_sheets"          => "GOOGLE_SHEETS",
-            "datastore"              => "DATASTORE_BACKUP",
+            "bigtable"               => "BIGTABLE",
+            "csv"                    => "CSV",
             "backup"                 => "DATASTORE_BACKUP",
+            "datastore"              => "DATASTORE_BACKUP",
             "datastore_backup"       => "DATASTORE_BACKUP",
-            "bigtable"               => "BIGTABLE",
+            "sheets"                 => "GOOGLE_SHEETS",
+            "google_sheets"          => "GOOGLE_SHEETS",
+            "json"                   => "NEWLINE_DELIMITED_JSON",
+            "newline_delimited_json" => "NEWLINE_DELIMITED_JSON",
             "orc"                    => "ORC",
             "parquet"                => "PARQUET"
           }[format.to_s.downcase]
           return val unless val.nil?
           Array(urls).each do |url|
-            return "CSV" if url.end_with? ".csv"
-            return "NEWLINE_DELIMITED_JSON" if url.end_with? ".json"
-            return "PARQUET" if url.end_with? ".parquet"
             return "AVRO" if url.end_with? ".avro"
+            return "BIGTABLE" if url.start_with? "https://googleapis.com/bigtable/projects/"
+            return "CSV" if url.end_with? ".csv"
             return "DATASTORE_BACKUP" if url.end_with? ".backup_info"
             return "GOOGLE_SHEETS" if url.start_with? "https://docs.google.com/spreadsheets/"
-            return "BIGTABLE" if url.start_with? "https://googleapis.com/bigtable/projects/"
+            return "NEWLINE_DELIMITED_JSON" if url.end_with? ".json"
+            return "PARQUET" if url.end_with? ".parquet"
           end
           nil
         end
@@ -131,13 +132,14 @@ module Google
         # @private Determine table class from source_format
         def self.table_class_for format
           case format
+          when "AVRO"                   then External::AvroSource
+          when "BIGTABLE"               then External::BigtableSource
           when "CSV"                    then External::CsvSource
+          when "GOOGLE_SHEETS"          then External::SheetsSource
           when "NEWLINE_DELIMITED_JSON" then External::JsonSource
           when "PARQUET"                then External::ParquetSource
-          when "GOOGLE_SHEETS"          then External::SheetsSource
-          when "BIGTABLE"               then External::BigtableSource
           else
-            # AVRO, DATASTORE_BACKUP
+            # DATASTORE_BACKUP, ORC
             External::DataSource
           end
         end

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

@@ -74,8 +74,8 @@ module Google
         ##
         # The ID of the job.
         #
-        # @return [String] The ID must contain only letters (a-z, A-Z), numbers
-        #   (0-9), underscores (_), or dashes (-). The maximum length is 1,024
+        # @return [String] The ID must contain only letters (`[A-Za-z]`), numbers
+        #   (`[0-9]`), underscores (`_`), or dashes (`-`). The maximum length is 1,024
         #   characters.
         #
         def job_id
@@ -226,6 +226,15 @@ module Google
           Array(@gapi.statistics.reservation_usage).map { |g| ReservationUsage.from_gapi g }
         end
 
+        ##
+        # The ID of a multi-statement transaction.
+        #
+        # @return [String, nil] The transaction ID, or `nil` if not associated with a transaction.
+        #
+        def transaction_id
+          @gapi.statistics.transaction_info&.transaction_id
+        end
+
         ##
         # The statistics including stack frames for a child job of a script.
         #
@@ -383,6 +392,28 @@ module Google
           true
         end
 
+        ##
+        # Requests that a job is deleted. This call will return when the job is deleted.
+        #
+        # @return [Boolean] Returns `true` if the job was deleted.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #
+        #   job = bigquery.job "my_job"
+        #
+        #   job.delete
+        #
+        # @!group Lifecycle
+        #
+        def delete
+          ensure_service!
+          service.delete_job job_id, location: location
+          true
+        end
+
         ##
         # Created a new job with the current configuration.
         #

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

@@ -744,7 +744,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.
@@ -778,7 +778,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.
@@ -810,7 +810,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.
@@ -853,7 +853,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.
@@ -911,7 +911,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.
@@ -958,7 +958,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.
@@ -990,7 +990,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.
@@ -1024,7 +1024,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.
@@ -1056,7 +1056,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.
@@ -1088,7 +1088,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.
@@ -1120,7 +1120,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.
@@ -1146,6 +1146,42 @@ module Google
             schema.date name, description: description, mode: mode, policy_tags: policy_tags
           end
 
+          ##
+          # Adds a geography field to the schema.
+          #
+          # See {Schema#geography}.
+          #
+          # @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"
+          #   job = dataset.load_job "my_table", "gs://abc/file" do |schema|
+          #     schema.record "cities_lived", mode: :repeated do |cities_lived|
+          #       cities_lived.geography "location", mode: :required
+          #       cities_lived.integer "number_of_years", mode: :required
+          #     end
+          #   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
@@ -1156,7 +1192,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.