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.
Files changed (48) hide show
  1. checksums.yaml +4 -4
  2. data/README.md +1 -1
  3. data/lib/google/cloud/data_catalog/v1/data_catalog/client.rb +288 -54
  4. data/lib/google/cloud/data_catalog/v1/data_catalog/operations.rb +768 -0
  5. data/lib/google/cloud/data_catalog/v1/data_catalog/rest/client.rb +228 -54
  6. data/lib/google/cloud/data_catalog/v1/data_catalog/rest/operations.rb +792 -0
  7. data/lib/google/cloud/data_catalog/v1/data_catalog/rest/service_stub.rb +120 -0
  8. data/lib/google/cloud/data_catalog/v1/data_catalog/rest.rb +1 -0
  9. data/lib/google/cloud/data_catalog/v1/data_catalog.rb +1 -0
  10. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/client.rb +6 -3
  11. data/lib/google/cloud/data_catalog/v1/policy_tag_manager/rest/client.rb +6 -3
  12. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/client.rb +6 -4
  13. data/lib/google/cloud/data_catalog/v1/policy_tag_manager_serialization/rest/client.rb +6 -4
  14. data/lib/google/cloud/data_catalog/v1/version.rb +1 -1
  15. data/lib/google/cloud/datacatalog/v1/bigquery_pb.rb +24 -25
  16. data/lib/google/cloud/datacatalog/v1/common_pb.rb +26 -12
  17. data/lib/google/cloud/datacatalog/v1/data_source_pb.rb +24 -18
  18. data/lib/google/cloud/datacatalog/v1/datacatalog_pb.rb +55 -263
  19. data/lib/google/cloud/datacatalog/v1/datacatalog_services_pb.rb +33 -0
  20. data/lib/google/cloud/datacatalog/v1/dataplex_spec_pb.rb +25 -21
  21. data/lib/google/cloud/datacatalog/v1/dump_content_pb.rb +49 -0
  22. data/lib/google/cloud/datacatalog/v1/gcs_fileset_spec_pb.rb +25 -10
  23. data/lib/google/cloud/datacatalog/v1/physical_schema_pb.rb +24 -26
  24. data/lib/google/cloud/datacatalog/v1/policytagmanager_pb.rb +28 -66
  25. data/lib/google/cloud/datacatalog/v1/policytagmanagerserialization_pb.rb +25 -43
  26. data/lib/google/cloud/datacatalog/v1/schema_pb.rb +27 -11
  27. data/lib/google/cloud/datacatalog/v1/search_pb.rb +25 -21
  28. data/lib/google/cloud/datacatalog/v1/table_spec_pb.rb +24 -26
  29. data/lib/google/cloud/datacatalog/v1/tags_pb.rb +25 -59
  30. data/lib/google/cloud/datacatalog/v1/timestamps_pb.rb +25 -6
  31. data/lib/google/cloud/datacatalog/v1/usage_pb.rb +26 -11
  32. data/proto_docs/google/api/client.rb +67 -4
  33. data/proto_docs/google/cloud/datacatalog/v1/common.rb +25 -0
  34. data/proto_docs/google/cloud/datacatalog/v1/datacatalog.rb +367 -41
  35. data/proto_docs/google/cloud/datacatalog/v1/dump_content.rb +53 -0
  36. data/proto_docs/google/cloud/datacatalog/v1/gcs_fileset_spec.rb +2 -1
  37. data/proto_docs/google/cloud/datacatalog/v1/policytagmanager.rb +23 -2
  38. data/proto_docs/google/cloud/datacatalog/v1/policytagmanagerserialization.rb +6 -3
  39. data/proto_docs/google/cloud/datacatalog/v1/schema.rb +68 -3
  40. data/proto_docs/google/cloud/datacatalog/v1/search.rb +2 -2
  41. data/proto_docs/google/cloud/datacatalog/v1/table_spec.rb +5 -5
  42. data/proto_docs/google/cloud/datacatalog/v1/tags.rb +11 -8
  43. data/proto_docs/google/cloud/datacatalog/v1/usage.rb +30 -1
  44. data/proto_docs/google/longrunning/operations.rb +164 -0
  45. data/proto_docs/google/protobuf/any.rb +144 -0
  46. data/proto_docs/google/protobuf/timestamp.rb +1 -3
  47. data/proto_docs/google/rpc/status.rb +48 -0
  48. metadata +11 -4
@@ -32,9 +32,8 @@ module Google
32
32
  # the request returns an error.
33
33
  # @!attribute [rw] query
