feat: new service DataTaxonomyService and related messages (#11512)

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
googleapis · Jul 25, 2023 · 3392532 · 3392532
1 parent d04b14c
commit 3392532
Show file tree

Hide file tree

Showing 73 changed files with 21,041 additions and 117 deletions.
diff --git a/packages/google-cloud-dataplex/.flake8 b/packages/google-cloud-dataplex/.flake8
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright 2020 Google LLC
+# Copyright 2023 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

diff --git a/packages/google-cloud-dataplex/CONTRIBUTING.rst b/packages/google-cloud-dataplex/CONTRIBUTING.rst
@@ -236,7 +236,7 @@ We support:
 
 Supported versions can be found in our ``noxfile.py`` `config`_.
 
-.. _config: https://github.com/googleapis/google-cloud-python/blob/main/noxfile.py
+.. _config: https://github.com/googleapis/google-cloud-python/blob/main/packages/google-cloud-dataplex/noxfile.py
 
 
 **********

diff --git a/packages/google-cloud-dataplex/MANIFEST.in b/packages/google-cloud-dataplex/MANIFEST.in
@@ -1,6 +1,6 @@
 # -*- coding: utf-8 -*-
 #
-# Copyright 2020 Google LLC
+# Copyright 2023 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

diff --git a/packages/google-cloud-dataplex/README.rst b/packages/google-cloud-dataplex/README.rst
@@ -36,21 +36,24 @@ In order to use this library, you first need to go through the following steps:
 Installation
 ~~~~~~~~~~~~
 
-Install this library in a `virtualenv`_ using pip. `virtualenv`_ is a tool to
-create isolated Python environments. The basic problem it addresses is one of
-dependencies and versions, and indirectly permissions.
+Install this library in a virtual environment using `venv`_. `venv`_ is a tool that
+creates isolated Python environments. These isolated environments can have separate
+versions of Python packages, which allows you to isolate one project's dependencies
+from the dependencies of other projects.
 
-With `virtualenv`_, it's possible to install this library without needing system
+With `venv`_, it's possible to install this library without needing system
 install permissions, and without clashing with the installed system
 dependencies.
 
-.. _`virtualenv`: https://virtualenv.pypa.io/en/latest/
+.. _`venv`: https://docs.python.org/3/library/venv.html
 
 
 Code samples and snippets
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Code samples and snippets live in the `samples/` folder.
+Code samples and snippets live in the `samples/`_ folder.
+
+.. _samples/: https://github.com/googleapis/google-cloud-python/tree/main/packages/google-cloud-dataplex/samples
 
 
 Supported Python Versions
@@ -77,21 +80,19 @@ Mac/Linux
 
 .. code-block:: console
 
-    pip install virtualenv
-    virtualenv <your-env>
+    python3 -m venv <your-env>
     source <your-env>/bin/activate
-    <your-env>/bin/pip install google-cloud-dataplex
+    pip install google-cloud-dataplex
 
 
 Windows
 ^^^^^^^
 
 .. code-block:: console
 
-    pip install virtualenv
-    virtualenv <your-env>
-    <your-env>\Scripts\activate
-    <your-env>\Scripts\pip.exe install google-cloud-dataplex
+    py -m venv <your-env>
+    .\<your-env>\Scripts\activate
+    pip install google-cloud-dataplex
 
 Next Steps
 ~~~~~~~~~~

diff --git a/packages/google-cloud-dataplex/docs/conf.py b/packages/google-cloud-dataplex/docs/conf.py
@@ -1,5 +1,5 @@
 # -*- coding: utf-8 -*-
-# Copyright 2021 Google LLC
+# Copyright 2023 Google LLC
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

diff --git a/packages/google-cloud-dataplex/docs/dataplex_v1/data_taxonomy_service.rst b/packages/google-cloud-dataplex/docs/dataplex_v1/data_taxonomy_service.rst
@@ -0,0 +1,10 @@
+DataTaxonomyService
+-------------------------------------
+
+.. automodule:: google.cloud.dataplex_v1.services.data_taxonomy_service
+    :members:
+    :inherited-members:
+
+.. automodule:: google.cloud.dataplex_v1.services.data_taxonomy_service.pagers
+    :members:
+    :inherited-members:
diff --git a/packages/google-cloud-dataplex/docs/dataplex_v1/services.rst b/packages/google-cloud-dataplex/docs/dataplex_v1/services.rst
@@ -6,4 +6,5 @@ Services for Google Cloud Dataplex v1 API
     content_service
     dataplex_service
     data_scan_service
+    data_taxonomy_service
     metadata_service
diff --git a/packages/google-cloud-dataplex/google/cloud/dataplex/__init__.py b/packages/google-cloud-dataplex/google/cloud/dataplex/__init__.py
@@ -30,6 +30,12 @@
 from google.cloud.dataplex_v1.services.data_scan_service.client import (
     DataScanServiceClient,
 )
+from google.cloud.dataplex_v1.services.data_taxonomy_service.async_client import (
+    DataTaxonomyServiceAsyncClient,
+)
+from google.cloud.dataplex_v1.services.data_taxonomy_service.client import (
+    DataTaxonomyServiceClient,
+)
 from google.cloud.dataplex_v1.services.dataplex_service.async_client import (
     DataplexServiceAsyncClient,
 )
@@ -62,6 +68,29 @@
     DataQualityRuleResult,
     DataQualitySpec,
 )
