feat: [dataplex] Allow Data Documentation DataScans to support BigQuery Dataset resources in addition to BigQuery table resources (#8012)

* feat: Allow Data Documentation DataScans to support BigQuery Dataset resources in addition to BigQuery table resources
docs: A comment for message `DataDocumentationResult` is changed
docs: A comment for field `table_result` in message `.google.cloud.dataplex.v1.DataDocumentationResult` is changed

PiperOrigin-RevId: 897564665

Source-Link: googleapis/googleapis@1991351

Source-Link: googleapis/googleapis-gen@d4365b2
Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLWRhdGFwbGV4Ly5Pd2xCb3QueWFtbCIsImgiOiJkNDM2NWIyODM2ZGFhOWMwODhkNTk4ZjYxNTczOThmMDQzZDg4ZDMzIn0=

* 🦉 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>

Author: gcf-owl-bot[bot]

packages/google-cloud-dataplex/.eslintrc.json

@@ -1,3 +1,4 @@
 {
-  "extends": "./node_modules/gts"
+  "extends": "./node_modules/gts",
+  "root": true
 }

packages/google-cloud-dataplex/protos/google/cloud/dataplex/v1/data_documentation.proto

@@ -55,7 +55,21 @@ message DataDocumentationSpec {
 
 // The output of a DataDocumentation scan.
 message DataDocumentationResult {
-  // Generated metadata about the table.
+  // Insights for a dataset resource.
+  message DatasetResult {
+    // Output only. Generated Dataset description.
+    string overview = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Relationships suggesting how tables in the dataset are
+    // related to each other, based on their schema.
+    repeated SchemaRelationship schema_relationships = 3
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Sample SQL queries for the dataset.
+    repeated Query queries = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
+  // Insights for a table resource.
   message TableResult {
     // Output only. The service-qualified full resource name of the cloud
     // resource. Ex:
@@ -73,6 +87,69 @@ message DataDocumentationResult {
     repeated Query queries = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
   }
 
+  // Details of the relationship between the schema of two resources.
+  message SchemaRelationship {
+    // Source which generated the schema relation edge.
+    enum Source {
+      // The source of the schema relationship is unspecified.
+      SOURCE_UNSPECIFIED = 0;
+
+      // The source of the schema relationship is agent.
+      AGENT = 4;
+
+      // The source of the schema relationship is query history from the source
+      // system.
+      QUERY_HISTORY = 5;
+
+      // The source of the schema relationship is table constraints added in
+      // the source system.
+      TABLE_CONSTRAINTS = 6;
+    }
+
+    // The type of relationship.
+    enum Type {
+      // The type of the schema relationship is unspecified.
+      TYPE_UNSPECIFIED = 0;
+
+      // Indicates a join relationship between the schema fields.
+      SCHEMA_JOIN = 1;
+    }
+
+    // Represents an ordered set of paths within a table's schema.
+    message SchemaPaths {
+      // Output only. The service-qualified full resource name of the table
+      // Ex:
+      // //bigquery.googleapis.com/projects/PROJECT_ID/datasets/DATASET_ID/tables/TABLE_ID
+      string table_fqn = 1 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+      // Output only. An ordered set of Paths to fields within the schema of the
+      // table. For fields nested within a top level field of type record, use
+      // '.' to separate field names. Examples: Top level field - `top_level`
+      // Nested field - `top_level.child.sub_field`
+      repeated string paths = 2 [(google.api.field_behavior) = OUTPUT_ONLY];
+    }
+
+    // Output only. An ordered list of fields for the join from the first table.
+    // The size of this list must be the same as `right_schema_paths`.
+    // Each field at index i in this list must correspond to a field at the same
+    // index in the `right_schema_paths` list.
+    SchemaPaths left_schema_paths = 1
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. An ordered list of fields for the join from the second
+    // table. The size of this list must be the same as `left_schema_paths`.
+    // Each field at index i in this list must correspond to a field at the same
+    // index in the `left_schema_paths` list.
+    SchemaPaths right_schema_paths = 2
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Sources which generated the schema relation edge.
+    repeated Source sources = 4 [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. The type of relationship between the schema paths.
+    Type type = 6 [(google.api.field_behavior) = OUTPUT_ONLY];
+  }
+
   // A sample SQL query in data documentation.
   message Query {
     // Output only. The SQL query string which can be executed.
@@ -102,7 +179,11 @@ message DataDocumentationResult {
 
   // The result of the data documentation scan.
   oneof result {
-    // Output only. Table result for insights.
+    // Output only. Insights for a Dataset resource.
+    DatasetResult dataset_result = 7
+        [(google.api.field_behavior) = OUTPUT_ONLY];
+
+    // Output only. Insights for a Table resource.
     TableResult table_result = 8 [(google.api.field_behavior) = OUTPUT_ONLY];
   }
 }