34
34
  # @return [::String]
35
- # Optional. The query string with a minimum of 3 characters and specific syntax.
36
- # For more information, see
37
- # [Data Catalog search
35
+ # Optional. The query string with a minimum of 3 characters and specific
36
+ # syntax. For more information, see [Data Catalog search
38
37
  # syntax](https://cloud.google.com/data-catalog/docs/how-to/search-reference).
39
38
  #
40
39
  # An empty query string returns all data assets (in the specified scope)
@@ -54,10 +53,11 @@ module Google
54
53
  # exception.
55
54
  # @!attribute [rw] page_token
56
55
  # @return [::String]
57
- # Optional. Pagination token that, if specified, returns the next page of search
58
- # results. If empty, returns the first page.
56
+ # Optional. Pagination token that, if specified, returns the next page of
57
+ # search results. If empty, returns the first page.
59
58
  #
60
- # This token is returned in the {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}
59
+ # This token is returned in the
60
+ # {::Google::Cloud::DataCatalog::V1::SearchCatalogResponse#next_page_token SearchCatalogResponse.next_page_token}
61
61
  # field of the response to a previous
62
62
  # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#search_catalog SearchCatalogRequest}
63
63
  # call.
@@ -92,15 +92,15 @@ module Google
92
92
  # numbers, see [Projects](/docs/overview/#projects).
93
93
  # @!attribute [rw] include_gcp_public_datasets
94
94
  # @return [::Boolean]
95
- # If `true`, include Google Cloud Platform (GCP) public datasets in
95
+ # If `true`, include Google Cloud public datasets in
96
96
  # search results. By default, they are excluded.
97
97
  #
98
98
  # See [Google Cloud Public Datasets](/public-datasets) for more
99
99
  # information.
100
100
  # @!attribute [rw] restricted_locations
101
101
  # @return [::Array<::String>]
102
- # Optional. The list of locations to search within. If empty, all locations are
103
- # searched.
102
+ # Optional. The list of locations to search within. If empty, all locations
103
+ # are searched.
104
104
  #
105
105
  # Returns an error if any location in the list isn't one of the [Supported
106
106
  # regions](https://cloud.google.com/data-catalog/docs/concepts/regions#supported_regions).
@@ -116,8 +116,8 @@ module Google
116
116
  # By default, all results are returned, starred or not.
117
117
  # @!attribute [rw] include_public_tag_templates
118
118
  # @return [::Boolean]
119
- # Optional. This field is deprecated. The search mechanism for public and private tag
120
- # templates is the same.
119
+ # Optional. This field is deprecated. The search mechanism for public and
120
+ # private tag templates is the same.
121
121
  class Scope
122
122
  include ::Google::Protobuf::MessageExts
123
123
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -129,6 +129,9 @@ module Google
129
129
  # @!attribute [rw] results
130
130
  # @return [::Array<::Google::Cloud::DataCatalog::V1::SearchCatalogResult>]
131
131
  # Search results.
132
+ # @!attribute [rw] total_size
133
+ # @return [::Integer]
134
+ # The approximate total number of entries matched by the query.
132
135
  # @!attribute [rw] next_page_token
133
136
  # @return [::String]
134
137
  # Pagination token that can be used in subsequent calls to retrieve the next
@@ -150,7 +153,8 @@ module Google
150
153
  # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#create_entry_group CreateEntryGroup}.
151
154
  # @!attribute [rw] parent
152
155
  # @return [::String]
153
- # Required. The names of the project and location that the new entry group belongs to.
156
+ # Required. The names of the project and location that the new entry group
157
+ # belongs to.
154
158
  #
155
159
  # Note: The entry group itself and its child resources might not be
156
160
  # stored in the location specified in its name.
@@ -361,7 +365,9 @@ module Google
361
365
  # (https://cloud.google.com/bigquery/docs/reference/standard-sql/lexical).
362
366
  # @!attribute [rw] fully_qualified_name
363
367
  # @return [::String]
364
- # Fully qualified name (FQN) of the resource.
368
+ # [Fully Qualified Name
369
+ # (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names)
370
+ # of the resource.
365
371
  #
366
372
  # FQNs take two forms:
367
373
  #
@@ -376,6 +382,16 @@ module Google
376
382
  # Example for a DPMS table:
377
383
  #
378
384
  # `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
