google-cloud-data_catalog-v1 0.14.0 → 0.16.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|