google-cloud-bigquery 1.57.0 → 1.59.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbe17241cff1bf35169627f5be2bc589b24e4830077b1966192d74cb478efcc0
-  data.tar.gz: a6060857441bd335b1a8c67509f742d586026e043269d48893c22e4ffe3a3b9f
+  metadata.gz: d1f6d09bd925b1c1b03aa149fc848ab6e1524207045ef6abb2101f57254f9b5c
+  data.tar.gz: 28e45683731235e96448f1b4d5eb3e20d14be7966fa0ad7e12f4cf342342dd3d
 SHA512:
-  metadata.gz: 361370e039788d37aaebe2c3dc368e3715e7f09c65ffc85727285c1cdfe608412e09352570e3f1c88abb52b52c851646540c67e3c023c344ef1d8f37cab78086
-  data.tar.gz: 8b86e329d6843a4d4387f1c1daf1ed3feaabe47284ad4e8320ce3c9e39a492fadbecfe46006e1b0a38fedbe94250795aa0968a2148c94e0f1bf25a4514ad2d92
+  metadata.gz: 84e4dbca7f7e8194694b7ee127f822fb405d482610f84a6245b994d4b100c91e110a5d60737b9a889dd99cc5c28154bb62c64bff467078d4ced7bd78845dd268
+  data.tar.gz: ee80b48d42b3a99e2f3cbc4cfb9297ccaa02f2c715bde3221dba31380eac3745822de30c7e50a9b263f3179108b62495238cf155a6bc7f4c6c6e33fb3a05b5e0

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # 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
+
+* Add support for remote function options ([#30822](https://github.com/googleapis/google-cloud-ruby/issues/30822)) 
+
 ### 1.57.0 (2025-08-28)
 
 #### 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/remote_function_options.rb

@@ -0,0 +1,156 @@
+# Copyright 2025 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.
+
+module Google
+  module Cloud
+    module Bigquery
+      ##
+      # # RemoteFunctionOptions
+      #
+      # Options for a remote user-defined function.
+      #
+      class RemoteFunctionOptions
+        ##
+        # @private The Google API Client object.
+        # @return [Google::Apis::BigqueryV2::RemoteFunctionOptions]
+        attr_accessor :gapi
+
+        ##
+        # Creates a new RemoteFunctionOptions object.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   remote_function_options = Google::Cloud::Bigquery::RemoteFunctionOptions.new.tap do |rfo|
+        #     rfo.endpoint = "https://us-east1-my_gcf_project.cloudfunctions.net/remote_add"
+        #     rfo.connection = "projects/my-project/locations/us-east1/connections/my-connection"
+        #     rfo.user_defined_context = { "foo" => "bar" }
+        #   end
+        #
+        def initialize
+          @gapi = Google::Apis::BigqueryV2::RemoteFunctionOptions.new
+        end
+
+        ##
+        # The endpoint of the user-provided remote service, e.g.
+        # `https://us-east1-my_gcf_project.cloudfunctions.net/remote_add`.
+        #
+        # @return [String] The endpoint of the user-provided remote service.
+        #   Returns an empty string if the endpoint is not configured.
+        #
+        def endpoint
+          @gapi.endpoint || ""
+        end
+
+        ##
+        # Sets the endpoint of the user-provided remote service.
+        #
+        # @param [String, nil] new_endpoint The new endpoint. Passing `nil` will
+        #   clear the endpoint, indicating that no remote service is configured.
+        #
+        def endpoint= new_endpoint
+          @gapi.endpoint = new_endpoint
+        end
+
+        ##
+        # The fully qualified name of the user-provided connection object which
+        # holds the authentication information to send requests to the remote
+        # service.
+        #
+        # Format:
+        # `projects/{projectId}/locations/{locationId}/connections/{connectionId}`
+        #
+        # @return [String] The fully qualified name of the user-provided
+        #   connection object. Returns an empty string if the connection is not
+        #   configured.
+        #
+        def connection
+          @gapi.connection || ""
+        end
+
+        ##
+        # Sets the fully qualified name of the user-provided connection object.
+        #
+        # @param [String, nil] new_connection The new connection. Passing `nil`
+        #   will clear the connection, indicating that no authentication
+        #   information is configured for the remote service.
+        #
+        def connection= new_connection
+          @gapi.connection = new_connection
+        end
+
+        ##
+        # User-defined context as a set of key/value pairs, which will be sent
+        # as function invocation context together with batched arguments in the
+        # requests to the remote service. The total number of bytes of keys and
+        # values must be less than 8KB.
+        #
+        # @return [Hash] The user-defined context. Returns an empty hash if no
+        #   context is configured.
+        #
+        def user_defined_context
+          @gapi.user_defined_context || {}
+        end
+
+        ##
+        # Sets the user-defined context.
+        #
+        # @param [Hash, nil] new_user_defined_context The new user-defined
+        #   context. Passing `nil` will clear the context, meaning no
+        #   user-defined key-value pairs will be sent.
+        #
+        def user_defined_context= new_user_defined_context
+          @gapi.user_defined_context = new_user_defined_context
+        end
+
+        ##
+        # Max number of rows in each batch sent to the remote service. If absent
+        # or if 0, BigQuery dynamically decides the number of rows in a batch.
+        #
+        # @return [Integer] Max number of rows in each batch. Returns `0` if not
+        #   set, which indicates that BigQuery dynamically decides the number of
+        #   rows.
+        #
+        def max_batching_rows
+          @gapi.max_batching_rows || 0
+        end
+
+        ##
+        # Sets the max number of rows in each batch sent to the remote service.
+        #
+        # @param [Integer, nil] new_max_batching_rows The new max batching rows.
+        #   Passing `nil` or `0` will reset the batch size, indicating that
+        #   BigQuery should dynamically decide the number of rows in each batch.
+        #
+        def max_batching_rows= new_max_batching_rows
+          @gapi.max_batching_rows = new_max_batching_rows
+        end
+
+        # @private New RemoteFunctionOptions from a Google API Client object.
+        def self.from_gapi gapi
+          return nil if gapi.nil?
+          new.tap do |rfo|
+            rfo.instance_variable_set :@gapi, gapi
+          end
+        end
+
+        ##
+        # @private Returns the Google API Client object.
+        def to_gapi
+          @gapi
+        end
+      end
+    end
+  end
+end

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

@@ -18,6 +18,7 @@ require "google/cloud/bigquery/convert"
 require "google/cloud/bigquery/service"
 require "google/cloud/bigquery/routine/list"
 require "google/cloud/bigquery/argument"
+require "google/cloud/bigquery/remote_function_options"
 
 module Google
   module Cloud
@@ -743,6 +744,55 @@ module Google
           update_gapi!
         end
 
+        ##
+        # Remote function specific options. Optional.
+        #
+        # @return [RemoteFunctionOptions, nil] The remote function options, or `nil` if not set or the object is a
+        #   reference (see {#reference?}).
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   routine = dataset.routine "my_routine"
+        #
+        #   puts routine.remote_function_options.endpoint
+        #
+        # @!group Attributes
+        #
+        def remote_function_options
+          return nil if reference?
+          ensure_full_data!
+          RemoteFunctionOptions.from_gapi @gapi.remote_function_options
+        end
+
+        ##
+        # Updates the remote function specific options. Optional.
+        #
+        # @param [RemoteFunctionOptions] new_remote_function_options The new remote function options.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   routine = dataset.routine "my_routine"
+        #
+        #   rfo = Google::Cloud::Bigquery::RemoteFunctionOptions.new.tap do |rfo|
+        #     rfo.endpoint = "https://us-east1-my_gcf_project.cloudfunctions.net/remote_add"
+        #     rfo.connection = "projects/my-project/locations/us-east1/connections/my-connection"
+        #   end
+        #   routine.remote_function_options = rfo
+        #
+        # @!group Attributes
+        #
+        def remote_function_options= new_remote_function_options
+          ensure_full_data!
+          @gapi.remote_function_options = new_remote_function_options.to_gapi
+          update_gapi!
+        end
+
         ##
         # Updates the routine with changes made in the given block in a single update request. The following attributes
         # may be set: {Updater#routine_type=}, {Updater#language=}, {Updater#arguments=}, {Updater#return_type=},
@@ -1275,6 +1325,32 @@ module Google
             @gapi.data_governance_type = new_data_governance_type
           end
 
+          ##
+          # Updates the remote function specific options. Optional.
+          #
+          # @param [Google::Cloud::Bigquery::RemoteFunctionOptions] new_remote_function_options The new
+          #   remote function options.
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   routine = dataset.routine "my_routine"
+          #
+          #   routine.update do |r|
+          #     rfo = Google::Cloud::Bigquery::RemoteFunctionOptions.new
+          #     rfo.endpoint = "https://us-east1-my_gcf_project.cloudfunctions.net/remote_add"
+          #     rfo.connection = "projects/my-project/locations/us-east1/connections/my-connection"
+          #     r.remote_function_options = rfo
+          #   end
+          #
+          # @!group Attributes
+          #
+          def remote_function_options= new_remote_function_options
+            @gapi.remote_function_options = new_remote_function_options.to_gapi
+          end
+
           def update
             raise "not implemented in #{self.class}"
           end

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.57.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.57.0
+  version: 1.59.0
 platform: ruby
 authors:
 - Mike Moore
@@ -165,6 +165,7 @@ files:
 - lib/google/cloud/bigquery/project.rb
 - lib/google/cloud/bigquery/project/list.rb
 - lib/google/cloud/bigquery/query_job.rb
+- lib/google/cloud/bigquery/remote_function_options.rb
 - lib/google/cloud/bigquery/routine.rb
 - lib/google/cloud/bigquery/routine/list.rb
 - lib/google/cloud/bigquery/schema.rb