385
+ # @!attribute [rw] project
386
+ # @return [::String]
387
+ # Project where the lookup should be performed. Required to lookup
388
+ # entry that is not a part of `DPMS` or `DATAPLEX` `integrated_system`
389
+ # using its `fully_qualified_name`. Ignored in other cases.
390
+ # @!attribute [rw] location
391
+ # @return [::String]
392
+ # Location where the lookup should be performed. Required to lookup
393
+ # entry that is not a part of `DPMS` or `DATAPLEX` `integrated_system`
394
+ # using its `fully_qualified_name`. Ignored in other cases.
379
395
  class LookupEntryRequest
380
396
  include ::Google::Protobuf::MessageExts
381
397
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -419,25 +435,11 @@ module Google
419
435
  # The maximum size is 200 bytes when encoded in UTF-8.
420
436
  # @!attribute [rw] fully_qualified_name
421
437
  # @return [::String]
422
- # Fully qualified name (FQN) of the resource. Set automatically for entries
423
- # representing resources from synced systems. Settable only during creation
424
- # and read-only afterwards. Can be used for search and lookup of the entries.
425
- #
426
- #
427
- #
428
- # FQNs take two forms:
429
- #
430
- # * For non-regionalized resources:
431
- #
432
- # `{SYSTEM}:{PROJECT}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
433
- #
434
- # * For regionalized resources:
435
- #
436
- # `{SYSTEM}:{PROJECT}.{LOCATION_ID}.{PATH_TO_RESOURCE_SEPARATED_WITH_DOTS}`
437
- #
438
- # Example for a DPMS table:
439
- #
440
- # `dataproc_metastore:{PROJECT_ID}.{LOCATION_ID}.{INSTANCE_ID}.{DATABASE_ID}.{TABLE_ID}`
438
+ # [Fully Qualified Name
439
+ # (FQN)](https://cloud.google.com//data-catalog/docs/fully-qualified-names)
440
+ # of the resource. Set automatically for entries representing resources from
441
+ # synced systems. Settable only during creation, and read-only later. Can
442
+ # be used for search and lookup of the entries.
441
443
  # @!attribute [rw] type
442
444
  # @return [::Google::Cloud::DataCatalog::V1::EntryType]
443
445
  # The type of the entry.
@@ -475,6 +477,18 @@ module Google
475
477
  # * Must begin with a letter or underscore.
476
478
  # * Can only contain letters, numbers, and underscores.
477
479
  # * Must be at least 1 character and at most 64 characters long.
480
+ # @!attribute [rw] sql_database_system_spec
481
+ # @return [::Google::Cloud::DataCatalog::V1::SqlDatabaseSystemSpec]
482
+ # Specification that applies to a relational database system. Only settable
483
+ # when `user_specified_system` is equal to `SQL_DATABASE`
484
+ # @!attribute [rw] looker_system_spec
485
+ # @return [::Google::Cloud::DataCatalog::V1::LookerSystemSpec]
486
+ # Specification that applies to Looker sysstem. Only settable when
487
+ # `user_specified_system` is equal to `LOOKER`
488
+ # @!attribute [rw] cloud_bigtable_system_spec
489
+ # @return [::Google::Cloud::DataCatalog::V1::CloudBigtableSystemSpec]
490
+ # Specification that applies to Cloud Bigtable system. Only settable when
491
+ # `integrated_system` is equal to `CLOUD_BIGTABLE`
478
492
  # @!attribute [rw] gcs_fileset_spec
479
493
  # @return [::Google::Cloud::DataCatalog::V1::GcsFilesetSpec]
480
494
  # Specification that applies to a Cloud Storage fileset. Valid only
@@ -493,7 +507,7 @@ module Google
493
507
  # @!attribute [rw] database_table_spec
494
508
  # @return [::Google::Cloud::DataCatalog::V1::DatabaseTableSpec]
495
509
  # Specification that applies to a table resource. Valid only
496
- # for entries with the `TABLE` type.
510
+ # for entries with the `TABLE` or `EXPLORE` type.
497
511
  # @!attribute [rw] data_source_connection_spec
498
512
  # @return [::Google::Cloud::DataCatalog::V1::DataSourceConnectionSpec]
499
513
  # Specification that applies to a data source connection. Valid only
@@ -506,13 +520,14 @@ module Google
506
520
  # @return [::Google::Cloud::DataCatalog::V1::FilesetSpec]
507
521
  # Specification that applies to a fileset resource. Valid only
508
522
  # for entries with the `FILESET` type.
523
+ # @!attribute [rw] service_spec
524
+ # @return [::Google::Cloud::DataCatalog::V1::ServiceSpec]
525
+ # Specification that applies to a Service resource.
509
526
  # @!attribute [rw] display_name
