google-cloud-bigquery 1.41.0 → 1.43.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8f13891ae7f46f3a0561140fabe4eed4cc426923258e17ed4cc10cc8155f9129
-  data.tar.gz: 65eb5cfc6fb0feadae0d4503bcf2bd1942a0a9740a6f4f1b6f6aaddf7ee244c0
+  metadata.gz: d5aa7d55d1ed17508170fec706bfaf59a4434dc5ff9fa4a7ba6d3b655d441881
+  data.tar.gz: 865f6dc6a4a0abfed2c2c89da2a6c1021ca8e1174b6e89418da0807dca854954
 SHA512:
-  metadata.gz: cecf4d1450deb04f33772ebc0bf18892816dda84e9e2b43668615dc37c49b3319465c3d0f3cb9c07ca9cc5a5e7a7118daab1f1aa51c25bf83ebadc925bd52eef
-  data.tar.gz: c678e3b5420f82894c1d4935f4f89959fda4ea6e66faffa7fb649c0ff3c0e2fec91daf3e77208e02eb4747cf1a3d41ef5764a4b4da8b76b2a03328861121c7c2
+  metadata.gz: 3641715b30ab0897a12fab3b216944d50ae5d9468614bac41a60116470b3f8e948db6d394ff02f9dabebd5dc0a16e3cb3a7d8e0ee03b433740953ec0f5e803ac
+  data.tar.gz: 76a9ad13b267ea9313213a1ee3e1ad094bfd0ea81831fa0aae0e46e7dcae01443a4b76a04b20703145c7b6eaf76e6b74792358ae31984e0d73b9e1cb41bd9db9

data/CHANGELOG.md

@@ -1,5 +1,18 @@
 # 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
