google-cloud-data_catalog-v1 0.4.4 → 0.7.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (39) hide show
  1. checksums.yaml +4 -4
  2. data/LICENSE.md +188 -190
  3. data/README.md +66 -2
  4. data/lib/google/cloud/data_catalog/v1.rb +5 -0
  5. data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +245 -121
  6. data/lib/google/cloud/data_catalog/v1/data_catalog/paths.rb +23 -0
  7. data/lib/google/cloud/data_catalog/v1/policy_tag_manager.rb +54 -0
  8. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +1320 -0
  9. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/credentials.rb +51 -0
  10. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/paths.rb +90 -0
  11. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization.rb +51 -0
  12. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +474 -0
  13. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/credentials.rb +51 -0
  14. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/paths.rb +69 -0
  15. data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
  16. data/lib/google/cloud/datacatalog/v1/common_pb.rb +1 -0
  17. data/lib/google/cloud/datacatalog/v1/data_source_pb.rb +30 -0
  18. data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +25 -0
  19. data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +33 -30
  20. data/lib/google/cloud/datacatalog/v1/policytagmanager_pb.rb +107 -0
  21. data/lib/google/cloud/datacatalog/v1/policytagmanager_services_pb.rb +85 -0
  22. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb +70 -0
  23. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_services_pb.rb +62 -0
  24. data/lib/google/cloud/datacatalog/v1/search_pb.rb +2 -0
  25. data/lib/google/cloud/datacatalog/v1/table_spec_pb.rb +1 -0
  26. data/lib/google/cloud/datacatalog/v1/tags_pb.rb +1 -0
  27. data/proto_docs/google/api/field_behavior.rb +6 -0
  28. data/proto_docs/google/api/resource.rb +50 -14
  29. data/proto_docs/google/cloud/datacatalog/v1/common.rb +3 -0
  30. data/proto_docs/google/cloud/datacatalog/v1/data_source.rb +51 -0
  31. data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +212 -111
  32. data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +292 -0
  33. data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb +141 -0
  34. data/proto_docs/google/cloud/datacatalog/v1/schema.rb +16 -4
  35. data/proto_docs/google/cloud/datacatalog/v1/search.rb +14 -0
  36. data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb +3 -0
  37. data/proto_docs/google/cloud/datacatalog/v1/tags.rb +44 -21
  38. data/proto_docs/google/protobuf/timestamp.rb +10 -1
  39. metadata +28 -9
@@ -47,6 +47,9 @@ module Google
47
47
  # Example:
48
48
  #
49
49
  # * `//bigquery.googleapis.com/projects/projectId/datasets/datasetId/tables/tableId`
50
+ # @!attribute [rw] modify_time
51
+ # @return [::Google::Protobuf::Timestamp]
52
+ # Last-modified timestamp of the entry from the managing system.
50
53
  # @!attribute [r] integrated_system
51
54
  # @return [::Google::Cloud::DataCatalog::V1::IntegratedSystem]
52
55
  # Output only. This field indicates the entry's source system that Data Catalog
@@ -55,6 +58,17 @@ module Google
55
58
  # @return [::String]
56
59
  # This field indicates the entry's source system that Data Catalog does not
57
60
  # integrate with.
61
+ # @!attribute [rw] fully_qualified_name
62
+ # @return [::String]
63
+ # Fully Qualified Name of the resource.
64
+ # There are two main forms of FQNs:
65
+ # \\{system}:\\{project}.\\{dot-separated path to resource}
66
+ # for non-regionalized resources
67
+ # \\{system}:\\{project}.\\{location id}.\\{dot-separated path to resource}
68
+ # for regionalized resources
69
+ # Examples:
70
+ # * dataproc_metastore:projectId.locationId.instanceId.databaseId.tableId
71
+ # * bigquery:table.project_id.dataset_id.table_id
58
72
  class SearchCatalogResult
59
73
  include ::Google::Protobuf::MessageExts
60
74
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -91,6 +91,9 @@ module Google
91
91
 
92
92
  # BigQuery native table.
93
93
  BIGQUERY_TABLE = 5
94
+
95
+ # BigQuery materialized view.
96
+ BIGQUERY_MATERIALIZED_VIEW = 7
94
97
  end
95
98
  end
96
99
  end
@@ -31,15 +31,17 @@ module Google
31
31
  # @return [::String]