510
527
  # @return [::String]
511
528
  # Display name of an entry.
512
529
  #
513
- # The name must contain only Unicode letters, numbers (0-9), underscores (_),
514
- # dashes (-), spaces ( ), and can't start or end with spaces.
515
- # The maximum size is 200 bytes when encoded in UTF-8.
530
+ # The maximum size is 500 bytes when encoded in UTF-8.
516
531
  # Default value is an empty string.
517
532
  # @!attribute [rw] description
518
533
  # @return [::String]
@@ -553,7 +568,8 @@ module Google
553
568
  # Output only. Physical location of the entry.
554
569
  # @!attribute [r] personal_details
555
570
  # @return [::Google::Cloud::DataCatalog::V1::PersonalDetails]
556
- # Output only. Additional information related to the entry. Private to the current user.
571
+ # Output only. Additional information related to the entry. Private to the
572
+ # current user.
557
573
  class Entry
558
574
  include ::Google::Protobuf::MessageExts
559
575
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -577,10 +593,41 @@ module Google
577
593
  # @return [::Google::Cloud::DataCatalog::V1::DataplexTableSpec]
578
594
  # Output only. Fields specific to a Dataplex table and present only in the
579
595
  # Dataplex table entries.
596
+ # @!attribute [rw] database_view_spec
597
+ # @return [::Google::Cloud::DataCatalog::V1::DatabaseTableSpec::DatabaseViewSpec]
598
+ # Spec what aplies to tables that are actually views.
599
+ # Not set for "real" tables.
580
600
  class DatabaseTableSpec
581
601
  include ::Google::Protobuf::MessageExts
582
602
  extend ::Google::Protobuf::MessageExts::ClassMethods
583
603
 
604
+ # Specification that applies to database view.
605
+ # @!attribute [rw] view_type
606
+ # @return [::Google::Cloud::DataCatalog::V1::DatabaseTableSpec::DatabaseViewSpec::ViewType]
607
+ # Type of this view.
608
+ # @!attribute [rw] base_table
609
+ # @return [::String]
610
+ # Name of a singular table this view reflects one to one.
611
+ # @!attribute [rw] sql_query
612
+ # @return [::String]
613
+ # SQL query used to generate this view.
614
+ class DatabaseViewSpec
615
+ include ::Google::Protobuf::MessageExts
616
+ extend ::Google::Protobuf::MessageExts::ClassMethods
617
+
618
+ # Concrete type of the view.
619
+ module ViewType
620
+ # Default unknown view type.
621
+ VIEW_TYPE_UNSPECIFIED = 0
622
+
623
+ # Standard view.
624
+ STANDARD_VIEW = 1
625
+
626
+ # Materialized view.
627
+ MATERIALIZED_VIEW = 2
628
+ end
629
+ end
630
+
584
631
  # Type of the table.
585
632
  module TableType
586
633
  # Default unknown table type.
@@ -691,6 +738,117 @@ module Google
691
738
  end
692
739
  end
693
740
 
