google-cloud-bigquery 1.42.0 → 1.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 779c0f4690b370db6eb7811fa6fb8dbca101dff34ff478dcdc51ed1e9c83c083
-  data.tar.gz: d1456024ae30a18c93c05d6d8be7eef88dd3f0610cdbf816cf0c46322c9574be
+  metadata.gz: d5aa7d55d1ed17508170fec706bfaf59a4434dc5ff9fa4a7ba6d3b655d441881
+  data.tar.gz: 865f6dc6a4a0abfed2c2c89da2a6c1021ca8e1174b6e89418da0807dca854954
 SHA512:
-  metadata.gz: 6a5da0e2565b0c224f46a6330d138c8fb35831e874ebc2364fd3b91578d400354011d1e9df7d2986dbe2398f610776b130b7eb9305af8282bf3a6265dd84aa05
-  data.tar.gz: 0d14faa0d89ba6a114e247c362f8a5d4775ae4dc19de1aad0a64083da7e41fc93ac810e876b434056340b27412bb08063af05edf33355800ca1c528ff02f437b
+  metadata.gz: 3641715b30ab0897a12fab3b216944d50ae5d9468614bac41a60116470b3f8e948db6d394ff02f9dabebd5dc0a16e3cb3a7d8e0ee03b433740953ec0f5e803ac
+  data.tar.gz: 76a9ad13b267ea9313213a1ee3e1ad094bfd0ea81831fa0aae0e46e7dcae01443a4b76a04b20703145c7b6eaf76e6b74792358ae31984e0d73b9e1cb41bd9db9

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Release History
 