32
32
  # The resource name of the tag in URL format. Example:
33
33
  #
34
- # * projects/\\{project_id}/locations/\\{location}/entrygroups/\\{entry_group_id}/entries/\\{entry_id}/tags/\\{tag_id}
34
+ # `projects/{project_id}/locations/{location}/entrygroups/{entry_group_id}/entries/{entry_id}/tags/{tag_id}`
35
35
  #
36
36
  # where `tag_id` is a system-generated identifier.
37
- # Note that this Tag may not actually be stored in the location in this name.
37
+ #
38
+ # Note: The tag itself might not be stored in the location specified in its
39
+ # name.
38
40
  # @!attribute [rw] template
39
41
  # @return [::String]
40
42
  # Required. The resource name of the tag template that this tag uses. Example:
41
43
  #
42
- # * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}
44
+ # `projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}`
43
45
  #
44
46
  # This field cannot be modified after creation.
45
47
  # @!attribute [r] template_display_name
@@ -47,13 +49,11 @@ module Google
47
49
  # Output only. The display name of the tag template.
48
50
  # @!attribute [rw] column
49
51
  # @return [::String]
50
- # Resources like Entry can have schemas associated with them. This scope
52
+ # Resources like entry can have schemas associated with them. This scope
51
53
  # allows users to attach tags to an individual column based on that schema.
52
54
  #
53
- # For attaching a tag to a nested column, use `.` to separate the column
54
- # names. Example:
55
- #
56
- # * `outer_column.inner_column`
55
+ # To attach a tag to a nested column, separate column names with a dot
56
+ # (`.`). Example: `column.nested_column`.
57
57
  # @!attribute [rw] fields
58
58
  # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::DataCatalog::V1::TagField}]
59
59
  # Required. This maps the ID of a tag field to the value of and additional information
@@ -84,6 +84,7 @@ module Google
84
84
  # @!attribute [rw] string_value
85
85
  # @return [::String]
86
86
  # Holds the value for a tag field with string type.
87
+ # The maximum length is 2000 UTF-8 characters.
87
88
  # @!attribute [rw] bool_value
88
89
  # @return [::Boolean]
89
90
  # Holds the value for a tag field with boolean type.
@@ -127,13 +128,17 @@ module Google
127
128
  # @return [::String]
128
129
  # The resource name of the tag template in URL format. Example:
129
130
  #
130
- # * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template_id}
131
+ # `projects/{project_id}/locations/{location}/tagTemplates/{tag_template_id}`
131
132
  #
132
- # Note that this TagTemplate and its child resources may not actually be
133
- # stored in the location in this name.
133
+ # Note: The tag template itself and its child resources might not be
134
+ # stored in the location specified in its name.
134
135
  # @!attribute [rw] display_name
135
136
  # @return [::String]
136
- # The display name for this template. Defaults to an empty string.
137
+ # Display name for this template. Defaults to an empty string.
138
+ #
139
+ # The name must contain only Unicode letters, numbers (0-9), underscores (_),
140
+ # dashes (-), spaces ( ), and can't start or end with spaces.
141
+ # The maximum length is 200 characters.
137
142
  # @!attribute [rw] fields
138
143
  # @return [::Google::Protobuf::Map{::String => ::Google::Cloud::DataCatalog::V1::TagTemplateField}]
139
144
  # Required. Map of tag template field IDs to the settings for the field.
@@ -163,19 +168,30 @@ module Google
163
168
  # @return [::String]
164
169
  # Output only. The resource name of the tag template field in URL format. Example:
165
170
  #
166
- # * projects/\\{project_id}/locations/\\{location}/tagTemplates/\\{tag_template}/fields/\\{field}
171
+ # `projects/{project_id}/locations/{location}/tagTemplates/{tag_template}/fields/{field}`
167
172
  #
168
- # Note that this TagTemplateField may not actually be stored in the location
169
- # in this name.
173
+ # Note: The `TagTemplateField` itself might not be stored in the location
174
+ # specified in its name.
175
+ #
176
+ # The name must contain only letters (a-z, A-Z), numbers (0-9),
177
+ # or underscores (_), and must start with a letter or underscore.
178
+ # The maximum length is 64 characters.
170
179
  # @!attribute [rw] display_name
171
180
  # @return [::String]
172
181
  # The display name for this field. Defaults to an empty string.