741
+ # Specification that applies to
742
+ # entries that are part `SQL_DATABASE` system
743
+ # (user_specified_type)
744
+ # @!attribute [rw] sql_engine
745
+ # @return [::String]
746
+ # SQL Database Engine.
747
+ # enum SqlEngine {
748
+ # UNDEFINED = 0;
749
+ # MY_SQL = 1;
750
+ # POSTGRE_SQL = 2;
751
+ # SQL_SERVER = 3;
752
+ # }
753
+ # Engine of the enclosing database instance.
754
+ # @!attribute [rw] database_version
755
+ # @return [::String]
756
+ # Version of the database engine.
757
+ # @!attribute [rw] instance_host
758
+ # @return [::String]
759
+ # Host of the SQL database
760
+ # enum InstanceHost {
761
+ # UNDEFINED = 0;
762
+ # SELF_HOSTED = 1;
763
+ # CLOUD_SQL = 2;
764
+ # AMAZON_RDS = 3;
765
+ # AZURE_SQL = 4;
766
+ # }
767
+ # Host of the enclousing database instance.
768
+ class SqlDatabaseSystemSpec
769
+ include ::Google::Protobuf::MessageExts
770
+ extend ::Google::Protobuf::MessageExts::ClassMethods
771
+ end
772
+
773
+ # Specification that applies to
774
+ # entries that are part `LOOKER` system
775
+ # (user_specified_type)
776
+ # @!attribute [rw] parent_instance_id
777
+ # @return [::String]
778
+ # ID of the parent Looker Instance. Empty if it does not exist.
779
+ # Example value: `someinstance.looker.com`
780
+ # @!attribute [rw] parent_instance_display_name
781
+ # @return [::String]
782
+ # Name of the parent Looker Instance. Empty if it does not exist.
783
+ # @!attribute [rw] parent_model_id
784
+ # @return [::String]
785
+ # ID of the parent Model. Empty if it does not exist.
786
+ # @!attribute [rw] parent_model_display_name
787
+ # @return [::String]
788
+ # Name of the parent Model. Empty if it does not exist.
789
+ # @!attribute [rw] parent_view_id
790
+ # @return [::String]
791
+ # ID of the parent View. Empty if it does not exist.
792
+ # @!attribute [rw] parent_view_display_name
793
+ # @return [::String]
794
+ # Name of the parent View. Empty if it does not exist.
795
+ class LookerSystemSpec
796
+ include ::Google::Protobuf::MessageExts
797
+ extend ::Google::Protobuf::MessageExts::ClassMethods
798
+ end
799
+
800
+ # Specification that applies to
801
+ # all entries that are part of `CLOUD_BIGTABLE` system
802
+ # (user_specified_type)
803
+ # @!attribute [rw] instance_display_name
804
+ # @return [::String]
805
+ # Display name of the Instance. This is user specified and different from
806
+ # the resource name.
807
+ class CloudBigtableSystemSpec
808
+ include ::Google::Protobuf::MessageExts
809
+ extend ::Google::Protobuf::MessageExts::ClassMethods
810
+ end
811
+
812
+ # Specification that applies to Instance
813
+ # entries that are part of `CLOUD_BIGTABLE` system.
814
+ # (user_specified_type)
815
+ # @!attribute [rw] cloud_bigtable_cluster_specs
816
+ # @return [::Array<::Google::Cloud::DataCatalog::V1::CloudBigtableInstanceSpec::CloudBigtableClusterSpec>]
817
+ # The list of clusters for the Instance.
818
+ class CloudBigtableInstanceSpec
819
+ include ::Google::Protobuf::MessageExts
820
+ extend ::Google::Protobuf::MessageExts::ClassMethods
821
+
822
+ # Spec that applies to clusters of an Instance of Cloud Bigtable.
823
+ # @!attribute [rw] display_name
824
+ # @return [::String]
825
+ # Name of the cluster.
826
+ # @!attribute [rw] location
827
+ # @return [::String]
828
+ # Location of the cluster, typically a Cloud zone.
829
+ # @!attribute [rw] type
830
+ # @return [::String]
831
+ # Type of the resource. For a cluster this would be "CLUSTER".
832
+ # @!attribute [rw] linked_resource
833
+ # @return [::String]
834
+ # A link back to the parent resource, in this case Instance.
835
+ class CloudBigtableClusterSpec
836
+ include ::Google::Protobuf::MessageExts
837
+ extend ::Google::Protobuf::MessageExts::ClassMethods
838
+ end
839
+ end
840
+
841
+ # Specification that applies to a Service resource. Valid only
842
+ # for entries with the `SERVICE` type.
843
+ # @!attribute [rw] cloud_bigtable_instance_spec
844
+ # @return [::Google::Cloud::DataCatalog::V1::CloudBigtableInstanceSpec]
845
+ # Specification that applies to Instance entries of `CLOUD_BIGTABLE`
846
+ # system.
847
+ class ServiceSpec
848
+ include ::Google::Protobuf::MessageExts
849
+ extend ::Google::Protobuf::MessageExts::ClassMethods
850
+ end
851
+
694
852
  # Business Context of the entry.
695
853
  # @!attribute [rw] entry_overview
696
854
  # @return [::Google::Cloud::DataCatalog::V1::EntryOverview]
@@ -915,8 +1073,8 @@ module Google
915
1073
  # Required. The template to update.
916
1074
  # @!attribute [rw] update_mask
917
1075
  # @return [::Google::Protobuf::FieldMask]
918
- # Optional. Names of fields whose values to overwrite on an individual field of a tag
919
- # template. The following fields are modifiable:
1076
+ # Optional. Names of fields whose values to overwrite on an individual field
1077
+ # of a tag template. The following fields are modifiable:
920
1078
  #
921
1079
  # * `display_name`
922
1080
  # * `type.enum_type`
@@ -943,7 +1101,8 @@ module Google
943
1101
  # Required. The name of the tag template field.
944
1102
  # @!attribute [rw] new_tag_template_field_id
945
1103
  # @return [::String]
