chore: cleanup; annotations updates; adding missing imports (#395)

* build: add LRO mixin to datacatalog

PiperOrigin-RevId: 489512915

Source-Link: googleapis/googleapis@b6c4881

Source-Link: googleapis/googleapis-gen@1289011
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTI4OTAxMTMxOTM4NGVmOWEzNWVjMDhkMjRlODk5MjgyYjk5OGYwMCJ9

docs: documentation updates
chore: cleanup; annotations updates; adding missing imports

PiperOrigin-RevId: 486612860

Source-Link: googleapis/googleapis@a6efcc9

Source-Link: googleapis/googleapis-gen@1584a15
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMTU4NGExNTJhYzM4NGM5ZjY3ZDZiZGI3ZTExZDEwNTgxZjFiMjM0MSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* build: set mixins to "none"

PiperOrigin-RevId: 489578716

Source-Link: googleapis/googleapis@8bd04ef

Source-Link: googleapis/googleapis-gen@f96fe8f
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZjk2ZmU4ZjU1ZTMzNDFhYWZkZTZhNDUwZDUzYjBiODgxYzNmZTg0ZiJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1/bigquery.proto

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.datacatalog.v1;
 
+import "google/api/field_behavior.proto";
 
 option cc_enable_arenas = true;
 option csharp_namespace = "Google.Cloud.DataCatalog.V1";

packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1/datacatalog.proto

@@ -1035,16 +1035,16 @@ message Entry {
     // for entries with the `FILESET` type.
     GcsFilesetSpec gcs_fileset_spec = 6;
 
-    // Specification that applies to a BigQuery table. Valid only for
-    // entries with the `TABLE` type.
-    BigQueryTableSpec bigquery_table_spec = 12;
+    // Output only. Specification that applies to a BigQuery table. Valid only
+    // for entries with the `TABLE` type.
+    BigQueryTableSpec bigquery_table_spec = 12 [(google.api.field_behavior) = OUTPUT_ONLY];
 
-    // Specification for a group of BigQuery tables with the `[prefix]YYYYMMDD`
-    // name pattern.
+    // Output only. Specification for a group of BigQuery tables with
+    // the `[prefix]YYYYMMDD` name pattern.
     //
     // For more information, see [Introduction to partitioned tables]
     // (https://cloud.google.com/bigquery/docs/partitioned-tables#partitioning_versus_sharding).
-    BigQueryDateShardedSpec bigquery_date_sharded_spec = 15;
+    BigQueryDateShardedSpec bigquery_date_sharded_spec = 15 [(google.api.field_behavior) = OUTPUT_ONLY];
   }
 
   // Type- and system-specific information. Specifications for types contain
@@ -1098,13 +1098,13 @@ message Entry {
   // Timestamps from the underlying resource, not from the Data Catalog
   // entry.
   //
-  // Output only when the entry has a type listed in the `EntryType` enum.
-  // For entries with `user_specified_type`, this field is optional and defaults
-  // to an empty timestamp.
+  // Output only when the entry has a system listed in the `IntegratedSystem`
+  // enum. For entries with `user_specified_system`, this field is optional
+  // and defaults to an empty timestamp.
   SystemTimestamps source_system_timestamps = 7;
 
-  // Output only. Resource usage statistics.
-  UsageSignal usage_signal = 13 [(google.api.field_behavior) = OUTPUT_ONLY];
+  // Resource usage statistics.
+  UsageSignal usage_signal = 13;
 
   // Cloud labels attached to the entry.
   //
@@ -1138,9 +1138,9 @@ message DatabaseTableSpec {
   // Type of this table.
   TableType type = 1;
 
-  // Fields specific to a Dataplex table and present only in the Dataplex table
-  // entries.
-  DataplexTableSpec dataplex_table = 2;
+  // Output only. Fields specific to a Dataplex table and present only in the
+  // Dataplex table entries.
+  DataplexTableSpec dataplex_table = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }
 
 // Specification that applies to a fileset. Valid only for entries with the
@@ -1153,8 +1153,10 @@ message FilesetSpec {
 
 // Specification that applies to a data source connection. Valid only for
 // entries with the `DATA_SOURCE_CONNECTION` type.
+// Only one of internal specs can be set at the time, and cannot
+// be changed later.
 message DataSourceConnectionSpec {
-  // Fields specific to BigQuery connections.
+  // Output only. Fields specific to BigQuery connections.
   BigQueryConnectionSpec bigquery_connection_spec = 1;
 }
 
@@ -1667,7 +1669,7 @@ enum EntryType {
   // Default unknown type.
   ENTRY_TYPE_UNSPECIFIED = 0;
 
-  // Output only. The entry type that has a GoogleSQL schema, including
+  // The entry type that has a GoogleSQL schema, including
   // logical views.
   TABLE = 2;
 

packages/google-cloud-datacatalog/protos/google/cloud/datacatalog/v1/usage.proto

@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.datacatalog.v1;
 
+import "google/api/field_behavior.proto";
 import "google/protobuf/timestamp.proto";
 
 option cc_enable_arenas = true;
@@ -58,8 +59,8 @@ message UsageSignal {
   // The end timestamp of the duration of usage statistics.
   google.protobuf.Timestamp update_time = 1;
 
-  // Usage statistics over each of the predefined time ranges.
+  // Output only. BigQuery usage statistics over each of the predefined time ranges.
   //
   // Supported time ranges are `{"24H", "7D", "30D"}`.
-  map<string, UsageStats> usage_within_time_range = 2;
+  map<string, UsageStats> usage_within_time_range = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
 }