182
+ #
183
+ # The name must contain only Unicode letters, numbers (0-9), underscores (_),
184
+ # dashes (-), spaces ( ), and can't start or end with spaces.
185
+ # The maximum length is 200 characters.
173
186
  # @!attribute [rw] type
174
187
  # @return [::Google::Cloud::DataCatalog::V1::FieldType]
175
188
  # Required. The type of value this tag field can contain.
176
189
  # @!attribute [rw] is_required
177
190
  # @return [::Boolean]
178
191
  # Whether this is a required field. Defaults to false.
192
+ # @!attribute [rw] description
193
+ # @return [::String]
194
+ # The description for this field. Defaults to an empty string.
179
195
  # @!attribute [rw] order
180
196
  # @return [::Integer]
181
197
  # The order of this field with respect to other fields in this tag
@@ -199,12 +215,15 @@ module Google
199
215
 
200
216
  # @!attribute [rw] allowed_values
201
217
  # @return [::Array<::Google::Cloud::DataCatalog::V1::FieldType::EnumType::EnumValue>]
202
- # Required on create; optional on update. The set of allowed values for
203
- # this enum. This set must not be empty, the display names of the values in
204
- # this set must not be empty and the display names of the values must be
205
- # case-insensitively unique within this set. Currently, enum values can
206
- # only be added to the list of allowed values. Deletion and renaming of
207
- # enum values are not supported. Can have up to 500 allowed values.
218
+ # The set of allowed values for this enum.
219
+ #
220
+ # This set must not be empty and can include up to 100 allowed values.
221
+ # The display names of the values in this set must not be empty and must
222
+ # be case-insensitively unique within this set.
223
+ #
224
+ # The order of items in this set is preserved. This field can be used to
225
+ # create, remove and reorder enum values. To rename enum values, use the
226
+ # `RenameTagTemplateFieldEnumValue` method.
208
227
  class EnumType
209
228
  include ::Google::Protobuf::MessageExts
210
229
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -212,6 +231,10 @@ module Google
212
231
  # @!attribute [rw] display_name
213
232
  # @return [::String]
214
233
  # Required. The display name of the enum value. Must not be an empty string.
234
+ #
235
+ # The name must contain only Unicode letters, numbers (0-9), underscores
236
+ # (_), dashes (-), spaces ( ), and can't start or end with spaces. The
237
+ # maximum length is 200 characters.
215
238
  class EnumValue
216
239
  include ::Google::Protobuf::MessageExts
217
240
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -70,7 +70,16 @@ module Google
70
70
  # .setNanos((int) ((millis % 1000) * 1000000)).build();
71
71
  #
72
72
  #
73
- # Example 5: Compute Timestamp from current time in Python.
73
+ # Example 5: Compute Timestamp from Java `Instant.now()`.
74
+ #
75
+ # Instant now = Instant.now();
76
+ #
77
+ # Timestamp timestamp =
78
+ # Timestamp.newBuilder().setSeconds(now.getEpochSecond())
79
+ # .setNanos(now.getNano()).build();
80
+ #
81
+ #
82
+ # Example 6: Compute Timestamp from current time in Python.
74
83
  #
75
84
  # timestamp = Timestamp()
76
85
  # timestamp.GetCurrentTime()
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: google-cloud-data_catalog-v1
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.4.4
4
+ version: 0.7.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Google LLC
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-08-06 00:00:00.000000000 Z
11
+ date: 2021-03-31 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: gapic-common
@@ -16,14 +16,14 @@ dependencies:
16
16
  requirements:
17
17
  - - "~>"
18
18
  - !ruby/object:Gem::Version
19
- version: '0.3'
19
+ version: '0.4'
20
20
  type: :runtime
21
21
  prerelease: false
22
22
  version_requirements: !ruby/object:Gem::Requirement
23
23
  requirements:
24
24
  - - "~>"
25
25
  - !ruby/object:Gem::Version
26
- version: '0.3'
26
+ version: '0.4'
27
27
  - !ruby/object:Gem::Dependency
28
28
  name: google-cloud-errors
29
29
  requirement: !ruby/object:Gem::Requirement
@@ -64,14 +64,14 @@ dependencies:
64
64
  requirements:
65
65
  - - "~>"
66
66
  - !ruby/object:Gem::Version
67
- version: 1.24.0
67
+ version: 1.25.1
68
68
  type: :development
