google-cloud-bigquery 1.58.0 → 1.59.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7eb6ceb935eefe0881476f99a5f6e7bdf85e42debb251ba34ef999a3845ca3ef
-  data.tar.gz: 71cb8fa56300a051b257e77fb332fee37a18044fb26317a3e0eebbb57023144d
+  metadata.gz: d1f6d09bd925b1c1b03aa149fc848ab6e1524207045ef6abb2101f57254f9b5c
+  data.tar.gz: 28e45683731235e96448f1b4d5eb3e20d14be7966fa0ad7e12f4cf342342dd3d
 SHA512:
-  metadata.gz: 70305f4088f9af6ad6823f07e9326a5db55e2abfd17094d4a3d52ae1dd85dae871df5acaec43b9163130f7cbe226a3339dbcef96bbf181fdbafcbbdfca70bcb8
-  data.tar.gz: 93f2a24709c74dae96f6732ee36d328f9f46e9cecb63f87ac1da70d9e37d1a4d03c452ae4c4a772b31adb5145cb53157f4d14869d54f0131208ac2060551cb19
+  metadata.gz: 84e4dbca7f7e8194694b7ee127f822fb405d482610f84a6245b994d4b100c91e110a5d60737b9a889dd99cc5c28154bb62c64bff467078d4ced7bd78845dd268
+  data.tar.gz: ee80b48d42b3a99e2f3cbc4cfb9297ccaa02f2c715bde3221dba31380eac3745822de30c7e50a9b263f3179108b62495238cf155a6bc7f4c6c6e33fb3a05b5e0

data/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Release History
 