+### 1.43.0 (2023-05-10)
+
+#### Features
+
+* Added support for default value expression ([#21540](https://github.com/googleapis/google-cloud-ruby/issues/21540)) 
+
 ### 1.42.0 (2023-01-15)
 
 #### Features

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

@@ -763,6 +763,22 @@ module Google
           #   At most 1 policy tag is currently allowed.
           # @param [Integer] max_length The maximum UTF-8 length of strings
           #   allowed in the field.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -773,9 +789,20 @@ module Google
           #     schema.string "first_name", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.string "first_name", default_value_expression: "'name'"
+          #   end
+          #
           # @!group Schema
-          def string name, description: nil, mode: :nullable, policy_tags: nil, max_length: nil
-            schema.string name, description: description, mode: mode, policy_tags: policy_tags, max_length: max_length
+          def string name, description: nil, mode: :nullable, policy_tags: nil, max_length: nil,
+                     default_value_expression: nil
+            schema.string name, description: description, mode: mode, policy_tags: policy_tags, max_length: max_length,
+                          default_value_expression: default_value_expression
           end
 
           ##
@@ -795,6 +822,22 @@ module Google
           #   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.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -805,9 +848,20 @@ module Google
           #     schema.integer "age", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.integer "age", default_value_expression: "1"
+          #   end
+          #
           # @!group Schema
-          def integer name, description: nil, mode: :nullable, policy_tags: nil
-            schema.integer name, description: description, mode: mode, policy_tags: policy_tags
+          def integer name, description: nil, mode: :nullable, policy_tags: nil,
+                      default_value_expression: nil
+            schema.integer name, description: description, mode: mode, policy_tags: policy_tags,
+                           default_value_expression: default_value_expression
           end
 
           ##
@@ -827,6 +881,22 @@ module Google
           #   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.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -837,9 +907,20 @@ module Google
           #     schema.float "price", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.float "price", default_value_expression: "1.0"
+          #   end
+          #
           # @!group Schema
-          def float name, description: nil, mode: :nullable, policy_tags: nil
-            schema.float name, description: description, mode: mode, policy_tags: policy_tags
+          def float name, description: nil, mode: :nullable, policy_tags: nil,
+                    default_value_expression: nil
+            schema.float name, description: description, mode: mode, policy_tags: policy_tags,
+                         default_value_expression: default_value_expression
           end
 
           ##
@@ -880,6 +961,22 @@ module Google
           #   must be: `1 ≤ (precision - scale) ≤ 29`. Values for scale must
           #   be: `0 ≤ scale ≤ 9`. If the scale value is set, the precision
           #   value must be set as well.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -890,14 +987,25 @@ module Google
           #     schema.numeric "total_cost", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.numeric "total_cost", default_value_expression: "1.0e10"
+          #   end
+          #
           # @!group Schema
-          def numeric name, description: nil, mode: :nullable, policy_tags: nil, precision: nil, scale: nil
+          def numeric name, description: nil, mode: :nullable, policy_tags: nil, precision: nil, scale: nil,
+                      default_value_expression: nil
             schema.numeric name,
                            description: description,
                            mode: mode,
                            policy_tags: policy_tags,
                            precision: precision,
-                           scale: scale
+                           scale: scale,
+                           default_value_expression: default_value_expression
           end
 
           ##
@@ -938,6 +1046,22 @@ module Google
           #   must be: `1 ≤ (precision - scale) ≤ 38`. Values for scale must
           #   be: `0 ≤ scale ≤ 38`. If the scale value is set, the precision
           #   value must be set as well.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -948,14 +1072,25 @@ module Google
           #     schema.bignumeric "total_cost", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.bignumeric "total_cost", default_value_expression: "1.0e10"
+          #   end
+          #
           # @!group Schema
-          def bignumeric name, description: nil, mode: :nullable, policy_tags: nil, precision: nil, scale: nil
+          def bignumeric name, description: nil, mode: :nullable, policy_tags: nil, precision: nil, scale: nil,
+                         default_value_expression: nil
             schema.bignumeric name,
                               description: description,
                               mode: mode,
                               policy_tags: policy_tags,
                               precision: precision,
-                              scale: scale
+                              scale: scale,
+                              default_value_expression: default_value_expression
           end
 
           ##
@@ -975,6 +1110,22 @@ module Google
           #   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.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -985,9 +1136,23 @@ module Google
           #     schema.boolean "active", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.boolean "active", default_value_expression: "true"
+          #   end
+          #
           # @!group Schema
-          def boolean name, description: nil, mode: :nullable, policy_tags: nil
-            schema.boolean name, description: description, mode: mode, policy_tags: policy_tags
+          def boolean name, description: nil, mode: :nullable, policy_tags: nil,
+                      default_value_expression: nil
+            schema.boolean name,
+                           description: description,
+                           mode: mode,
+                           policy_tags: policy_tags,
+                           default_value_expression: default_value_expression
           end
 
           ##
@@ -1009,6 +1174,22 @@ module Google
           #   At most 1 policy tag is currently allowed.
           # @param [Integer] max_length The maximum the maximum number of
           #   bytes in the field.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -1019,9 +1200,24 @@ module Google
           #     schema.bytes "avatar", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.bytes "avatar", default_value_expression: "b'101'"
+          #   end
+          #
           # @!group Schema
-          def bytes name, description: nil, mode: :nullable, policy_tags: nil, max_length: nil
-            schema.bytes name, description: description, mode: mode, policy_tags: policy_tags, max_length: max_length
+          def bytes name, description: nil, mode: :nullable, policy_tags: nil, max_length: nil,
+                    default_value_expression: nil
+            schema.bytes name,
+                         description: description,
+                         mode: mode,
+                         policy_tags: policy_tags,
+                         max_length: max_length,
+                         default_value_expression: default_value_expression
           end
 
           ##
@@ -1041,6 +1237,22 @@ module Google
           #   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.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -1051,9 +1263,20 @@ module Google
           #     schema.timestamp "creation_date", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.timestamp "creation_date", default_value_expression: "CURRENT_TIMESTAMP"
+          #   end
+          #
           # @!group Schema
-          def timestamp name, description: nil, mode: :nullable, policy_tags: nil
-            schema.timestamp name, description: description, mode: mode, policy_tags: policy_tags
+          def timestamp name, description: nil, mode: :nullable, policy_tags: nil,
+                        default_value_expression: nil
+            schema.timestamp name, description: description, mode: mode, policy_tags: policy_tags,
+                             default_value_expression: default_value_expression
           end
 
           ##
@@ -1073,6 +1296,22 @@ module Google
           #   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.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -1083,9 +1322,23 @@ module Google
           #     schema.time "duration", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.time "duration", default_value_expression: "CURRENT_TIME"
+          #   end
+          #
           # @!group Schema
-          def time name, description: nil, mode: :nullable, policy_tags: nil
-            schema.time name, description: description, mode: mode, policy_tags: policy_tags
+          def time name, description: nil, mode: :nullable, policy_tags: nil,
+                   default_value_expression: nil
+            schema.time name,
+                        description: description,
+                        mode: mode,
+                        policy_tags: policy_tags,
+                        default_value_expression: default_value_expression
           end
 
           ##
@@ -1105,6 +1358,22 @@ module Google
           #   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.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -1115,9 +1384,23 @@ module Google
           #     schema.datetime "target_end", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.datetime "target_end", default_value_expression: "CURRENT_DATETIME"
+          #   end
+          #
           # @!group Schema
-          def datetime name, description: nil, mode: :nullable, policy_tags: nil
-            schema.datetime name, description: description, mode: mode, policy_tags: policy_tags
+          def datetime name, description: nil, mode: :nullable, policy_tags: nil,
+                       default_value_expression: nil
+            schema.datetime name,
+                            description: description,
+                            mode: mode,
+                            policy_tags: policy_tags,
+                            default_value_expression: default_value_expression
           end
 
           ##
@@ -1137,6 +1420,22 @@ module Google
           #   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.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -1147,9 +1446,23 @@ module Google
           #     schema.date "birthday", mode: :required
           #   end
           #
+          # @example Add field with default value.
+          #   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.date "birthday", default_value_expression: "CURRENT_DATE"
+          #   end
+          #
           # @!group Schema
-          def date name, description: nil, mode: :nullable, policy_tags: nil
-            schema.date name, description: description, mode: mode, policy_tags: policy_tags
+          def date name, description: nil, mode: :nullable, policy_tags: nil,
+                   default_value_expression: nil
+            schema.date name,
+                        description: description,
+                        mode: mode,
+                        policy_tags: policy_tags,
+                        default_value_expression: default_value_expression
           end
 
           ##
@@ -1171,6 +1484,22 @@ module Google
           #   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.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -1184,8 +1513,22 @@ module Google
           #     end
           #   end
           #
-          def geography name, description: nil, mode: :nullable, policy_tags: nil
-            schema.geography name, description: description, mode: mode, policy_tags: policy_tags
+          # @example Add field with default value.
+          #   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.geography "location", default_value_expression: "ST_GEOGPOINT(-122.084801, 37.422131)"
+          #   end
+          #
+          def geography name, description: nil, mode: :nullable, policy_tags: nil,
+                        default_value_expression: nil
+            schema.geography name,
+                             description: description,
+                             mode: mode,
+                             policy_tags: policy_tags,
+                             default_value_expression: default_value_expression
           end
 
           ##
@@ -1205,6 +1548,23 @@ module Google
           # @param [Symbol] mode The field's mode. The possible values are
           #   `:nullable`, `:required`, and `:repeated`. The default value is
           #   `:nullable`.
+          # @param default_value_expression [String] The default value of a field
+          #   using a SQL expression. It can only be set for top level fields (columns).
+          #   Use a struct or array expression to specify default value for the entire struct or
+          #   array. The valid SQL expressions are:
+          #     - Literals for all data types, including STRUCT and ARRAY.
+          #     - The following functions:
+          #         `CURRENT_TIMESTAMP`
+          #         `CURRENT_TIME`
+          #         `CURRENT_DATE`
+          #         `CURRENT_DATETIME`
+          #         `GENERATE_UUID`
+          #         `RAND`
+          #         `SESSION_USER`
+          #         `ST_GEOPOINT`
+          #     - Struct or array composed with the above allowed functions, for example:
+          #         "[CURRENT_DATE(), DATE '2020-01-01'"]
+          #
           # @yield [nested_schema] a block for setting the nested schema
           # @yieldparam [Schema] nested_schema the object accepting the
           #   nested schema
@@ -1221,10 +1581,23 @@ module Google
           #     end
           #   end
           #
+          # @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", default_value_expression: "STRUCT('place',10)" do |cities_lived|
+          #       cities_lived.string "place", mode: :required
+          #       cities_lived.integer "number_of_years", mode: :required
+          #     end
+          #   end
+          #
           # @!group Schema
           #
-          def record name, description: nil, mode: nil, &block
-            schema.record name, description: description, mode: mode, &block
+          def record name, description: nil, mode: nil, default_value_expression: nil, &block
+            schema.record name, description: description, mode: mode,
+                          default_value_expression: default_value_expression, &block
           end
 
           ##