69
69
  prerelease: false
70
70
  version_requirements: !ruby/object:Gem::Requirement
71
71
  requirements:
72
72
  - - "~>"
73
73
  - !ruby/object:Gem::Version
74
- version: 1.24.0
74
+ version: 1.25.1
75
75
  - !ruby/object:Gem::Dependency
76
76
  name: minitest
77
77
  requirement: !ruby/object:Gem::Requirement
@@ -172,7 +172,10 @@ dependencies:
172
172
  version: '0.9'
173
173
  description: DataCatalog is a centralized and unified data catalog service for all
174
174
  your Cloud resources, where users and systems can discover data, explore and curate
175
- its semantics, understand how to act on it, and help govern its usage.
175
+ its semantics, understand how to act on it, and help govern its usage. Note that
176
+ google-cloud-data_catalog-v1 is a version-specific client library. For most uses,
177
+ we recommend installing the main client library google-cloud-data_catalog instead.
178
+ See the readme for more details.
176
179
  email: googleapis-packages@google.com
177
180
  executables: []
178
181
  extensions: []
@@ -188,11 +191,24 @@ files:
188
191
  - lib/google/cloud/data_catalog/v1/data_catalog/client.rb
189
192
  - lib/google/cloud/data_catalog/v1/data_catalog/credentials.rb
190
193
  - lib/google/cloud/data_catalog/v1/data_catalog/paths.rb
194
+ - lib/google/cloud/data_catalog/v1/policy_tag_manager.rb
195
+ - lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb
196
+ - lib/google/cloud/data_catalog/v1/policy_tag_manager/credentials.rb
197
+ - lib/google/cloud/data_catalog/v1/policy_tag_manager/paths.rb
198
+ - lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization.rb
199
+ - lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb
200
+ - lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/credentials.rb
201
+ - lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/paths.rb
191
202
  - lib/google/cloud/data_catalog/v1/version.rb
192
203
  - lib/google/cloud/datacatalog/v1/common_pb.rb
204
+ - lib/google/cloud/datacatalog/v1/data_source_pb.rb
193
205
  - lib/google/cloud/datacatalog/v1/datacatalog_pb.rb
194
206
  - lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb
195
207
  - lib/google/cloud/datacatalog/v1/gcs_fileset_spec_pb.rb
208
+ - lib/google/cloud/datacatalog/v1/policytagmanager_pb.rb
209
+ - lib/google/cloud/datacatalog/v1/policytagmanager_services_pb.rb
210
+ - lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb
211
+ - lib/google/cloud/datacatalog/v1/policytagmanagerserialization_services_pb.rb
196
212
  - lib/google/cloud/datacatalog/v1/schema_pb.rb
197
213
  - lib/google/cloud/datacatalog/v1/search_pb.rb
198
214
  - lib/google/cloud/datacatalog/v1/table_spec_pb.rb
@@ -202,8 +218,11 @@ files:
202
218
  - proto_docs/google/api/field_behavior.rb
203
219
  - proto_docs/google/api/resource.rb
204
220
  - proto_docs/google/cloud/datacatalog/v1/common.rb
221
+ - proto_docs/google/cloud/datacatalog/v1/data_source.rb
205
222
  - proto_docs/google/cloud/datacatalog/v1/datacatalog.rb
206
223
  - proto_docs/google/cloud/datacatalog/v1/gcs_fileset_spec.rb
224
+ - proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb
225
+ - proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb
207
226
  - proto_docs/google/cloud/datacatalog/v1/schema.rb
208
227
  - proto_docs/google/cloud/datacatalog/v1/search.rb
209
228
  - proto_docs/google/cloud/datacatalog/v1/table_spec.rb
@@ -228,14 +247,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
228
247
  requirements:
229
248
  - - ">="
230
249
  - !ruby/object:Gem::Version
231
- version: '2.4'
250
+ version: '2.5'
232
251
  required_rubygems_version: !ruby/object:Gem::Requirement
233
252
  requirements:
234
253
  - - ">="
235
254
  - !ruby/object:Gem::Version
236
255
  version: '0'
237
256
  requirements: []
238
- rubygems_version: 3.1.3
257
+ rubygems_version: 3.2.13
239
258
  signing_key:
240
259
  specification_version: 4
241
260
  summary: API Client library for the Data Catalog V1 API