google-cloud-data_catalog-lineage-v1 0.a → 0.2.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/.yardopts +12 -0
- data/AUTHENTICATION.md +149 -0
- data/README.md +144 -8
- data/lib/google/cloud/data_catalog/lineage/v1/lineage/client.rb +1971 -0
- data/lib/google/cloud/data_catalog/lineage/v1/lineage/credentials.rb +49 -0
- data/lib/google/cloud/data_catalog/lineage/v1/lineage/operations.rb +770 -0
- data/lib/google/cloud/data_catalog/lineage/v1/lineage/paths.rb +115 -0
- data/lib/google/cloud/data_catalog/lineage/v1/lineage/rest/client.rb +1549 -0
- data/lib/google/cloud/data_catalog/lineage/v1/lineage/rest/operations.rb +795 -0
- data/lib/google/cloud/data_catalog/lineage/v1/lineage/rest/service_stub.rb +1001 -0
- data/lib/google/cloud/data_catalog/lineage/v1/lineage/rest.rb +58 -0
- data/lib/google/cloud/data_catalog/lineage/v1/lineage.rb +61 -0
- data/lib/google/cloud/data_catalog/lineage/v1/rest.rb +39 -0
- data/lib/google/cloud/data_catalog/lineage/v1/version.rb +7 -2
- data/lib/google/cloud/data_catalog/lineage/v1.rb +47 -0
- data/lib/google/cloud/datacatalog/lineage/v1/lineage_pb.rb +241 -0
- data/lib/google/cloud/datacatalog/lineage/v1/lineage_services_pb.rb +104 -0
- data/lib/google-cloud-data_catalog-lineage-v1.rb +21 -0
- data/proto_docs/README.md +4 -0
- data/proto_docs/google/api/client.rb +318 -0
- data/proto_docs/google/api/field_behavior.rb +71 -0
- data/proto_docs/google/api/launch_stage.rb +71 -0
- data/proto_docs/google/api/resource.rb +222 -0
- data/proto_docs/google/cloud/datacatalog/lineage/v1/lineage.rb +707 -0
- data/proto_docs/google/longrunning/operations.rb +164 -0
- data/proto_docs/google/protobuf/any.rb +141 -0
- data/proto_docs/google/protobuf/duration.rb +98 -0
- data/proto_docs/google/protobuf/empty.rb +34 -0
- data/proto_docs/google/protobuf/field_mask.rb +229 -0
- data/proto_docs/google/protobuf/struct.rb +96 -0
- data/proto_docs/google/protobuf/timestamp.rb +129 -0
- data/proto_docs/google/rpc/status.rb +48 -0
- metadata +192 -12
@@ -0,0 +1,707 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
3
|
+
# Copyright 2023 Google LLC
|
4
|
+
#
|
5
|
+
# Licensed under the Apache License, Version 2.0 (the "License");
|
6
|
+
# you may not use this file except in compliance with the License.
|
7
|
+
# You may obtain a copy of the License at
|
8
|
+
#
|
9
|
+
# https://www.apache.org/licenses/LICENSE-2.0
|
10
|
+
#
|
11
|
+
# Unless required by applicable law or agreed to in writing, software
|
12
|
+
# distributed under the License is distributed on an "AS IS" BASIS,
|
13
|
+
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
14
|
+
# See the License for the specific language governing permissions and
|
15
|
+
# limitations under the License.
|
16
|
+
|
17
|
+
# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
|
18
|
+
|
19
|
+
|
20
|
+
module Google
|
21
|
+
module Cloud
|
22
|
+
module DataCatalog
|
23
|
+
module Lineage
|
24
|
+
module V1
|
25
|
+
# A process is the definition of a data transformation operation.
|
26
|
+
# @!attribute [rw] name
|
27
|
+
# @return [::String]
|
28
|
+
# Immutable. The resource name of the lineage process. Format:
|
29
|
+
# `projects/{project}/locations/{location}/processes/{process}`.
|
30
|
+
# Can be specified or auto-assigned.
|
31
|
+
# \\{process} must be not longer than 200 characters and only
|
32
|
+
# contain characters in a set: `a-zA-Z0-9_-:.`
|
33
|
+
# @!attribute [rw] display_name
|
34
|
+
# @return [::String]
|
35
|
+
# Optional. A human-readable name you can set to display in a user interface.
|
36
|
+
# Must be not longer than 200 characters and only contain UTF-8 letters
|
37
|
+
# or numbers, spaces or characters like `_-:&.`
|
38
|
+
# @!attribute [rw] attributes
|
39
|
+
# @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
|
40
|
+
# Optional. The attributes of the process. Can be anything, for example,
|
41
|
+
# "author". Up to 100 attributes are allowed.
|
42
|
+
# @!attribute [rw] origin
|
43
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::Origin]
|
44
|
+
# Optional. The origin of this process and its runs and lineage events.
|
45
|
+
class Process
|
46
|
+
include ::Google::Protobuf::MessageExts
|
47
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
48
|
+
|
49
|
+
# @!attribute [rw] key
|
50
|
+
# @return [::String]
|
51
|
+
# @!attribute [rw] value
|
52
|
+
# @return [::Google::Protobuf::Value]
|
53
|
+
class AttributesEntry
|
54
|
+
include ::Google::Protobuf::MessageExts
|
55
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
56
|
+
end
|
57
|
+
end
|
58
|
+
|
59
|
+
# A lineage run represents an execution of a process that creates
|
60
|
+
# lineage events.
|
61
|
+
# @!attribute [rw] name
|
62
|
+
# @return [::String]
|
63
|
+
# Immutable. The resource name of the run. Format:
|
64
|
+
# `projects/{project}/locations/{location}/processes/{process}/runs/{run}`.
|
65
|
+
# Can be specified or auto-assigned.
|
66
|
+
# \\{run} must be not longer than 200 characters and only
|
67
|
+
# contain characters in a set: `a-zA-Z0-9_-:.`
|
68
|
+
# @!attribute [rw] display_name
|
69
|
+
# @return [::String]
|
70
|
+
# Optional. A human-readable name you can set to display in a user interface.
|
71
|
+
# Must be not longer than 1024 characters and only contain UTF-8 letters
|
72
|
+
# or numbers, spaces or characters like `_-:&.`
|
73
|
+
# @!attribute [rw] attributes
|
74
|
+
# @return [::Google::Protobuf::Map{::String => ::Google::Protobuf::Value}]
|
75
|
+
# Optional. The attributes of the run. Can be anything, for example, a string
|
76
|
+
# with an SQL request. Up to 100 attributes are allowed.
|
77
|
+
# @!attribute [rw] start_time
|
78
|
+
# @return [::Google::Protobuf::Timestamp]
|
79
|
+
# Required. The timestamp of the start of the run.
|
80
|
+
# @!attribute [rw] end_time
|
81
|
+
# @return [::Google::Protobuf::Timestamp]
|
82
|
+
# Optional. The timestamp of the end of the run.
|
83
|
+
# @!attribute [rw] state
|
84
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::Run::State]
|
85
|
+
# Required. The state of the run.
|
86
|
+
class Run
|
87
|
+
include ::Google::Protobuf::MessageExts
|
88
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
89
|
+
|
90
|
+
# @!attribute [rw] key
|
91
|
+
# @return [::String]
|
92
|
+
# @!attribute [rw] value
|
93
|
+
# @return [::Google::Protobuf::Value]
|
94
|
+
class AttributesEntry
|
95
|
+
include ::Google::Protobuf::MessageExts
|
96
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
97
|
+
end
|
98
|
+
|
99
|
+
# The current state of the run.
|
100
|
+
module State
|
101
|
+
# The state is unknown. The true state may be any of the below or a
|
102
|
+
# different state that is not supported here explicitly.
|
103
|
+
UNKNOWN = 0
|
104
|
+
|
105
|
+
# The run is still executing.
|
106
|
+
STARTED = 1
|
107
|
+
|
108
|
+
# The run completed.
|
109
|
+
COMPLETED = 2
|
110
|
+
|
111
|
+
# The run failed.
|
112
|
+
FAILED = 3
|
113
|
+
|
114
|
+
# The run aborted.
|
115
|
+
ABORTED = 4
|
116
|
+
end
|
117
|
+
end
|
118
|
+
|
119
|
+
# A lineage event represents an operation on assets. Within the operation, the
|
120
|
+
# data flows from the source to the target defined in the links field.
|
121
|
+
# @!attribute [rw] name
|
122
|
+
# @return [::String]
|
123
|
+
# Immutable. The resource name of the lineage event.
|
124
|
+
# Format:
|
125
|
+
# `projects/{project}/locations/{location}/processes/{process}/runs/{run}/lineageEvents/{lineage_event}`.
|
126
|
+
# Can be specified or auto-assigned.
|
127
|
+
# \\{lineage_event} must be not longer than 200 characters and only
|
128
|
+
# contain characters in a set: `a-zA-Z0-9_-:.`
|
129
|
+
# @!attribute [rw] links
|
130
|
+
# @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::EventLink>]
|
131
|
+
# Optional. List of source-target pairs. Can't contain more than 100 tuples.
|
132
|
+
# @!attribute [rw] start_time
|
133
|
+
# @return [::Google::Protobuf::Timestamp]
|
134
|
+
# Optional. The beginning of the transformation which resulted in this
|
135
|
+
# lineage event. For streaming scenarios, it should be the beginning of the
|
136
|
+
# period from which the lineage is being reported.
|
137
|
+
# @!attribute [rw] end_time
|
138
|
+
# @return [::Google::Protobuf::Timestamp]
|
139
|
+
# Optional. The end of the transformation which resulted in this lineage
|
140
|
+
# event. For streaming scenarios, it should be the end of the period from
|
141
|
+
# which the lineage is being reported.
|
142
|
+
class LineageEvent
|
143
|
+
include ::Google::Protobuf::MessageExts
|
144
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
145
|
+
end
|
146
|
+
|
147
|
+
# A lineage between source and target entities.
|
148
|
+
# @!attribute [rw] source
|
149
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
|
150
|
+
# Required. Reference to the source entity
|
151
|
+
# @!attribute [rw] target
|
152
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
|
153
|
+
# Required. Reference to the target entity
|
154
|
+
class EventLink
|
155
|
+
include ::Google::Protobuf::MessageExts
|
156
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
157
|
+
end
|
158
|
+
|
159
|
+
# The soft reference to everything you can attach a lineage event to.
|
160
|
+
# @!attribute [rw] fully_qualified_name
|
161
|
+
# @return [::String]
|
162
|
+
# Required. Fully Qualified Name of the entity. Useful for referencing
|
163
|
+
# entities that aren't represented as GCP resources, for example, tables in
|
164
|
+
# Dataproc Metastore API.
|
165
|
+
#
|
166
|
+
# Examples:
|
167
|
+
#
|
168
|
+
# * `bigquery:dataset.project_id.dataset_id`
|
169
|
+
# * `bigquery:table.project_id.dataset_id.table_id`
|
170
|
+
# * `pubsub:project_id.topic_id`
|
171
|
+
# * `dataproc_metastore:projectId.locationId.instanceId.databaseId.tableId`
|
172
|
+
class EntityReference
|
173
|
+
include ::Google::Protobuf::MessageExts
|
174
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
175
|
+
end
|
176
|
+
|
177
|
+
# Metadata describing the operation.
|
178
|
+
# @!attribute [r] state
|
179
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::OperationMetadata::State]
|
180
|
+
# Output only. The current operation state.
|
181
|
+
# @!attribute [r] operation_type
|
182
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::OperationMetadata::Type]
|
183
|
+
# Output only. The type of the operation being performed.
|
184
|
+
# @!attribute [r] resource
|
185
|
+
# @return [::String]
|
186
|
+
# Output only. The [relative name]
|
187
|
+
# (https://cloud.google.com//apis/design/resource_names#relative_resource_name)
|
188
|
+
# of the resource being operated on.
|
189
|
+
# @!attribute [r] resource_uuid
|
190
|
+
# @return [::String]
|
191
|
+
# Output only. The UUID of the resource being operated on.
|
192
|
+
# @!attribute [r] create_time
|
193
|
+
# @return [::Google::Protobuf::Timestamp]
|
194
|
+
# Output only. The timestamp of the operation submission to the server.
|
195
|
+
# @!attribute [r] end_time
|
196
|
+
# @return [::Google::Protobuf::Timestamp]
|
197
|
+
# Output only. The timestamp of the operation termination, regardless of its
|
198
|
+
# success. This field is unset if the operation is still ongoing.
|
199
|
+
class OperationMetadata
|
200
|
+
include ::Google::Protobuf::MessageExts
|
201
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
202
|
+
|
203
|
+
# An enum with the state of the operation.
|
204
|
+
module State
|
205
|
+
# Unused.
|
206
|
+
STATE_UNSPECIFIED = 0
|
207
|
+
|
208
|
+
# The operation has been created but is not yet started.
|
209
|
+
PENDING = 1
|
210
|
+
|
211
|
+
# The operation is underway.
|
212
|
+
RUNNING = 2
|
213
|
+
|
214
|
+
# The operation completed successfully.
|
215
|
+
SUCCEEDED = 3
|
216
|
+
|
217
|
+
# The operation is no longer running and did not succeed.
|
218
|
+
FAILED = 4
|
219
|
+
end
|
220
|
+
|
221
|
+
# Type of the long running operation.
|
222
|
+
module Type
|
223
|
+
# Unused.
|
224
|
+
TYPE_UNSPECIFIED = 0
|
225
|
+
|
226
|
+
# The resource deletion operation.
|
227
|
+
DELETE = 1
|
228
|
+
end
|
229
|
+
end
|
230
|
+
|
231
|
+
# Request message for
|
232
|
+
# [CreateProcess][google.cloud.datacatalog.lineage.v1.CreateProcess].
|
233
|
+
# @!attribute [rw] parent
|
234
|
+
# @return [::String]
|
235
|
+
# Required. The name of the project and its location that should own the
|
236
|
+
# process.
|
237
|
+
# @!attribute [rw] process
|
238
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::Process]
|
239
|
+
# Required. The process to create.
|
240
|
+
# @!attribute [rw] request_id
|
241
|
+
# @return [::String]
|
242
|
+
# A unique identifier for this request. Restricted to 36 ASCII characters.
|
243
|
+
# A random UUID is recommended. This request is idempotent only if a
|
244
|
+
# `request_id` is provided.
|
245
|
+
class CreateProcessRequest
|
246
|
+
include ::Google::Protobuf::MessageExts
|
247
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
248
|
+
end
|
249
|
+
|
250
|
+
# Request message for
|
251
|
+
# [UpdateProcess][google.cloud.datacatalog.lineage.v1.UpdateProcess].
|
252
|
+
# @!attribute [rw] process
|
253
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::Process]
|
254
|
+
# Required. The lineage process to update.
|
255
|
+
#
|
256
|
+
# The process's `name` field is used to identify the process to update.
|
257
|
+
# @!attribute [rw] update_mask
|
258
|
+
# @return [::Google::Protobuf::FieldMask]
|
259
|
+
# The list of fields to update. Currently not used. The whole message is
|
260
|
+
# updated.
|
261
|
+
# @!attribute [rw] allow_missing
|
262
|
+
# @return [::Boolean]
|
263
|
+
# If set to true and the process is not found, the request inserts it.
|
264
|
+
class UpdateProcessRequest
|
265
|
+
include ::Google::Protobuf::MessageExts
|
266
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
267
|
+
end
|
268
|
+
|
269
|
+
# Request message for
|
270
|
+
# [GetProcess][google.cloud.datacatalog.lineage.v1.GetProcess].
|
271
|
+
# @!attribute [rw] name
|
272
|
+
# @return [::String]
|
273
|
+
# Required. The name of the process to get.
|
274
|
+
class GetProcessRequest
|
275
|
+
include ::Google::Protobuf::MessageExts
|
276
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
277
|
+
end
|
278
|
+
|
279
|
+
# Request message for
|
280
|
+
# [ListProcesses][google.cloud.datacatalog.lineage.v1.ListProcesses].
|
281
|
+
# @!attribute [rw] parent
|
282
|
+
# @return [::String]
|
283
|
+
# Required. The name of the project and its location that owns this
|
284
|
+
# collection of processes.
|
285
|
+
# @!attribute [rw] page_size
|
286
|
+
# @return [::Integer]
|
287
|
+
# The maximum number of processes to return. The service may return
|
288
|
+
# fewer than this value. If unspecified, at most 50 processes are
|
289
|
+
# returned. The maximum value is 100; values greater than 100 are cut to
|
290
|
+
# 100.
|
291
|
+
# @!attribute [rw] page_token
|
292
|
+
# @return [::String]
|
293
|
+
# The page token received from a previous `ListProcesses` call. Specify
|
294
|
+
# it to get the next page.
|
295
|
+
#
|
296
|
+
# When paginating, all other parameters specified in this call must
|
297
|
+
# match the parameters of the call that provided the page token.
|
298
|
+
class ListProcessesRequest
|
299
|
+
include ::Google::Protobuf::MessageExts
|
300
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
301
|
+
end
|
302
|
+
|
303
|
+
# Response message for
|
304
|
+
# [ListProcesses][google.cloud.datacatalog.lineage.v1.ListProcesses].
|
305
|
+
# @!attribute [rw] processes
|
306
|
+
# @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::Process>]
|
307
|
+
# The processes from the specified project and location.
|
308
|
+
# @!attribute [rw] next_page_token
|
309
|
+
# @return [::String]
|
310
|
+
# The token to specify as `page_token` in the next call to get the next page.
|
311
|
+
# If this field is omitted, there are no subsequent pages.
|
312
|
+
class ListProcessesResponse
|
313
|
+
include ::Google::Protobuf::MessageExts
|
314
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
315
|
+
end
|
316
|
+
|
317
|
+
# Request message for
|
318
|
+
# [DeleteProcess][google.cloud.datacatalog.lineage.v1.DeleteProcess].
|
319
|
+
# @!attribute [rw] name
|
320
|
+
# @return [::String]
|
321
|
+
# Required. The name of the process to delete.
|
322
|
+
# @!attribute [rw] allow_missing
|
323
|
+
# @return [::Boolean]
|
324
|
+
# If set to true and the process is not found, the request
|
325
|
+
# succeeds but the server doesn't perform any actions.
|
326
|
+
class DeleteProcessRequest
|
327
|
+
include ::Google::Protobuf::MessageExts
|
328
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
329
|
+
end
|
330
|
+
|
331
|
+
# Request message for
|
332
|
+
# [CreateRun][google.cloud.datacatalog.lineage.v1.CreateRun].
|
333
|
+
# @!attribute [rw] parent
|
334
|
+
# @return [::String]
|
335
|
+
# Required. The name of the process that should own the run.
|
336
|
+
# @!attribute [rw] run
|
337
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::Run]
|
338
|
+
# Required. The run to create.
|
339
|
+
# @!attribute [rw] request_id
|
340
|
+
# @return [::String]
|
341
|
+
# A unique identifier for this request. Restricted to 36 ASCII characters.
|
342
|
+
# A random UUID is recommended. This request is idempotent only if a
|
343
|
+
# `request_id` is provided.
|
344
|
+
class CreateRunRequest
|
345
|
+
include ::Google::Protobuf::MessageExts
|
346
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
347
|
+
end
|
348
|
+
|
349
|
+
# Request message for
|
350
|
+
# [UpdateRun][google.cloud.datacatalog.lineage.v1.UpdateRun].
|
351
|
+
# @!attribute [rw] run
|
352
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::Run]
|
353
|
+
# Required. The lineage run to update.
|
354
|
+
#
|
355
|
+
# The run's `name` field is used to identify the run to update.
|
356
|
+
#
|
357
|
+
# Format:
|
358
|
+
# `projects/{project}/locations/{location}/processes/{process}/runs/{run}`.
|
359
|
+
# @!attribute [rw] update_mask
|
360
|
+
# @return [::Google::Protobuf::FieldMask]
|
361
|
+
# The list of fields to update. Currently not used. The whole message is
|
362
|
+
# updated.
|
363
|
+
class UpdateRunRequest
|
364
|
+
include ::Google::Protobuf::MessageExts
|
365
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
366
|
+
end
|
367
|
+
|
368
|
+
# Request message for
|
369
|
+
# [GetRun][google.cloud.datacatalog.lineage.v1.GetRun].
|
370
|
+
# @!attribute [rw] name
|
371
|
+
# @return [::String]
|
372
|
+
# Required. The name of the run to get.
|
373
|
+
class GetRunRequest
|
374
|
+
include ::Google::Protobuf::MessageExts
|
375
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
376
|
+
end
|
377
|
+
|
378
|
+
# Request message for
|
379
|
+
# [ListRuns][google.cloud.datacatalog.lineage.v1.ListRuns].
|
380
|
+
# @!attribute [rw] parent
|
381
|
+
# @return [::String]
|
382
|
+
# Required. The name of process that owns this collection of runs.
|
383
|
+
# @!attribute [rw] page_size
|
384
|
+
# @return [::Integer]
|
385
|
+
# The maximum number of runs to return. The service may return
|
386
|
+
# fewer than this value. If unspecified, at most 50 runs are
|
387
|
+
# returned. The maximum value is 100; values greater than 100 are cut to
|
388
|
+
# 100.
|
389
|
+
# @!attribute [rw] page_token
|
390
|
+
# @return [::String]
|
391
|
+
# The page token received from a previous `ListRuns` call. Specify
|
392
|
+
# it to get the next page.
|
393
|
+
#
|
394
|
+
# When paginating, all other parameters specified in this call must
|
395
|
+
# match the parameters of the call that provided the page token.
|
396
|
+
class ListRunsRequest
|
397
|
+
include ::Google::Protobuf::MessageExts
|
398
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
399
|
+
end
|
400
|
+
|
401
|
+
# Response message for
|
402
|
+
# [ListRuns][google.cloud.datacatalog.lineage.v1.ListRuns].
|
403
|
+
# @!attribute [rw] runs
|
404
|
+
# @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::Run>]
|
405
|
+
# The runs from the specified project and location.
|
406
|
+
# @!attribute [rw] next_page_token
|
407
|
+
# @return [::String]
|
408
|
+
# The token to specify as `page_token` in the next call to get the next page.
|
409
|
+
# If this field is omitted, there are no subsequent pages.
|
410
|
+
class ListRunsResponse
|
411
|
+
include ::Google::Protobuf::MessageExts
|
412
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
413
|
+
end
|
414
|
+
|
415
|
+
# Request message for
|
416
|
+
# [DeleteRun][google.cloud.datacatalog.lineage.v1.DeleteRun].
|
417
|
+
# @!attribute [rw] name
|
418
|
+
# @return [::String]
|
419
|
+
# Required. The name of the run to delete.
|
420
|
+
# @!attribute [rw] allow_missing
|
421
|
+
# @return [::Boolean]
|
422
|
+
# If set to true and the run is not found, the request
|
423
|
+
# succeeds but the server doesn't perform any actions.
|
424
|
+
class DeleteRunRequest
|
425
|
+
include ::Google::Protobuf::MessageExts
|
426
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
427
|
+
end
|
428
|
+
|
429
|
+
# Request message for
|
430
|
+
# [CreateLineageEvent][google.cloud.datacatalog.lineage.v1.CreateLineageEvent].
|
431
|
+
# @!attribute [rw] parent
|
432
|
+
# @return [::String]
|
433
|
+
# Required. The name of the run that should own the lineage event.
|
434
|
+
# @!attribute [rw] lineage_event
|
435
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::LineageEvent]
|
436
|
+
# Required. The lineage event to create.
|
437
|
+
# @!attribute [rw] request_id
|
438
|
+
# @return [::String]
|
439
|
+
# A unique identifier for this request. Restricted to 36 ASCII characters.
|
440
|
+
# A random UUID is recommended. This request is idempotent only if a
|
441
|
+
# `request_id` is provided.
|
442
|
+
class CreateLineageEventRequest
|
443
|
+
include ::Google::Protobuf::MessageExts
|
444
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
445
|
+
end
|
446
|
+
|
447
|
+
# Request message for
|
448
|
+
# [GetLineageEvent][google.cloud.datacatalog.lineage.v1.GetLineageEvent].
|
449
|
+
# @!attribute [rw] name
|
450
|
+
# @return [::String]
|
451
|
+
# Required. The name of the lineage event to get.
|
452
|
+
class GetLineageEventRequest
|
453
|
+
include ::Google::Protobuf::MessageExts
|
454
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
455
|
+
end
|
456
|
+
|
457
|
+
# Request message for
|
458
|
+
# [ListLineageEvents][google.cloud.datacatalog.lineage.v1.ListLineageEvents].
|
459
|
+
# @!attribute [rw] parent
|
460
|
+
# @return [::String]
|
461
|
+
# Required. The name of the run that owns the collection of lineage events to
|
462
|
+
# get.
|
463
|
+
# @!attribute [rw] page_size
|
464
|
+
# @return [::Integer]
|
465
|
+
# The maximum number of lineage events to return.
|
466
|
+
#
|
467
|
+
# The service may return fewer events than this value.
|
468
|
+
# If unspecified, at most 50 events are returned. The maximum value is 100;
|
469
|
+
# values greater than 100 are cut to 100.
|
470
|
+
# @!attribute [rw] page_token
|
471
|
+
# @return [::String]
|
472
|
+
# The page token received from a previous `ListLineageEvents` call. Specify
|
473
|
+
# it to get the next page.
|
474
|
+
#
|
475
|
+
# When paginating, all other parameters specified in this call must
|
476
|
+
# match the parameters of the call that provided the page token.
|
477
|
+
class ListLineageEventsRequest
|
478
|
+
include ::Google::Protobuf::MessageExts
|
479
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
480
|
+
end
|
481
|
+
|
482
|
+
# Response message for
|
483
|
+
# [ListLineageEvents][google.cloud.datacatalog.lineage.v1.ListLineageEvents].
|
484
|
+
# @!attribute [rw] lineage_events
|
485
|
+
# @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::LineageEvent>]
|
486
|
+
# Lineage events from the specified project and location.
|
487
|
+
# @!attribute [rw] next_page_token
|
488
|
+
# @return [::String]
|
489
|
+
# The token to specify as `page_token` in the next call to get the next page.
|
490
|
+
# If this field is omitted, there are no subsequent pages.
|
491
|
+
class ListLineageEventsResponse
|
492
|
+
include ::Google::Protobuf::MessageExts
|
493
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
494
|
+
end
|
495
|
+
|
496
|
+
# Request message for
|
497
|
+
# [DeleteLineageEvent][google.cloud.datacatalog.lineage.v1.DeleteLineageEvent].
|
498
|
+
# @!attribute [rw] name
|
499
|
+
# @return [::String]
|
500
|
+
# Required. The name of the lineage event to delete.
|
501
|
+
# @!attribute [rw] allow_missing
|
502
|
+
# @return [::Boolean]
|
503
|
+
# If set to true and the lineage event is not found, the request
|
504
|
+
# succeeds but the server doesn't perform any actions.
|
505
|
+
class DeleteLineageEventRequest
|
506
|
+
include ::Google::Protobuf::MessageExts
|
507
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
508
|
+
end
|
509
|
+
|
510
|
+
# Request message for
|
511
|
+
# {::Google::Cloud::DataCatalog::Lineage::V1::Lineage::Client#search_links SearchLinks}.
|
512
|
+
# @!attribute [rw] parent
|
513
|
+
# @return [::String]
|
514
|
+
# Required. The project and location you want search in.
|
515
|
+
# @!attribute [rw] source
|
516
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
|
517
|
+
# Optional. Send asset information in the **source** field to retrieve all
|
518
|
+
# links that lead from the specified asset to downstream assets.
|
519
|
+
# @!attribute [rw] target
|
520
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
|
521
|
+
# Optional. Send asset information in the **target** field to retrieve all
|
522
|
+
# links that lead from upstream assets to the specified asset.
|
523
|
+
# @!attribute [rw] page_size
|
524
|
+
# @return [::Integer]
|
525
|
+
# Optional. The maximum number of links to return in a single page of the
|
526
|
+
# response. A page may contain fewer links than this value. If unspecified,
|
527
|
+
# at most 10 links are returned.
|
528
|
+
#
|
529
|
+
# Maximum value is 100; values greater than 100 are reduced to 100.
|
530
|
+
# @!attribute [rw] page_token
|
531
|
+
# @return [::String]
|
532
|
+
# Optional. The page token received from a previous `SearchLinksRequest`
|
533
|
+
# call. Use it to get the next page.
|
534
|
+
#
|
535
|
+
# When requesting subsequent pages of a response, remember that
|
536
|
+
# all parameters must match the values you provided
|
537
|
+
# in the original request.
|
538
|
+
class SearchLinksRequest
|
539
|
+
include ::Google::Protobuf::MessageExts
|
540
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
541
|
+
end
|
542
|
+
|
543
|
+
# Response message for
|
544
|
+
# {::Google::Cloud::DataCatalog::Lineage::V1::Lineage::Client#search_links SearchLinks}.
|
545
|
+
# @!attribute [rw] links
|
546
|
+
# @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::Link>]
|
547
|
+
# The list of links for a given asset. Can be empty if the asset has no
|
548
|
+
# relations of requested type (source or target).
|
549
|
+
# @!attribute [rw] next_page_token
|
550
|
+
# @return [::String]
|
551
|
+
# The token to specify as `page_token` in the subsequent call to get the next
|
552
|
+
# page. Omitted if there are no more pages in the response.
|
553
|
+
class SearchLinksResponse
|
554
|
+
include ::Google::Protobuf::MessageExts
|
555
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
556
|
+
end
|
557
|
+
|
558
|
+
# Links represent the data flow between **source** (upstream)
|
559
|
+
# and **target** (downstream) assets in transformation pipelines.
|
560
|
+
#
|
561
|
+
# Links are created when LineageEvents record data transformation between
|
562
|
+
# related assets.
|
563
|
+
# @!attribute [r] name
|
564
|
+
# @return [::String]
|
565
|
+
# Output only. Immutable. The name of the link. Format:
|
566
|
+
# `projects/{project}/locations/{location}/links/{link}`.
|
567
|
+
# @!attribute [rw] source
|
568
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
|
569
|
+
# The pointer to the entity that is the **source** of this link.
|
570
|
+
# @!attribute [rw] target
|
571
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::EntityReference]
|
572
|
+
# The pointer to the entity that is the **target** of this link.
|
573
|
+
# @!attribute [rw] start_time
|
574
|
+
# @return [::Google::Protobuf::Timestamp]
|
575
|
+
# The start of the first event establishing this link.
|
576
|
+
# @!attribute [rw] end_time
|
577
|
+
# @return [::Google::Protobuf::Timestamp]
|
578
|
+
# The end of the last event establishing this link.
|
579
|
+
class Link
|
580
|
+
include ::Google::Protobuf::MessageExts
|
581
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
582
|
+
end
|
583
|
+
|
584
|
+
# Request message for
|
585
|
+
# {::Google::Cloud::DataCatalog::Lineage::V1::Lineage::Client#batch_search_link_processes BatchSearchLinkProcesses}.
|
586
|
+
# @!attribute [rw] parent
|
587
|
+
# @return [::String]
|
588
|
+
# Required. The project and location where you want to search.
|
589
|
+
# @!attribute [rw] links
|
590
|
+
# @return [::Array<::String>]
|
591
|
+
# Required. An array of links to check for their associated LineageProcesses.
|
592
|
+
#
|
593
|
+
# The maximum number of items in this array is 100.
|
594
|
+
# If the request contains more than 100 links, it returns the
|
595
|
+
# `INVALID_ARGUMENT` error.
|
596
|
+
#
|
597
|
+
# Format: `projects/{project}/locations/{location}/links/{link}`.
|
598
|
+
# @!attribute [rw] page_size
|
599
|
+
# @return [::Integer]
|
600
|
+
# The maximum number of processes to return in a single page of the response.
|
601
|
+
# A page may contain fewer results than this value.
|
602
|
+
# @!attribute [rw] page_token
|
603
|
+
# @return [::String]
|
604
|
+
# The page token received from a previous `BatchSearchLinkProcesses` call.
|
605
|
+
# Use it to get the next page.
|
606
|
+
#
|
607
|
+
# When requesting subsequent pages of a response, remember that
|
608
|
+
# all parameters must match the values you provided
|
609
|
+
# in the original request.
|
610
|
+
class BatchSearchLinkProcessesRequest
|
611
|
+
include ::Google::Protobuf::MessageExts
|
612
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
613
|
+
end
|
614
|
+
|
615
|
+
# Response message for
|
616
|
+
# {::Google::Cloud::DataCatalog::Lineage::V1::Lineage::Client#batch_search_link_processes BatchSearchLinkProcesses}.
|
617
|
+
# @!attribute [rw] process_links
|
618
|
+
# @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::ProcessLinks>]
|
619
|
+
# An array of processes associated with the specified links.
|
620
|
+
# @!attribute [rw] next_page_token
|
621
|
+
# @return [::String]
|
622
|
+
# The token to specify as `page_token` in the subsequent call to get the next
|
623
|
+
# page. Omitted if there are no more pages in the response.
|
624
|
+
class BatchSearchLinkProcessesResponse
|
625
|
+
include ::Google::Protobuf::MessageExts
|
626
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
627
|
+
end
|
628
|
+
|
629
|
+
# Links associated with a specific process.
|
630
|
+
# @!attribute [rw] process
|
631
|
+
# @return [::String]
|
632
|
+
# The process name in the format of
|
633
|
+
# `projects/{project}/locations/{location}/processes/{process}`.
|
634
|
+
# @!attribute [rw] links
|
635
|
+
# @return [::Array<::Google::Cloud::DataCatalog::Lineage::V1::ProcessLinkInfo>]
|
636
|
+
# An array containing link details objects of the links provided in
|
637
|
+
# the original request.
|
638
|
+
#
|
639
|
+
# A single process can result in creating multiple links.
|
640
|
+
# If any of the links you provide in the request are created by
|
641
|
+
# the same process, they all are included in this array.
|
642
|
+
class ProcessLinks
|
643
|
+
include ::Google::Protobuf::MessageExts
|
644
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
645
|
+
end
|
646
|
+
|
647
|
+
# Link details.
|
648
|
+
# @!attribute [rw] link
|
649
|
+
# @return [::String]
|
650
|
+
# The name of the link in the format of
|
651
|
+
# `projects/{project}/locations/{location}/links/{link}`.
|
652
|
+
# @!attribute [rw] start_time
|
653
|
+
# @return [::Google::Protobuf::Timestamp]
|
654
|
+
# The start of the first event establishing this link-process tuple.
|
655
|
+
# @!attribute [rw] end_time
|
656
|
+
# @return [::Google::Protobuf::Timestamp]
|
657
|
+
# The end of the last event establishing this link-process tuple.
|
658
|
+
class ProcessLinkInfo
|
659
|
+
include ::Google::Protobuf::MessageExts
|
660
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
661
|
+
end
|
662
|
+
|
663
|
+
# Origin of a process.
|
664
|
+
# @!attribute [rw] source_type
|
665
|
+
# @return [::Google::Cloud::DataCatalog::Lineage::V1::Origin::SourceType]
|
666
|
+
# Type of the source.
|
667
|
+
# @!attribute [rw] name
|
668
|
+
# @return [::String]
|
669
|
+
# If the source_type isn't CUSTOM, the value of this field should be a GCP
|
670
|
+
# resource name of the system, which reports lineage. The project and
|
671
|
+
# location parts of the resource name must match the project and location of
|
672
|
+
# the lineage resource being created. Examples:
|
673
|
+
#
|
674
|
+
# - `{source_type: COMPOSER, name:
|
675
|
+
# "projects/foo/locations/us/environments/bar"}`
|
676
|
+
# - `{source_type: BIGQUERY, name: "projects/foo/locations/eu"}`
|
677
|
+
# - `{source_type: CUSTOM, name: "myCustomIntegration"}`
|
678
|
+
class Origin
|
679
|
+
include ::Google::Protobuf::MessageExts
|
680
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
681
|
+
|
682
|
+
# Type of the source of a process.
|
683
|
+
module SourceType
|
684
|
+
# Source is Unspecified
|
685
|
+
SOURCE_TYPE_UNSPECIFIED = 0
|
686
|
+
|
687
|
+
# A custom source
|
688
|
+
CUSTOM = 1
|
689
|
+
|
690
|
+
# BigQuery
|
691
|
+
BIGQUERY = 2
|
692
|
+
|
693
|
+
# Data Fusion
|
694
|
+
DATA_FUSION = 3
|
695
|
+
|
696
|
+
# Composer
|
697
|
+
COMPOSER = 4
|
698
|
+
|
699
|
+
# Looker Studio
|
700
|
+
LOOKER_STUDIO = 5
|
701
|
+
end
|
702
|
+
end
|
703
|
+
end
|
704
|
+
end
|
705
|
+
end
|
706
|
+
end
|
707
|
+
end
|