946
- # Required. The new ID of this tag template field. For example, `my_new_field`.
1104
+ # Required. The new ID of this tag template field. For example,
1105
+ # `my_new_field`.
947
1106
  class RenameTagTemplateFieldRequest
948
1107
  include ::Google::Protobuf::MessageExts
949
1108
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -956,7 +1115,8 @@ module Google
956
1115
  # Required. The name of the enum field value.
957
1116
  # @!attribute [rw] new_enum_value_display_name
958
1117
  # @return [::String]
959
- # Required. The new display name of the enum value. For example, `my_new_enum_value`.
1118
+ # Required. The new display name of the enum value. For example,
1119
+ # `my_new_enum_value`.
960
1120
  class RenameTagTemplateFieldEnumValueRequest
961
1121
  include ::Google::Protobuf::MessageExts
962
1122
  extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1012,6 +1172,86 @@ module Google
1012
1172
  extend ::Google::Protobuf::MessageExts::ClassMethods
1013
1173
  end
1014
1174
 
1175
+ # Request message for
1176
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#reconcile_tags ReconcileTags}.
1177
+ # @!attribute [rw] parent
1178
+ # @return [::String]
1179
+ # Required. Name of {::Google::Cloud::DataCatalog::V1::Entry Entry} to be tagged.
1180
+ # @!attribute [rw] tag_template
1181
+ # @return [::String]
1182
+ # Required. The name of the tag template, which is used for reconciliation.
1183
+ # @!attribute [rw] force_delete_missing
1184
+ # @return [::Boolean]
1185
+ # If set to `true`, deletes entry tags related to a tag template
1186
+ # not listed in the tags source from an entry. If set to `false`,
1187
+ # unlisted tags are retained.
1188
+ # @!attribute [rw] tags
1189
+ # @return [::Array<::Google::Cloud::DataCatalog::V1::Tag>]
1190
+ # A list of tags to apply to an entry. A tag can specify a
1191
+ # tag template, which must be the template specified in the
1192
+ # `ReconcileTagsRequest`.
1193
+ # The sole entry and each of its columns must be mentioned at most once.
1194
+ class ReconcileTagsRequest
1195
+ include ::Google::Protobuf::MessageExts
1196
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1197
+ end
1198
+
1199
+ # {::Google::Longrunning::Operation Long-running operation}
1200
+ # response message returned by
1201
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#reconcile_tags ReconcileTags}.
1202
+ # @!attribute [rw] created_tags_count
1203
+ # @return [::Integer]
1204
+ # Number of tags created in the request.
1205
+ # @!attribute [rw] updated_tags_count
1206
+ # @return [::Integer]
1207
+ # Number of tags updated in the request.
1208
+ # @!attribute [rw] deleted_tags_count
1209
+ # @return [::Integer]
1210
+ # Number of tags deleted in the request.
1211
+ class ReconcileTagsResponse
1212
+ include ::Google::Protobuf::MessageExts
1213
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1214
+ end
1215
+
1216
+ # {::Google::Longrunning::Operation Long-running operation}
1217
+ # metadata message returned by the
1218
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#reconcile_tags ReconcileTags}.
1219
+ # @!attribute [rw] state
1220
+ # @return [::Google::Cloud::DataCatalog::V1::ReconcileTagsMetadata::ReconciliationState]
1221
+ # State of the reconciliation operation.
1222
+ # @!attribute [rw] errors
1223
+ # @return [::Google::Protobuf::Map{::String => ::Google::Rpc::Status}]
1224
+ # Maps the name of each tagged column (or empty string for a
1225
+ # sole entry) to tagging operation {::Google::Rpc::Status status}.
1226
+ class ReconcileTagsMetadata
1227
+ include ::Google::Protobuf::MessageExts
1228
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1229
+
1230
+ # @!attribute [rw] key
1231
+ # @return [::String]
1232
+ # @!attribute [rw] value
1233
+ # @return [::Google::Rpc::Status]
1234
+ class ErrorsEntry
1235
+ include ::Google::Protobuf::MessageExts
1236
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1237
+ end
1238
+
1239
+ # Enum holding possible states of the reconciliation operation.
1240
+ module ReconciliationState
1241
+ # Default value. This value is unused.
1242
+ RECONCILIATION_STATE_UNSPECIFIED = 0
1243
+
1244
+ # The reconciliation has been queued and awaits for execution.
1245
+ RECONCILIATION_QUEUED = 1
1246
+
1247
+ # The reconciliation is in progress.
1248
+ RECONCILIATION_IN_PROGRESS = 2
1249
+
1250
+ # The reconciliation has been finished.
1251
+ RECONCILIATION_DONE = 3
1252
+ end
1253
+ end
1254
+
1015
1255
  # Request message for
