google-cloud-data_catalog-v1 0.14.0 → 0.16.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/README.md +1 -1
- data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +288 -54
- data/lib/google/cloud/data_catalog/v1/data_catalog/operations.rb +768 -0
- data/lib/google/cloud/data_catalog/v1/data_catalog/rest/client.rb +228 -54
- data/lib/google/cloud/data_catalog/v1/data_catalog/rest/operations.rb +792 -0
- data/lib/google/cloud/data_catalog/v1/data_catalog/rest/service_stub.rb +120 -0
- data/lib/google/cloud/data_catalog/v1/data_catalog/rest.rb +1 -0
- data/lib/google/cloud/data_catalog/v1/data_catalog.rb +1 -0
- data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +6 -3
- data/lib/google/cloud/data_catalog/v1/policy_tag_manager/rest/client.rb +6 -3
- data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +6 -4
- data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/rest/client.rb +6 -4
- data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
- data/lib/google/cloud/datacatalog/v1/bigquery_pb.rb +24 -25
- data/lib/google/cloud/datacatalog/v1/common_pb.rb +26 -12
- data/lib/google/cloud/datacatalog/v1/data_source_pb.rb +24 -18
- data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +55 -263
- data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +33 -0
- data/lib/google/cloud/datacatalog/v1/dataplex_spec_pb.rb +25 -21
- data/lib/google/cloud/datacatalog/v1/dump_content_pb.rb +49 -0
- data/lib/google/cloud/datacatalog/v1/gcs_fileset_spec_pb.rb +25 -10
- data/lib/google/cloud/datacatalog/v1/physical_schema_pb.rb +24 -26
- data/lib/google/cloud/datacatalog/v1/policytagmanager_pb.rb +28 -66
- data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb +25 -43
- data/lib/google/cloud/datacatalog/v1/schema_pb.rb +27 -11
- data/lib/google/cloud/datacatalog/v1/search_pb.rb +25 -21
- data/lib/google/cloud/datacatalog/v1/table_spec_pb.rb +24 -26
- data/lib/google/cloud/datacatalog/v1/tags_pb.rb +25 -59
- data/lib/google/cloud/datacatalog/v1/timestamps_pb.rb +25 -6
- data/lib/google/cloud/datacatalog/v1/usage_pb.rb +26 -11
- data/proto_docs/google/api/client.rb +67 -4
- data/proto_docs/google/cloud/datacatalog/v1/common.rb +25 -0
- data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +367 -41
- data/proto_docs/google/cloud/datacatalog/v1/dump_content.rb +53 -0
- data/proto_docs/google/cloud/datacatalog/v1/gcs_fileset_spec.rb +2 -1
- data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +23 -2
- data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb +6 -3
- data/proto_docs/google/cloud/datacatalog/v1/schema.rb +68 -3
- data/proto_docs/google/cloud/datacatalog/v1/search.rb +2 -2
- data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb +5 -5
- data/proto_docs/google/cloud/datacatalog/v1/tags.rb +11 -8
- data/proto_docs/google/cloud/datacatalog/v1/usage.rb +30 -1
- data/proto_docs/google/longrunning/operations.rb +164 -0
- data/proto_docs/google/protobuf/any.rb +144 -0
- data/proto_docs/google/protobuf/timestamp.rb +1 -3
- data/proto_docs/google/rpc/status.rb +48 -0
- metadata +11 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 287a106028e030737475116a68767810728bbe6300dcd308072e53eef227495e
|
4
|
+
data.tar.gz: 3ff5fb58112bfb569cdef3307029a14e7f7d0f1de030cf03ccde349352d039a3
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 95d4feec2aeb82509fb40dd46b2e1fcc5057f566fdfbd0a0c1038fb5bc7ac11abdb2f8c3cdd1c2c32edd0d10fc29ec9dbdf61efb21c60a5dada00f999fbcb379
|
7
|
+
data.tar.gz: e8c76153b2b5814d3f1243eff17e20462ab6166706d077499514315ee7dc07be0311ac9ddb30b928a41546db9313112bf96bf052bba70e95b0af213df887a843
|
data/README.md
CHANGED
@@ -47,7 +47,7 @@ for general usage information.
|
|
47
47
|
|
48
48
|
To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.
|
49
49
|
The logger that you set may be a Ruby stdlib [`Logger`](https://ruby-doc.org/current/stdlibs/logger/Logger.html) as shown below,
|
50
|
-
or a [`Google::Cloud::Logging::Logger`](https://
|
50
|
+
or a [`Google::Cloud::Logging::Logger`](https://cloud.google.com/ruby/docs/reference/google-cloud-logging/latest)
|
51
51
|
that will write logs to [Cloud Logging](https://cloud.google.com/logging/). See [grpc/logconfig.rb](https://github.com/grpc/grpc/blob/master/src/ruby/lib/grpc/logconfig.rb)
|
52
52
|
and the gRPC [spec_helper.rb](https://github.com/grpc/grpc/blob/master/src/ruby/spec/spec_helper.rb) for additional information.
|
53
53
|
|
@@ -67,45 +67,8 @@ module Google
|
|
67
67
|
default_config = Client::Configuration.new parent_config
|
68
68
|
|
69
69
|
default_config.timeout = 60.0
|
70
|
-
|
71
|
-
|
72
|
-
default_config.rpcs.search_catalog.retry_policy = {
|
73
|
-
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
74
|
-
}
|
75
|
-
|
76
|
-
default_config.rpcs.get_entry_group.timeout = 60.0
|
77
|
-
default_config.rpcs.get_entry_group.retry_policy = {
|
78
|
-
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
79
|
-
}
|
80
|
-
|
81
|
-
default_config.rpcs.list_entry_groups.timeout = 60.0
|
82
|
-
default_config.rpcs.list_entry_groups.retry_policy = {
|
83
|
-
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
84
|
-
}
|
85
|
-
|
86
|
-
default_config.rpcs.get_entry.timeout = 60.0
|
87
|
-
default_config.rpcs.get_entry.retry_policy = {
|
88
|
-
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
89
|
-
}
|
90
|
-
|
91
|
-
default_config.rpcs.lookup_entry.timeout = 60.0
|
92
|
-
default_config.rpcs.lookup_entry.retry_policy = {
|
93
|
-
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
94
|
-
}
|
95
|
-
|
96
|
-
default_config.rpcs.list_entries.timeout = 60.0
|
97
|
-
default_config.rpcs.list_entries.retry_policy = {
|
98
|
-
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
99
|
-
}
|
100
|
-
|
101
|
-
default_config.rpcs.list_tags.timeout = 60.0
|
102
|
-
default_config.rpcs.list_tags.retry_policy = {
|
103
|
-
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
104
|
-
}
|
105
|
-
|
106
|
-
default_config.rpcs.get_iam_policy.timeout = 60.0
|
107
|
-
default_config.rpcs.get_iam_policy.retry_policy = {
|
108
|
-
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
70
|
+
default_config.retry_policy = {
|
71
|
+
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14, 8, 13]
|
109
72
|
}
|
110
73
|
|
111
74
|
default_config
|
@@ -177,6 +140,12 @@ module Google
|
|
177
140
|
@quota_project_id = @config.quota_project
|
178
141
|
@quota_project_id ||= credentials.quota_project_id if credentials.respond_to? :quota_project_id
|
179
142
|
|
143
|
+
@operations_client = Operations.new do |config|
|
144
|
+
config.credentials = credentials
|
145
|
+
config.quota_project = @quota_project_id
|
146
|
+
config.endpoint = @config.endpoint
|
147
|
+
end
|
148
|
+
|
180
149
|
@iam_policy_client = Google::Iam::V1::IAMPolicy::Client.new do |config|
|
181
150
|
config.credentials = credentials
|
182
151
|
config.quota_project = @quota_project_id
|
@@ -192,6 +161,13 @@ module Google
|
|
192
161
|
)
|
193
162
|
end
|
194
163
|
|
164
|
+
##
|
165
|
+
# Get the associated client for long-running operations.
|
166
|
+
#
|
167
|
+
# @return [::Google::Cloud::DataCatalog::V1::DataCatalog::Operations]
|
168
|
+
#
|
169
|
+
attr_reader :operations_client
|
170
|
+
|
195
171
|
##
|
196
172
|
# Get the associated client for mix-in of the IAMPolicy.
|
197
173
|
#
|
@@ -240,9 +216,8 @@ module Google
|
|
240
216
|
# empty AND `include_gcp_public_datasets` is set to `false`. In this case,
|
241
217
|
# the request returns an error.
|
242
218
|
# @param query [::String]
|
243
|
-
# Optional. The query string with a minimum of 3 characters and specific
|
244
|
-
# For more information, see
|
245
|
-
# [Data Catalog search
|
219
|
+
# Optional. The query string with a minimum of 3 characters and specific
|
220
|
+
# syntax. For more information, see [Data Catalog search
|
246
221
|
# syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference).
|
247
222
|
#
|
248
223
|
# An empty query string returns all data assets (in the specified scope)
|
@@ -260,10 +235,11 @@ module Google
|
|
260
235
|
# The maximum number is 1000. If exceeded, throws an "invalid argument"
|
261
236
|
# exception.
|
262
237
|
# @param page_token [::String]
|
263
|
-
# Optional. Pagination token that, if specified, returns the next page of
|
264
|
-
# results. If empty, returns the first page.
|
238
|
+
# Optional. Pagination token that, if specified, returns the next page of
|
239
|
+
# search results. If empty, returns the first page.
|
265
240
|
#
|
266
|
-
# This token is returned in the
|
241
|
+
# This token is returned in the
|
242
|
+
# {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}
|
267
243
|
# field of the response to a previous
|
268
244
|
# {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#search_catalog SearchCatalogRequest}
|
269
245
|
# call.
|
@@ -384,7 +360,8 @@ module Google
|
|
384
360
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
385
361
|
#
|
386
362
|
# @param parent [::String]
|
387
|
-
# Required. The names of the project and location that the new entry group
|
363
|
+
# Required. The names of the project and location that the new entry group
|
364
|
+
# belongs to.
|
388
365
|
#
|
389
366
|
# Note: The entry group itself and its child resources might not be
|
390
367
|
# stored in the location specified in its name.
|
@@ -1256,7 +1233,7 @@ module Google
|
|
1256
1233
|
# @param options [::Gapic::CallOptions, ::Hash]
|
1257
1234
|
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
1258
1235
|
#
|
1259
|
-
# @overload lookup_entry(linked_resource: nil, sql_resource: nil, fully_qualified_name: nil)
|
1236
|
+
# @overload lookup_entry(linked_resource: nil, sql_resource: nil, fully_qualified_name: nil, project: nil, location: nil)
|
1260
1237
|
# Pass arguments to `lookup_entry` via keyword arguments. Note that at
|
1261
1238
|
# least one keyword argument is required. To specify no parameters, or to keep all
|
1262
1239
|
# the default parameter values, pass an empty Hash as a request object (see above).
|
@@ -1285,7 +1262,9 @@ module Google
|
|
1285
1262
|
# [Lexical structure in Standard SQL]
|
1286
1263
|
# (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical).
|
1287
1264
|
# @param fully_qualified_name [::String]
|
1288
|
-
# Fully
|
1265
|
+
# [Fully Qualified Name
|
1266
|
+
# (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names)
|
1267
|
+
# of the resource.
|
1289
1268
|
#
|
1290
1269
|
# FQNs take two forms:
|
1291
1270
|
#
|
@@ -1300,6 +1279,14 @@ module Google
|
|
1300
1279
|
# Example for a DPMS table:
|
1301
1280
|
#
|
1302
1281
|
# `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
|
1282
|
+
# @param project [::String]
|
1283
|
+
# Project where the lookup should be performed. Required to lookup
|
1284
|
+
# entry that is not a part of `DPMS` or `DATAPLEX` `integrated_system`
|
1285
|
+
# using its `fully_qualified_name`. Ignored in other cases.
|
1286
|
+
# @param location [::String]
|
1287
|
+
# Location where the lookup should be performed. Required to lookup
|
1288
|
+
# entry that is not a part of `DPMS` or `DATAPLEX` `integrated_system`
|
1289
|
+
# using its `fully_qualified_name`. Ignored in other cases.
|
1303
1290
|
#
|
1304
1291
|
# @yield [response, operation] Access the result along with the RPC operation
|
1305
1292
|
# @yieldparam response [::Google::Cloud::DataCatalog::V1::Entry]
|
@@ -2158,8 +2145,8 @@ module Google
|
|
2158
2145
|
# @param tag_template_field [::Google::Cloud::DataCatalog::V1::TagTemplateField, ::Hash]
|
2159
2146
|
# Required. The template to update.
|
2160
2147
|
# @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
|
2161
|
-
# Optional. Names of fields whose values to overwrite on an individual field
|
2162
|
-
# template. The following fields are modifiable:
|
2148
|
+
# Optional. Names of fields whose values to overwrite on an individual field
|
2149
|
+
# of a tag template. The following fields are modifiable:
|
2163
2150
|
#
|
2164
2151
|
# * `display_name`
|
2165
2152
|
# * `type.enum_type`
|
@@ -2264,7 +2251,8 @@ module Google
|
|
2264
2251
|
# @param name [::String]
|
2265
2252
|
# Required. The name of the tag template field.
|
2266
2253
|
# @param new_tag_template_field_id [::String]
|
2267
|
-
# Required. The new ID of this tag template field. For example,
|
2254
|
+
# Required. The new ID of this tag template field. For example,
|
2255
|
+
# `my_new_field`.
|
2268
2256
|
#
|
2269
2257
|
# @yield [response, operation] Access the result along with the RPC operation
|
2270
2258
|
# @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplateField]
|
@@ -2353,7 +2341,8 @@ module Google
|
|
2353
2341
|
# @param name [::String]
|
2354
2342
|
# Required. The name of the enum field value.
|
2355
2343
|
# @param new_enum_value_display_name [::String]
|
2356
|
-
# Required. The new display name of the enum value. For example,
|
2344
|
+
# Required. The new display name of the enum value. For example,
|
2345
|
+
# `my_new_enum_value`.
|
2357
2346
|
#
|
2358
2347
|
# @yield [response, operation] Access the result along with the RPC operation
|
2359
2348
|
# @yieldparam response [::Google::Cloud::DataCatalog::V1::TagTemplateField]
|
@@ -2895,6 +2884,122 @@ module Google
|
|
2895
2884
|
raise ::Google::Cloud::Error.from_error(e)
|
2896
2885
|
end
|
2897
2886
|
|
2887
|
+
##
|
2888
|
+
# `ReconcileTags` creates or updates a list of tags on the entry.
|
2889
|
+
# If the
|
2890
|
+
# {::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest#force_delete_missing ReconcileTagsRequest.force_delete_missing}
|
2891
|
+
# parameter is set, the operation deletes tags not included in the input tag
|
2892
|
+
# list.
|
2893
|
+
#
|
2894
|
+
# `ReconcileTags` returns a [long-running operation]
|
2895
|
+
# [google.longrunning.Operation] resource that can be queried with
|
2896
|
+
# Operations.GetOperation
|
2897
|
+
# to return [ReconcileTagsMetadata]
|
2898
|
+
# [google.cloud.datacatalog.v1.ReconcileTagsMetadata] and
|
2899
|
+
# a [ReconcileTagsResponse]
|
2900
|
+
# [google.cloud.datacatalog.v1.ReconcileTagsResponse] message.
|
2901
|
+
#
|
2902
|
+
# @overload reconcile_tags(request, options = nil)
|
2903
|
+
# Pass arguments to `reconcile_tags` via a request object, either of type
|
2904
|
+
# {::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest} or an equivalent Hash.
|
2905
|
+
#
|
2906
|
+
# @param request [::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest, ::Hash]
|
2907
|
+
# A request object representing the call parameters. Required. To specify no
|
2908
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
2909
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
2910
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
2911
|
+
#
|
2912
|
+
# @overload reconcile_tags(parent: nil, tag_template: nil, force_delete_missing: nil, tags: nil)
|
2913
|
+
# Pass arguments to `reconcile_tags` via keyword arguments. Note that at
|
2914
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
2915
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
2916
|
+
#
|
2917
|
+
# @param parent [::String]
|
2918
|
+
# Required. Name of {::Google::Cloud::DataCatalog::V1::Entry Entry} to be tagged.
|
2919
|
+
# @param tag_template [::String]
|
2920
|
+
# Required. The name of the tag template, which is used for reconciliation.
|
2921
|
+
# @param force_delete_missing [::Boolean]
|
2922
|
+
# If set to `true`, deletes entry tags related to a tag template
|
2923
|
+
# not listed in the tags source from an entry. If set to `false`,
|
2924
|
+
# unlisted tags are retained.
|
2925
|
+
# @param tags [::Array<::Google::Cloud::DataCatalog::V1::Tag, ::Hash>]
|
2926
|
+
# A list of tags to apply to an entry. A tag can specify a
|
2927
|
+
# tag template, which must be the template specified in the
|
2928
|
+
# `ReconcileTagsRequest`.
|
2929
|
+
# The sole entry and each of its columns must be mentioned at most once.
|
2930
|
+
#
|
2931
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
2932
|
+
# @yieldparam response [::Gapic::Operation]
|
2933
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
2934
|
+
#
|
2935
|
+
# @return [::Gapic::Operation]
|
2936
|
+
#
|
2937
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
2938
|
+
#
|
2939
|
+
# @example Basic example
|
2940
|
+
# require "google/cloud/data_catalog/v1"
|
2941
|
+
#
|
2942
|
+
# # Create a client object. The client can be reused for multiple calls.
|
2943
|
+
# client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
|
2944
|
+
#
|
2945
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
2946
|
+
# request = Google::Cloud::DataCatalog::V1::ReconcileTagsRequest.new
|
2947
|
+
#
|
2948
|
+
# # Call the reconcile_tags method.
|
2949
|
+
# result = client.reconcile_tags request
|
2950
|
+
#
|
2951
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
2952
|
+
# # check the status of an operation, cancel it, or wait for results.
|
2953
|
+
# # Here is how to wait for a response.
|
2954
|
+
# result.wait_until_done! timeout: 60
|
2955
|
+
# if result.response?
|
2956
|
+
# p result.response
|
2957
|
+
# else
|
2958
|
+
# puts "No response received."
|
2959
|
+
# end
|
2960
|
+
#
|
2961
|
+
def reconcile_tags request, options = nil
|
2962
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
2963
|
+
|
2964
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ReconcileTagsRequest
|
2965
|
+
|
2966
|
+
# Converts hash and nil to an options object
|
2967
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
2968
|
+
|
2969
|
+
# Customize the options with defaults
|
2970
|
+
metadata = @config.rpcs.reconcile_tags.metadata.to_h
|
2971
|
+
|
2972
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
2973
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
2974
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
2975
|
+
gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
|
2976
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
2977
|
+
|
2978
|
+
header_params = {}
|
2979
|
+
if request.parent
|
2980
|
+
header_params["parent"] = request.parent
|
2981
|
+
end
|
2982
|
+
|
2983
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
2984
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
2985
|
+
|
2986
|
+
options.apply_defaults timeout: @config.rpcs.reconcile_tags.timeout,
|
2987
|
+
metadata: metadata,
|
2988
|
+
retry_policy: @config.rpcs.reconcile_tags.retry_policy
|
2989
|
+
|
2990
|
+
options.apply_defaults timeout: @config.timeout,
|
2991
|
+
metadata: @config.metadata,
|
2992
|
+
retry_policy: @config.retry_policy
|
2993
|
+
|
2994
|
+
@data_catalog_stub.call_rpc :reconcile_tags, request, options: options do |response, operation|
|
2995
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
2996
|
+
yield response, operation if block_given?
|
2997
|
+
return response
|
2998
|
+
end
|
2999
|
+
rescue ::GRPC::BadStatus => e
|
3000
|
+
raise ::Google::Cloud::Error.from_error(e)
|
3001
|
+
end
|
3002
|
+
|
2898
3003
|
##
|
2899
3004
|
# Marks an {::Google::Cloud::DataCatalog::V1::Entry Entry} as starred by
|
2900
3005
|
# the current user. Starring information is private to each user.
|
@@ -3393,6 +3498,121 @@ module Google
|
|
3393
3498
|
raise ::Google::Cloud::Error.from_error(e)
|
3394
3499
|
end
|
3395
3500
|
|
3501
|
+
##
|
3502
|
+
# Imports entries from a source, such as data previously dumped into a
|
3503
|
+
# Cloud Storage bucket, into Data Catalog. Import of entries
|
3504
|
+
# is a sync operation that reconciles the state of the third-party system
|
3505
|
+
# with the Data Catalog.
|
3506
|
+
#
|
3507
|
+
# `ImportEntries` accepts source data snapshots of a third-party system.
|
3508
|
+
# Snapshot should be delivered as a .wire or base65-encoded .txt file
|
3509
|
+
# containing a sequence of Protocol Buffer messages of
|
3510
|
+
# {::Google::Cloud::DataCatalog::V1::DumpItem DumpItem} type.
|
3511
|
+
#
|
3512
|
+
# `ImportEntries` returns a [long-running operation]
|
3513
|
+
# [google.longrunning.Operation] resource that can be queried with
|
3514
|
+
# Operations.GetOperation
|
3515
|
+
# to return
|
3516
|
+
# {::Google::Cloud::DataCatalog::V1::ImportEntriesMetadata ImportEntriesMetadata}
|
3517
|
+
# and an
|
3518
|
+
# {::Google::Cloud::DataCatalog::V1::ImportEntriesResponse ImportEntriesResponse}
|
3519
|
+
# message.
|
3520
|
+
#
|
3521
|
+
# @overload import_entries(request, options = nil)
|
3522
|
+
# Pass arguments to `import_entries` via a request object, either of type
|
3523
|
+
# {::Google::Cloud::DataCatalog::V1::ImportEntriesRequest} or an equivalent Hash.
|
3524
|
+
#
|
3525
|
+
# @param request [::Google::Cloud::DataCatalog::V1::ImportEntriesRequest, ::Hash]
|
3526
|
+
# A request object representing the call parameters. Required. To specify no
|
3527
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
3528
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
3529
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
3530
|
+
#
|
3531
|
+
# @overload import_entries(parent: nil, gcs_bucket_path: nil, job_id: nil)
|
3532
|
+
# Pass arguments to `import_entries` via keyword arguments. Note that at
|
3533
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
3534
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
3535
|
+
#
|
3536
|
+
# @param parent [::String]
|
3537
|
+
# Required. Target entry group for ingested entries.
|
3538
|
+
# @param gcs_bucket_path [::String]
|
3539
|
+
# Path to a Cloud Storage bucket that contains a dump ready for ingestion.
|
3540
|
+
# @param job_id [::String]
|
3541
|
+
# Optional. (Optional) Dataplex task job id, if specified will be used as
|
3542
|
+
# part of ImportEntries LRO ID
|
3543
|
+
#
|
3544
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
3545
|
+
# @yieldparam response [::Gapic::Operation]
|
3546
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
3547
|
+
#
|
3548
|
+
# @return [::Gapic::Operation]
|
3549
|
+
#
|
3550
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
3551
|
+
#
|
3552
|
+
# @example Basic example
|
3553
|
+
# require "google/cloud/data_catalog/v1"
|
3554
|
+
#
|
3555
|
+
# # Create a client object. The client can be reused for multiple calls.
|
3556
|
+
# client = Google::Cloud::DataCatalog::V1::DataCatalog::Client.new
|
3557
|
+
#
|
3558
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
3559
|
+
# request = Google::Cloud::DataCatalog::V1::ImportEntriesRequest.new
|
3560
|
+
#
|
3561
|
+
# # Call the import_entries method.
|
3562
|
+
# result = client.import_entries request
|
3563
|
+
#
|
3564
|
+
# # The returned object is of type Gapic::Operation. You can use it to
|
3565
|
+
# # check the status of an operation, cancel it, or wait for results.
|
3566
|
+
# # Here is how to wait for a response.
|
3567
|
+
# result.wait_until_done! timeout: 60
|
3568
|
+
# if result.response?
|
3569
|
+
# p result.response
|
3570
|
+
# else
|
3571
|
+
# puts "No response received."
|
3572
|
+
# end
|
3573
|
+
#
|
3574
|
+
def import_entries request, options = nil
|
3575
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
3576
|
+
|
3577
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::DataCatalog::V1::ImportEntriesRequest
|
3578
|
+
|
3579
|
+
# Converts hash and nil to an options object
|
3580
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
3581
|
+
|
3582
|
+
# Customize the options with defaults
|
3583
|
+
metadata = @config.rpcs.import_entries.metadata.to_h
|
3584
|
+
|
3585
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
3586
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
3587
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
3588
|
+
gapic_version: ::Google::Cloud::DataCatalog::V1::VERSION
|
3589
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
3590
|
+
|
3591
|
+
header_params = {}
|
3592
|
+
if request.parent
|
3593
|
+
header_params["parent"] = request.parent
|
3594
|
+
end
|
3595
|
+
|
3596
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
3597
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
3598
|
+
|
3599
|
+
options.apply_defaults timeout: @config.rpcs.import_entries.timeout,
|
3600
|
+
metadata: metadata,
|
3601
|
+
retry_policy: @config.rpcs.import_entries.retry_policy
|
3602
|
+
|
3603
|
+
options.apply_defaults timeout: @config.timeout,
|
3604
|
+
metadata: @config.metadata,
|
3605
|
+
retry_policy: @config.retry_policy
|
3606
|
+
|
3607
|
+
@data_catalog_stub.call_rpc :import_entries, request, options: options do |response, operation|
|
3608
|
+
response = ::Gapic::Operation.new response, @operations_client, options: options
|
3609
|
+
yield response, operation if block_given?
|
3610
|
+
return response
|
3611
|
+
end
|
3612
|
+
rescue ::GRPC::BadStatus => e
|
3613
|
+
raise ::Google::Cloud::Error.from_error(e)
|
3614
|
+
end
|
3615
|
+
|
3396
3616
|
##
|
3397
3617
|
# Configuration class for the DataCatalog API.
|
3398
3618
|
#
|
@@ -3431,9 +3651,9 @@ module Google
|
|
3431
3651
|
# * (`String`) The path to a service account key file in JSON format
|
3432
3652
|
# * (`Hash`) A service account key as a Hash
|
3433
3653
|
# * (`Google::Auth::Credentials`) A googleauth credentials object
|
3434
|
-
# (see the [googleauth docs](https://
|
3654
|
+
# (see the [googleauth docs](https://rubydoc.info/gems/googleauth/Google/Auth/Credentials))
|
3435
3655
|
# * (`Signet::OAuth2::Client`) A signet oauth2 client object
|
3436
|
-
# (see the [signet docs](https://
|
3656
|
+
# (see the [signet docs](https://rubydoc.info/gems/signet/Signet/OAuth2/Client))
|
3437
3657
|
# * (`GRPC::Core::Channel`) a gRPC channel with included credentials
|
3438
3658
|
# * (`GRPC::Core::ChannelCredentials`) a gRPC credentails object
|
3439
3659
|
# * (`nil`) indicating no credentials
|
@@ -3664,6 +3884,11 @@ module Google
|
|
3664
3884
|
#
|
3665
3885
|
attr_reader :list_tags
|
3666
3886
|
##
|
3887
|
+
# RPC-specific configuration for `reconcile_tags`
|
3888
|
+
# @return [::Gapic::Config::Method]
|
3889
|
+
#
|
3890
|
+
attr_reader :reconcile_tags
|
3891
|
+
##
|
3667
3892
|
# RPC-specific configuration for `star_entry`
|
3668
3893
|
# @return [::Gapic::Config::Method]
|
3669
3894
|
#
|
@@ -3688,6 +3913,11 @@ module Google
|
|
3688
3913
|
# @return [::Gapic::Config::Method]
|
3689
3914
|
#
|
3690
3915
|
attr_reader :test_iam_permissions
|
3916
|
+
##
|
3917
|
+
# RPC-specific configuration for `import_entries`
|
3918
|
+
# @return [::Gapic::Config::Method]
|
3919
|
+
#
|
3920
|
+
attr_reader :import_entries
|
3691
3921
|
|
3692
3922
|
# @private
|
3693
3923
|
def initialize parent_rpcs = nil
|
@@ -3745,6 +3975,8 @@ module Google
|
|
3745
3975
|
@delete_tag = ::Gapic::Config::Method.new delete_tag_config
|
3746
3976
|
list_tags_config = parent_rpcs.list_tags if parent_rpcs.respond_to? :list_tags
|
3747
3977
|
@list_tags = ::Gapic::Config::Method.new list_tags_config
|
3978
|
+
reconcile_tags_config = parent_rpcs.reconcile_tags if parent_rpcs.respond_to? :reconcile_tags
|
3979
|
+
@reconcile_tags = ::Gapic::Config::Method.new reconcile_tags_config
|
3748
3980
|
star_entry_config = parent_rpcs.star_entry if parent_rpcs.respond_to? :star_entry
|
3749
3981
|
@star_entry = ::Gapic::Config::Method.new star_entry_config
|
3750
3982
|
unstar_entry_config = parent_rpcs.unstar_entry if parent_rpcs.respond_to? :unstar_entry
|
@@ -3755,6 +3987,8 @@ module Google
|
|
3755
3987
|
@get_iam_policy = ::Gapic::Config::Method.new get_iam_policy_config
|
3756
3988
|
test_iam_permissions_config = parent_rpcs.test_iam_permissions if parent_rpcs.respond_to? :test_iam_permissions
|
3757
3989
|
@test_iam_permissions = ::Gapic::Config::Method.new test_iam_permissions_config
|
3990
|
+
import_entries_config = parent_rpcs.import_entries if parent_rpcs.respond_to? :import_entries
|
3991
|
+
@import_entries = ::Gapic::Config::Method.new import_entries_config
|
3758
3992
|
|
3759
3993
|
yield self if block_given?
|
3760
3994
|
end
|