+from google.cloud.dataplex_v1.types.data_taxonomy import (
+    CreateDataAttributeBindingRequest,
+    CreateDataAttributeRequest,
+    CreateDataTaxonomyRequest,
+    DataAttribute,
+    DataAttributeBinding,
+    DataTaxonomy,
+    DeleteDataAttributeBindingRequest,
+    DeleteDataAttributeRequest,
+    DeleteDataTaxonomyRequest,
+    GetDataAttributeBindingRequest,
+    GetDataAttributeRequest,
+    GetDataTaxonomyRequest,
+    ListDataAttributeBindingsRequest,
+    ListDataAttributeBindingsResponse,
+    ListDataAttributesRequest,
+    ListDataAttributesResponse,
+    ListDataTaxonomiesRequest,
+    ListDataTaxonomiesResponse,
+    UpdateDataAttributeBindingRequest,
+    UpdateDataAttributeRequest,
+    UpdateDataTaxonomyRequest,
+)
 from google.cloud.dataplex_v1.types.datascans import (
     CreateDataScanRequest,
     DataScan,
@@ -79,6 +108,7 @@
     UpdateDataScanRequest,
 )
 from google.cloud.dataplex_v1.types.logs import (
+    DataQualityScanRuleResult,
     DataScanEvent,
     DiscoveryEvent,
     JobEvent,
@@ -112,6 +142,7 @@
     State,
     Zone,
 )
+from google.cloud.dataplex_v1.types.security import DataAccessSpec, ResourceAccessSpec
 from google.cloud.dataplex_v1.types.service import (
     CancelJobRequest,
     CreateAssetRequest,
@@ -166,6 +197,8 @@
     "DataplexServiceAsyncClient",
     "DataScanServiceClient",
     "DataScanServiceAsyncClient",
+    "DataTaxonomyServiceClient",
+    "DataTaxonomyServiceAsyncClient",
     "MetadataServiceClient",
     "MetadataServiceAsyncClient",
     "Content",
@@ -184,6 +217,27 @@
     "DataQualityRule",
     "DataQualityRuleResult",
     "DataQualitySpec",
+    "CreateDataAttributeBindingRequest",
+    "CreateDataAttributeRequest",
+    "CreateDataTaxonomyRequest",
+    "DataAttribute",
+    "DataAttributeBinding",
+    "DataTaxonomy",
+    "DeleteDataAttributeBindingRequest",
+    "DeleteDataAttributeRequest",
+    "DeleteDataTaxonomyRequest",
+    "GetDataAttributeBindingRequest",
+    "GetDataAttributeRequest",
+    "GetDataTaxonomyRequest",
+    "ListDataAttributeBindingsRequest",
+    "ListDataAttributeBindingsResponse",
+    "ListDataAttributesRequest",
+    "ListDataAttributesResponse",
+    "ListDataTaxonomiesRequest",
+    "ListDataTaxonomiesResponse",
+    "UpdateDataAttributeBindingRequest",
+    "UpdateDataAttributeRequest",
+    "UpdateDataTaxonomyRequest",
     "CreateDataScanRequest",
     "DataScan",
     "DataScanJob",
@@ -198,6 +252,7 @@
     "RunDataScanResponse",
     "UpdateDataScanRequest",
     "DataScanType",
+    "DataQualityScanRuleResult",
     "DataScanEvent",
     "DiscoveryEvent",
     "JobEvent",
@@ -228,6 +283,8 @@
     "Lake",
     "Zone",
     "State",
+    "DataAccessSpec",
+    "ResourceAccessSpec",
     "CancelJobRequest",
     "CreateAssetRequest",
     "CreateEnvironmentRequest",

diff --git a/packages/google-cloud-dataplex/google/cloud/dataplex_v1/__init__.py b/packages/google-cloud-dataplex/google/cloud/dataplex_v1/__init__.py
@@ -23,6 +23,10 @@
     DataScanServiceAsyncClient,
     DataScanServiceClient,
 )
+from .services.data_taxonomy_service import (
+    DataTaxonomyServiceAsyncClient,
+    DataTaxonomyServiceClient,
+)
 from .services.dataplex_service import DataplexServiceAsyncClient, DataplexServiceClient
 from .services.metadata_service import MetadataServiceAsyncClient, MetadataServiceClient
 from .types.analyze import Content, Environment, Session
@@ -42,6 +46,29 @@
     DataQualityRuleResult,
     DataQualitySpec,
 )