1016
1256
  # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#list_entries ListEntries}.
1017
1257
  # @!attribute [rw] parent
@@ -1089,6 +1329,74 @@ module Google
1089
1329
  extend ::Google::Protobuf::MessageExts::ClassMethods
1090
1330
  end
1091
1331
 
1332
+ # Request message for
1333
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#import_entries ImportEntries}
1334
+ # method.
1335
+ # @!attribute [rw] parent
1336
+ # @return [::String]
1337
+ # Required. Target entry group for ingested entries.
1338
+ # @!attribute [rw] gcs_bucket_path
1339
+ # @return [::String]
1340
+ # Path to a Cloud Storage bucket that contains a dump ready for ingestion.
1341
+ # @!attribute [rw] job_id
1342
+ # @return [::String]
1343
+ # Optional. (Optional) Dataplex task job id, if specified will be used as
1344
+ # part of ImportEntries LRO ID
1345
+ class ImportEntriesRequest
1346
+ include ::Google::Protobuf::MessageExts
1347
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1348
+ end
1349
+
1350
+ # Response message for {::Google::Longrunning::Operation long-running operation}
1351
+ # returned by the
1352
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#import_entries ImportEntries}.
1353
+ # @!attribute [rw] upserted_entries_count
1354
+ # @return [::Integer]
1355
+ # Cumulative number of entries created and entries updated as a result of
1356
+ # import operation.
1357
+ # @!attribute [rw] deleted_entries_count
1358
+ # @return [::Integer]
1359
+ # Number of entries deleted as a result of import operation.
1360
+ class ImportEntriesResponse
1361
+ include ::Google::Protobuf::MessageExts
1362
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1363
+ end
1364
+
1365
+ # Metadata message for {::Google::Longrunning::Operation long-running operation}
1366
+ # returned by the
1367
+ # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#import_entries ImportEntries}.
1368
+ # @!attribute [rw] state
1369
+ # @return [::Google::Cloud::DataCatalog::V1::ImportEntriesMetadata::ImportState]
1370
+ # State of the import operation.
1371
+ # @!attribute [rw] errors
1372
+ # @return [::Array<::Google::Rpc::Status>]
1373
+ # Partial errors that are encountered during the ImportEntries operation.
1374
+ # There is no guarantee that all the encountered errors are reported.
1375
+ # However, if no errors are reported, it means that no errors were
1376
+ # encountered.
1377
+ class ImportEntriesMetadata
1378
+ include ::Google::Protobuf::MessageExts
1379
+ extend ::Google::Protobuf::MessageExts::ClassMethods
1380
+
1381
+ # Enum holding possible states of the import operation.
1382
+ module ImportState
1383
+ # Default value. This value is unused.
1384
+ IMPORT_STATE_UNSPECIFIED = 0
1385
+
1386
+ # The dump with entries has been queued for import.
1387
+ IMPORT_QUEUED = 1
1388
+
1389
+ # The import of entries is in progress.
1390
+ IMPORT_IN_PROGRESS = 2
1391
+
1392
+ # The import of entries has been finished.
1393
+ IMPORT_DONE = 3
1394
+
1395
+ # The import of entries has been abandoned in favor of a newer request.
1396
+ IMPORT_OBSOLETE = 4
1397
+ end
1398
+ end
1399
+
1092
1400
  # Request message for
1093
1401
  # {::Google::Cloud::DataCatalog::V1::DataCatalog::Client#modify_entry_overview ModifyEntryOverview}.
1094
1402
  # @!attribute [rw] name
@@ -1159,6 +1467,24 @@ module Google
1159
1467
 
1160
1468
  # A service, for example, a Dataproc Metastore service.
1161
1469
  SERVICE = 14
1470
+
1471
+ # Schema within a relational database.
1472
+ DATABASE_SCHEMA = 15
1473
+
1474
+ # A Dashboard, for example from Looker.
1475
+ DASHBOARD = 16
1476
+
1477
+ # A Looker Explore.
1478
+ #
1479
+ # For more information, see [Looker Explore API]
1480
+ # (https://developers.looker.com/api/explorer/4.0/methods/LookmlModel/lookml_model_explore).
1481
+ EXPLORE = 17
1482
+
1483
+ # A Looker Look.
1484
+ #
1485
+ # For more information, see [Looker Look API]
1486
+ # (https://developers.looker.com/api/explorer/4.0/methods/Look).
1487
+ LOOK = 18
1162
1488
  end