+### 1.59.0 (2025-09-17)
+
+#### Features
+
+* Support collation feature ([#30919](https://github.com/googleapis/google-cloud-ruby/issues/30919)) 
+
 ### 1.58.0 (2025-09-03)
 
 #### Features

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

@@ -197,6 +197,37 @@ module Google
           patch_gapi! :description
         end
 
+        ##
+        # The default collation of the dataset.
+        #
+        # @return [String, nil] The default collation, or `nil` if not present or the object is a
+        #   reference (see {#reference?}).
+        #
+        # @!group Attributes
+        #
+        def default_collation
+          return nil if reference?
+          ensure_full_data!
+          @gapi.default_collation
+        end
+
+        ##
+        # Updates the default collation of the dataset.
+        #
+        # If the dataset is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
+        # @param [String] new_default_collation The new default collation for the dataset.
+        #
+        # @!group Attributes
+        #
+        def default_collation= new_default_collation
+          reload! unless resource_full?
+          @gapi.update! default_collation: new_default_collation
+          patch_gapi! :default_collation
+        end
+
         ##
         # The default lifetime of all tables in the dataset, in milliseconds.
         #

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

@@ -351,6 +351,31 @@ module Google
             @gapi.scale
           end
 
+          ##
+          # The collation of the field.
+          #
+          # Collation can be set only when the type of field is `STRING`.
+          # The following values are supported:
+          #
+          # * `und:ci`: undetermined locale, case insensitive.
+          # * (empty string): Default to case-sensitive behavior.
+          #
+          # @return [String, nil] The collation for the field, or `nil`.
+          #
+          def collation
+            @gapi.collation
+          end
+
+          ##
+          # Updates the collation of the field.
+          #
+          # @param [String] new_collation The new collation. See {#collation}
+          #   for supported values.
+          #
+          def collation= new_collation
+            @gapi.update! collation: new_collation
+          end
+
           ##
           # Checks if the type of the field is `STRING`.
           #
@@ -568,7 +593,7 @@ module Google
           # @param [Integer] max_length The maximum UTF-8 length of strings
           #   allowed in the field.
           #
-          def string name, description: nil, mode: :nullable, policy_tags: nil, max_length: nil
+          def string name, description: nil, mode: :nullable, policy_tags: nil, max_length: nil, collation: nil
             record_check!
 
             add_field name,
@@ -576,7 +601,8 @@ module Google
                       description: description,
                       mode: mode,
                       policy_tags: policy_tags,
-                      max_length: max_length
+                      max_length: max_length,
+                      collation: collation
           end
 
           ##
@@ -1029,7 +1055,8 @@ module Google
                         policy_tags: nil,
                         max_length: nil,
                         precision: nil,
-                        scale: nil
+                        scale: nil,
+                        collation: nil
             frozen_check!
 
             new_gapi = Google::Apis::BigqueryV2::TableFieldSchema.new(
@@ -1046,6 +1073,7 @@ module Google
             new_gapi.max_length = max_length if max_length
             new_gapi.precision = precision if precision
             new_gapi.scale = scale if scale
+            new_gapi.collation = collation if collation
             # Remove any existing field of this name
             @gapi.fields ||= []
             @gapi.fields.reject! { |f| f.name == new_gapi.name }

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

@@ -318,13 +318,14 @@ module Google
         #         "[CURRENT_DATE(), DATE '2020-01-01'"]
         #
         def string name, description: nil, mode: :nullable, policy_tags: nil,
-                   max_length: nil, default_value_expression: nil
+                   max_length: nil, default_value_expression: nil, collation: nil
           add_field name, :string,
                     description: description,
                     mode: mode,
                     policy_tags: policy_tags,
                     max_length: max_length,
-                    default_value_expression: default_value_expression
+                    default_value_expression: default_value_expression,
+                    collation: collation
         end
 
         ##
@@ -981,7 +982,8 @@ module Google
                       max_length: nil,
                       precision: nil,
                       scale: nil,
-                      default_value_expression: nil
+                      default_value_expression: nil,
+                      collation: nil
           frozen_check!
 
           new_gapi = Google::Apis::BigqueryV2::TableFieldSchema.new(
@@ -999,6 +1001,7 @@ module Google
           new_gapi.precision = precision if precision
           new_gapi.scale = scale if scale
           new_gapi.default_value_expression = default_value_expression if default_value_expression
+          new_gapi.collation = collation if collation
           # Remove any existing field of this name
           @gapi.fields ||= []
           @gapi.fields.reject! { |f| f.name == new_gapi.name }

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

@@ -752,6 +752,37 @@ module Google
           patch_gapi! :description
         end
 
+        ##
+        # The default collation of the table.
+        #
+        # @return [String, nil] The default collation, or `nil` if not present or the object is a
+        #   reference (see {#reference?}).
+        #
+        # @!group Attributes
+        #
+        def default_collation
+          return nil if reference?
+          ensure_full_data!
+          @gapi.default_collation
+        end
+
+        ##
+        # Updates the default collation of the table.
+        #
+        # If the table is not a full resource representation (see
+        # {#resource_full?}), the full representation will be retrieved before
+        # the update to comply with ETag-based optimistic concurrency control.
+        #
+        # @param [String] new_default_collation The new default collation for the table.
+        #
+        # @!group Attributes
+        #
+        def default_collation= new_default_collation
+          reload! unless resource_full?
+          @gapi.update! default_collation: new_default_collation
+          patch_gapi! :default_collation
+        end
+
         ##
         # The number of bytes in the table.
         #
@@ -3706,7 +3737,7 @@ format_options_use_int64_timestamp: format_options_use_int64_timestamp
           #   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
+          # @param [String] default_value_expression 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:
@@ -3722,6 +3753,11 @@ format_options_use_int64_timestamp: format_options_use_int64_timestamp
           #         `ST_GEOPOINT`
           #     - Struct or array composed with the above allowed functions, for example:
           #         "[CURRENT_DATE(), DATE '2020-01-01'"]
+          # @param [String] collation The collation of the field.
+          #   Collation can be set only when the type of field is `STRING`.
+          #   The following values are supported:
+          #     - `und:ci`: undetermined locale, case insensitive.
+          #     - (empty string): Default to case-sensitive behavior.
           #
           # @example
           #   require "google/cloud/bigquery"
@@ -3743,9 +3779,9 @@ format_options_use_int64_timestamp: format_options_use_int64_timestamp
           #
           # @!group Schema
           def string name, description: nil, mode: :nullable, policy_tags: nil, max_length: nil,
-                     default_value_expression: nil
+                     default_value_expression: nil, collation: nil
             schema.string name, description: description, mode: mode, policy_tags: policy_tags, max_length: max_length,
-                          default_value_expression: default_value_expression
+                          default_value_expression: default_value_expression, collation: collation
           end
 
           ##

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Bigquery
-      VERSION = "1.58.0".freeze
+      VERSION = "1.59.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.58.0
+  version: 1.59.0
 platform: ruby
 authors:
 - Mike Moore