+from .types.data_taxonomy import (
+    CreateDataAttributeBindingRequest,
+    CreateDataAttributeRequest,
+    CreateDataTaxonomyRequest,
+    DataAttribute,
+    DataAttributeBinding,
+    DataTaxonomy,
+    DeleteDataAttributeBindingRequest,
+    DeleteDataAttributeRequest,
+    DeleteDataTaxonomyRequest,
+    GetDataAttributeBindingRequest,
+    GetDataAttributeRequest,
+    GetDataTaxonomyRequest,
+    ListDataAttributeBindingsRequest,
+    ListDataAttributeBindingsResponse,
+    ListDataAttributesRequest,
+    ListDataAttributesResponse,
+    ListDataTaxonomiesRequest,
+    ListDataTaxonomiesResponse,
+    UpdateDataAttributeBindingRequest,
+    UpdateDataAttributeRequest,
+    UpdateDataTaxonomyRequest,
+)
 from .types.datascans import (
     CreateDataScanRequest,
     DataScan,
@@ -58,7 +85,13 @@
     RunDataScanResponse,
     UpdateDataScanRequest,
 )
-from .types.logs import DataScanEvent, DiscoveryEvent, JobEvent, SessionEvent
+from .types.logs import (
+    DataQualityScanRuleResult,
+    DataScanEvent,
+    DiscoveryEvent,
+    JobEvent,
+    SessionEvent,
+)
 from .types.metadata_ import (
     CreateEntityRequest,
     CreatePartitionRequest,
@@ -80,6 +113,7 @@
 )
 from .types.processing import DataSource, ScannedData, Trigger
 from .types.resources import Action, Asset, AssetStatus, Lake, State, Zone
+from .types.security import DataAccessSpec, ResourceAccessSpec
 from .types.service import (
     CancelJobRequest,
     CreateAssetRequest,
@@ -130,6 +164,7 @@
 __all__ = (
     "ContentServiceAsyncClient",
     "DataScanServiceAsyncClient",
+    "DataTaxonomyServiceAsyncClient",
     "DataplexServiceAsyncClient",
     "MetadataServiceAsyncClient",
     "Action",
@@ -140,30 +175,42 @@
     "ContentServiceClient",
     "CreateAssetRequest",
     "CreateContentRequest",
+    "CreateDataAttributeBindingRequest",
+    "CreateDataAttributeRequest",
     "CreateDataScanRequest",
+    "CreateDataTaxonomyRequest",
     "CreateEntityRequest",
     "CreateEnvironmentRequest",
     "CreateLakeRequest",
     "CreatePartitionRequest",
     "CreateTaskRequest",
     "CreateZoneRequest",
+    "DataAccessSpec",
+    "DataAttribute",
+    "DataAttributeBinding",
     "DataProfileResult",
     "DataProfileSpec",
     "DataQualityDimensionResult",
     "DataQualityResult",
     "DataQualityRule",
     "DataQualityRuleResult",
+    "DataQualityScanRuleResult",
     "DataQualitySpec",
     "DataScan",
     "DataScanEvent",
     "DataScanJob",
     "DataScanServiceClient",
     "DataScanType",
     "DataSource",
+    "DataTaxonomy",
+    "DataTaxonomyServiceClient",
     "DataplexServiceClient",
     "DeleteAssetRequest",
     "DeleteContentRequest",
+    "DeleteDataAttributeBindingRequest",
+    "DeleteDataAttributeRequest",
     "DeleteDataScanRequest",
+    "DeleteDataTaxonomyRequest",
     "DeleteEntityRequest",
     "DeleteEnvironmentRequest",
     "DeleteLakeRequest",
@@ -175,8 +222,11 @@
     "Environment",
     "GetAssetRequest",
     "GetContentRequest",
+    "GetDataAttributeBindingRequest",
+    "GetDataAttributeRequest",
     "GetDataScanJobRequest",
     "GetDataScanRequest",
+    "GetDataTaxonomyRequest",
     "GetEntityRequest",
     "GetEnvironmentRequest",
     "GetJobRequest",
@@ -193,10 +243,16 @@
     "ListAssetsResponse",
     "ListContentRequest",
     "ListContentResponse",
+    "ListDataAttributeBindingsRequest",
+    "ListDataAttributeBindingsResponse",
+    "ListDataAttributesRequest",
+    "ListDataAttributesResponse",
     "ListDataScanJobsRequest",
     "ListDataScanJobsResponse",
     "ListDataScansRequest",
     "ListDataScansResponse",
+    "ListDataTaxonomiesRequest",
+    "ListDataTaxonomiesResponse",
     "ListEntitiesRequest",
     "ListEntitiesResponse",
     "ListEnvironmentsRequest",
@@ -218,6 +274,7 @@
     "MetadataServiceClient",
     "OperationMetadata",
     "Partition",
+    "ResourceAccessSpec",
     "RunDataScanRequest",
     "RunDataScanResponse",
     "RunTaskRequest",
@@ -234,7 +291,10 @@
     "Trigger",
     "UpdateAssetRequest",
     "UpdateContentRequest",
+    "UpdateDataAttributeBindingRequest",
+    "UpdateDataAttributeRequest",
     "UpdateDataScanRequest",
+    "UpdateDataTaxonomyRequest",
     "UpdateEntityRequest",
     "UpdateEnvironmentRequest",
     "UpdateLakeRequest",