1163
1489
  end
1164
1490
  end
@@ -0,0 +1,53 @@
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 V1
24
+ # Wrapper containing Entry and information about Tags
25
+ # that should and should not be attached to it.
26
+ # @!attribute [rw] v1_entry
27
+ # @return [::Google::Cloud::DataCatalog::V1::Entry]
28
+ # Non-encrypted Data Catalog v1 Entry.
29
+ # @!attribute [rw] present_tags
30
+ # @return [::Array<::Google::Cloud::DataCatalog::V1::Tag>]
31
+ # Optional. Tags that should be ingested into the Data Catalog.
32
+ # Caller should populate template name, column and fields.
33
+ # @!attribute [rw] absent_tags
34
+ # @return [::Array<::Google::Cloud::DataCatalog::V1::Tag>]
35
+ # Optional. Tags that should be deleted from the Data Catalog.
36
+ # Caller should populate template name and column only.
37
+ class TaggedEntry
38
+ include ::Google::Protobuf::MessageExts
39
+ extend ::Google::Protobuf::MessageExts::ClassMethods
40
+ end
41
+
42
+ # Wrapper for any item that can be contained in the dump.
43
+ # @!attribute [rw] tagged_entry
44
+ # @return [::Google::Cloud::DataCatalog::V1::TaggedEntry]
45
+ # Entry and its tags.
46
+ class DumpItem
47
+ include ::Google::Protobuf::MessageExts
48
+ extend ::Google::Protobuf::MessageExts::ClassMethods
49
+ end
50
+ end
51
+ end
52
+ end
53
+ end
@@ -68,7 +68,8 @@ module Google
68
68
  # Required. Full file path. Example: `gs://bucket_name/a/b.txt`.
69
69
  # @!attribute [r] gcs_timestamps
70
70
  # @return [::Google::Cloud::DataCatalog::V1::SystemTimestamps]
71
- # Output only. Creation, modification, and expiration timestamps of a Cloud Storage file.
71
+ # Output only. Creation, modification, and expiration timestamps of a Cloud
72
+ # Storage file.
72
73
  # @!attribute [r] size_bytes
73
74
  # @return [::Integer]
74
75
  # Output only. File size in bytes.
@@ -74,12 +74,29 @@ module Google
74
74
  # Output only. Creation and modification timestamps of this taxonomy.
75
75
  # @!attribute [rw] activated_policy_types
76
76
  # @return [::Array<::Google::Cloud::DataCatalog::V1::Taxonomy::PolicyType>]
77
- # Optional. A list of policy types that are activated for this taxonomy. If not set,
78
- # defaults to an empty list.
77
+ # Optional. A list of policy types that are activated for this taxonomy. If
78
+ # not set, defaults to an empty list.
79
+ # @!attribute [r] service
80
+ # @return [::Google::Cloud::DataCatalog::V1::Taxonomy::Service]
81
+ # Output only. Identity of the service which owns the Taxonomy. This field is
82
+ # only populated when the taxonomy is created by a Google Cloud service.
83
+ # Currently only 'DATAPLEX' is supported.
79
84
  class Taxonomy
80
85
  include ::Google::Protobuf::MessageExts
81
86
  extend ::Google::Protobuf::MessageExts::ClassMethods
82
87
 
88
+ # The source system of the Taxonomy.
89
+ # @!attribute [rw] name
90
+ # @return [::Google::Cloud::DataCatalog::V1::ManagingSystem]
91
+ # The Google Cloud service name.
92
+ # @!attribute [rw] identity
93
+ # @return [::String]
94
+ # The service agent for the service.
95
+ class Service
96
+ include ::Google::Protobuf::MessageExts
97
+ extend ::Google::Protobuf::MessageExts::ClassMethods
98
+ end
99
+
83
100
  # Defines policy types where the policy tags can be used for.
84
101
  module PolicyType
85
102
  # Unspecified policy type.
@@ -196,6 +213,10 @@ module Google
196
213
  # the first page is returned.
197
214
  #
198
215
  # The token is returned in the response to a previous list request.
216
+ # @!attribute [rw] filter
217
+ # @return [::String]
218
+ # Supported field for filter is 'service' and value is 'dataplex'.
219
+ # Eg: service=dataplex.
199
220
  class ListTaxonomiesRequest
200
221
  include ::Google::Protobuf::MessageExts
201
222
  extend ::Google::Protobuf::MessageExts::ClassMethods