+
+* Added support for authorized dataset ([#19442](https://github.com/googleapis/google-cloud-ruby/issues/19442)) 
+* Added support for tags in dataset ([#19350](https://github.com/googleapis/google-cloud-ruby/issues/19350)) 
+
 ### 1.41.0 (2023-01-05)
 
 #### Features

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

@@ -61,8 +61,10 @@ module Google
             "user"           => :user_by_email,
             "user_by_email"  => :user_by_email,
             "userByEmail"    => :user_by_email,
-            "view"           => :view
+            "view"           => :view,
+            "dataset"        => :dataset
           }.freeze
+          attr_reader :rules
 
           # @private
           GROUPS = {
@@ -267,6 +269,44 @@ module Google
             add_access_view view
           end
 
+          ##
+          # Add reader access to a dataset.
+          #
+          # @param [Google::Cloud::Bigquery::DatasetAccessEntry, Hash<String,String> ] dataset A DatasetAccessEntry
+          #   or a Hash object. Required
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   other_dataset = bigquery.dataset "my_other_dataset", skip_lookup: true
+          #
+          #   params = {
+          #     dataset_id: other_dataset.dataset_id,
+          #     project_id: other_dataset.project_id,
+          #     target_types: ["VIEWS"]
+          #   }
+          #
+          #   dataset.access do |access|
+          #     access.add_reader_dataset params
+          #   end
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   other_dataset = bigquery.dataset "my_other_dataset", skip_lookup: true
+          #
+          #   dataset.access do |access|
+          #     access.add_reader_dataset other_dataset.access_entry(target_types: ["VIEWS"])
+          #   end
+          #
+          def add_reader_dataset dataset
+            add_access_dataset dataset
+          end
+
           ##
           # Add writer access to a user.
           #
@@ -610,6 +650,44 @@ module Google
             remove_access_view view
           end
 
+          ##
+          # Removes reader access of a dataset.
+          #
+          # @param [Google::Cloud::Bigquery::DatasetAccessEntry, Hash<String,String> ] dataset A DatasetAccessEntry
+          #   or a Hash object. Required
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   other_dataset = bigquery.dataset "my_other_dataset", skip_lookup: true
+          #
+          #   params = {
+          #     dataset_id: other_dataset.dataset_id,
+          #     project_id: other_dataset.project_id,
+          #     target_types: ["VIEWS"]
+          #   }
+          #
+          #   dataset.access do |access|
+          #     access.remove_reader_dataset params
+          #   end
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   other_dataset = bigquery.dataset "my_other_dataset", skip_lookup: true
+          #
+          #   dataset.access do |access|
+          #     access.remove_reader_dataset other_dataset.access_entry(target_types: ["VIEWS"])
+          #   end
+          #
+          def remove_reader_dataset dataset
+            remove_access_dataset dataset
+          end
+
           ##
           # Remove writer access from a user.
           #
@@ -951,6 +1029,40 @@ module Google
             lookup_access_view view
           end
 
+          ##
+          # Checks reader access for a dataset.
+          #
+          # @param [Google::Cloud::Bigquery::DatasetAccessEntry, Hash<String,String> ] dataset A DatasetAccessEntry
+          #   or a Hash object. Required
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   other_dataset = bigquery.dataset "my_other_dataset", skip_lookup: true
+          #
+          #   params = {
+          #     dataset_id: other_dataset.dataset_id,
+          #     project_id: other_dataset.project_id,
+          #     target_types: ["VIEWS"]
+          #   }
+          #
+          #   dataset.access.reader_dataset? params
+          #
+          # @example
+          #   require "google/cloud/bigquery"
+          #
+          #   bigquery = Google::Cloud::Bigquery.new
+          #   dataset = bigquery.dataset "my_dataset"
+          #   other_dataset = bigquery.dataset "my_other_dataset", skip_lookup: true
+          #
+          #   dataset.access.reader_dataset? other_dataset.access_entry(target_types: ["VIEWS"])
+          #
+          def reader_dataset? dataset
+            lookup_access_dataset dataset
+          end
+
           ##
           # Checks writer access for a user.
           #
@@ -1184,6 +1296,18 @@ module Google
             end
           end
 
+          # @private
+          #
+          # Checks the type of user input and converts it to acceptable format.
+          #
+          def validate_dataset dataset
+            if dataset.is_a? Google::Apis::BigqueryV2::DatasetAccessEntry
+              dataset
+            else
+              Service.dataset_access_entry_from_hash dataset
+            end
+          end
+
           # @private
           def add_access_role_scope_value role, scope, value
             role = validate_role role
@@ -1218,6 +1342,17 @@ module Google
             @rules << Google::Apis::BigqueryV2::Dataset::Access.new(**opts)
           end
 
+          # @private
+          def add_access_dataset dataset
+            # scope is dataset, make sure value is in the right format
+            value = validate_dataset dataset
+            # Remove existing rule for input dataset, if any
+            @rules.reject!(&find_by_scope_and_resource_ref(:dataset, value))
+            # Add new rule for this role, scope, and value
+            opts = { dataset: value }
+            @rules << Google::Apis::BigqueryV2::Dataset::Access.new(**opts)
+          end
+
           # @private
           def remove_access_role_scope_value role, scope, value
             role = validate_role role
@@ -1244,6 +1379,14 @@ module Google
             @rules.reject!(&find_by_scope_and_resource_ref(:view, value))
           end
 
+          # @private
+          def remove_access_dataset dataset
+            # scope is dataset, make sure value is in the right format
+            value = validate_dataset dataset
+            # Remove existing rule for input dataset, if any
+            @rules.reject!(&find_by_scope_and_resource_ref(:dataset, value))
+          end
+
           # @private
           def lookup_access_role_scope_value role, scope, value
             role = validate_role role
@@ -1268,6 +1411,14 @@ module Google
             !(!@rules.detect(&find_by_scope_and_resource_ref(:view, value)))
           end
 
+          # @private
+          def lookup_access_dataset dataset
+            # scope is dataset, make sure value is in the right format
+            value = validate_dataset dataset
+            # Detect existing rule for input dataset, if any
+            !(!@rules.detect(&find_by_scope_and_resource_ref(:dataset, value)))
+          end
+
           # @private
           def find_by_role_and_scope_and_value role, scope, value
             lambda do |a|

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

@@ -0,0 +1,67 @@
+# Copyright 2022 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
+      class Dataset
+        ##
+        # A global tag managed by Resource Manager.
+        #
+        # @see https://cloud.google.com/iam/docs/tags-access-control#definitions
+        #
+        class Tag
+          ##
+          # @private The Google API Client object.
+          attr_accessor :gapi
+
+          ##
+          # @private Create an empty Tag object.
+          def initialize
+            @gapi = Google::Apis::BigqueryV2::Dataset::Tag.new
+          end
+
+          ##
+          # The namespaced friendly name of the tag key, e.g. "12345/environment" where
+          # 12345 is org id.
+          #
+          # @return [String]
+          #
+          def tag_key
+            @gapi.tag_key
+          end
+
+          ##
+          # The friendly short name of the tag value, e.g. "production".
+          #
+          # @return [String]
+          #
+          def tag_value
+            @gapi.tag_value
+          end
+
+          ##
+          # @private Google API Client object.
+          def self.from_gapi gapi
+            new_tag = new
+            new_tag.instance_variable_set :@gapi, gapi
+            new_tag
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -22,6 +22,7 @@ require "google/cloud/bigquery/routine"
 require "google/cloud/bigquery/external"
 require "google/cloud/bigquery/dataset/list"
 require "google/cloud/bigquery/dataset/access"
+require "google/cloud/bigquery/dataset/tag"
 require "google/cloud/bigquery/convert"
 require "google/apis/bigquery_v2"
 
@@ -466,6 +467,21 @@ module Google
           access_builder.freeze
         end
 
+        ##
+        # Retrieves the tags associated with this dataset. Tag keys are
+        # globally unique, and managed via the resource manager API.
+        #
+        # @see https://cloud.google.com/resource-manager/docs/tags/tags-overview
+        # for more information.
+        #
+        # @return [Google::Cloud::Bigquery::Dataset::Tag] The list of tags.
+        #
+        def tags
+          ensure_full_data!
+          return nil if @gapi.tags.nil?
+          @gapi.tags.map { |gapi| Tag.from_gapi(gapi) }
+        end
+
         ##
         # Permanently deletes the dataset. The dataset must be empty before it
         # can be deleted unless the `force` option is set to `true`.
@@ -2741,6 +2757,29 @@ module Google
                              interval: interval, threads: threads, &block
         end
 
+        ##
+        # Build an object of type Google::Apis::BigqueryV2::DatasetAccessEntry from
+        # the self.
+        #
+        # @param [Array<String>] target_types The list of target types within the dataset.
+        #
+        # @return [Google::Apis::BigqueryV2::DatasetAccessEntry] Returns a DatasetAccessEntry object.
+        #
+        # @example
+        #   require "google/cloud/bigquery"
+        #
+        #   bigquery = Google::Cloud::Bigquery.new
+        #   dataset = bigquery.dataset "my_dataset"
+        #   dataset_access_entry = dataset.access_entry target_types: ["VIEWS"]
+        #
+        def build_access_entry target_types: nil
+          params = {
+            dataset: dataset_ref,
+            target_types: target_types
+          }.delete_if { |_, v| v.nil? }
+          Google::Apis::BigqueryV2::DatasetAccessEntry.new(**params)
+        end
+
         protected
 
         def insert_data_with_autocreate table_id, rows, skip_invalid: nil, ignore_unknown: nil, insert_ids: nil