diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/async_client.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/async_client.py index 14440363674a..72b33e0b6a47 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/async_client.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/async_client.py @@ -235,7 +235,7 @@ async def search_catalog( Optional. The query string with a minimum of 3 characters and specific syntax. For more information, see `Data Catalog search - syntax `__. + syntax `__. An empty query string returns all data assets (in the specified scope) that you have access to. @@ -1269,6 +1269,10 @@ async def list_entries( ) -> pagers.ListEntriesAsyncPager: r"""Lists entries. + Note: Currently, this method can list only custom entries. To + get a list of both custom and automatically created entries, use + [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog]. + Args: request (Union[google.cloud.datacatalog_v1.types.ListEntriesRequest, dict]): The request object. Request message for @@ -1570,14 +1574,20 @@ async def update_tag_template( should not be set. update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`): Names of fields whose values to overwrite on a tag - template. Currently, only ``display_name`` can be - overwritten. + template. Currently, only ``display_name`` and + ``is_publicly_readable`` can be overwritten. If this parameter is absent or empty, all modifiable fields are overwritten. If such fields are non-required and omitted in the request body, their values are emptied. + Note: Updating the ``is_publicly_readable`` field may + require up to 12 hours to take effect in search results. + Additionally, it also requires the + ``tagTemplates.getIamPolicy`` and + ``tagTemplates.setIamPolicy`` permissions. + This corresponds to the ``update_mask`` field on the ``request`` instance; if ``request`` is provided, this should not be set. @@ -1964,7 +1974,7 @@ async def rename_tag_template_field( [RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField]. name (:class:`str`): Required. The name of the tag - template. + template field. This corresponds to the ``name`` field on the ``request`` instance; if ``request`` is provided, this diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/client.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/client.py index cba5d7a5ba97..2070ca22523b 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/client.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/client.py @@ -505,7 +505,7 @@ def search_catalog( Optional. The query string with a minimum of 3 characters and specific syntax. For more information, see `Data Catalog search - syntax `__. + syntax `__. An empty query string returns all data assets (in the specified scope) that you have access to. @@ -1495,6 +1495,10 @@ def list_entries( ) -> pagers.ListEntriesPager: r"""Lists entries. + Note: Currently, this method can list only custom entries. To + get a list of both custom and automatically created entries, use + [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog]. + Args: request (Union[google.cloud.datacatalog_v1.types.ListEntriesRequest, dict]): The request object. Request message for @@ -1787,14 +1791,20 @@ def update_tag_template( should not be set. update_mask (google.protobuf.field_mask_pb2.FieldMask): Names of fields whose values to overwrite on a tag - template. Currently, only ``display_name`` can be - overwritten. + template. Currently, only ``display_name`` and + ``is_publicly_readable`` can be overwritten. If this parameter is absent or empty, all modifiable fields are overwritten. If such fields are non-required and omitted in the request body, their values are emptied. + Note: Updating the ``is_publicly_readable`` field may + require up to 12 hours to take effect in search results. + Additionally, it also requires the + ``tagTemplates.getIamPolicy`` and + ``tagTemplates.setIamPolicy`` permissions. + This corresponds to the ``update_mask`` field on the ``request`` instance; if ``request`` is provided, this should not be set. @@ -2185,7 +2195,7 @@ def rename_tag_template_field( [RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField]. name (str): Required. The name of the tag - template. + template field. This corresponds to the ``name`` field on the ``request`` instance; if ``request`` is provided, this diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc.py index 4ecaeb9b52e3..7f088d80dff0 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc.py @@ -608,6 +608,10 @@ def list_entries( Lists entries. + Note: Currently, this method can list only custom entries. To + get a list of both custom and automatically created entries, use + [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog]. + Returns: Callable[[~.ListEntriesRequest], ~.ListEntriesResponse]: diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc_asyncio.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc_asyncio.py index 9836b2a12722..d589e7e9d538 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc_asyncio.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc_asyncio.py @@ -621,6 +621,10 @@ def list_entries( Lists entries. + Note: Currently, this method can list only custom entries. To + get a list of both custom and automatically created entries, use + [SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog]. + Returns: Callable[[~.ListEntriesRequest], Awaitable[~.ListEntriesResponse]]: diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/async_client.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/async_client.py index 9488330ff92f..cb7aa44a3d24 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/async_client.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/async_client.py @@ -600,7 +600,7 @@ async def create_policy_tag( parent (:class:`str`): Required. Resource name of the taxonomy that the policy tag will belong - to.

+ to. This corresponds to the ``parent`` field on the ``request`` instance; if ``request`` is provided, this diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/client.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/client.py index 8c3f131e6277..bdea63d3e54e 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/client.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/client.py @@ -805,7 +805,7 @@ def create_policy_tag( parent (str): Required. Resource name of the taxonomy that the policy tag will belong - to.

+ to. This corresponds to the ``parent`` field on the ``request`` instance; if ``request`` is provided, this diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/datacatalog.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/datacatalog.py index 3d77aab0880d..bab9fa596e3c 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/datacatalog.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/datacatalog.py @@ -102,7 +102,7 @@ class SearchCatalogRequest(proto.Message): Optional. The query string with a minimum of 3 characters and specific syntax. For more information, see `Data Catalog search - syntax `__. + syntax `__. An empty query string returns all data assets (in the specified scope) that you have access to. @@ -950,11 +950,18 @@ class UpdateTagTemplateRequest(proto.Message): set. update_mask (google.protobuf.field_mask_pb2.FieldMask): Names of fields whose values to overwrite on a tag template. - Currently, only ``display_name`` can be overwritten. + Currently, only ``display_name`` and + ``is_publicly_readable`` can be overwritten. If this parameter is absent or empty, all modifiable fields are overwritten. If such fields are non-required and omitted in the request body, their values are emptied. + + Note: Updating the ``is_publicly_readable`` field may + require up to 12 hours to take effect in search results. + Additionally, it also requires the + ``tagTemplates.getIamPolicy`` and + ``tagTemplates.setIamPolicy`` permissions. """ tag_template = proto.Field(proto.MESSAGE, number=1, message=gcd_tags.TagTemplate,) @@ -1114,7 +1121,7 @@ class RenameTagTemplateFieldRequest(proto.Message): Attributes: name (str): - Required. The name of the tag template. + Required. The name of the tag template field. new_tag_template_field_id (str): Required. The new ID of this tag template field. For example, ``my_new_field``. diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/policytagmanager.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/policytagmanager.py index 623a0af2c8ec..036d6db16839 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/policytagmanager.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/policytagmanager.py @@ -131,7 +131,7 @@ class PolicyTag(proto.Message): Output only. Resource name of this policy tag in the URL format. The policy tag manager generates unique taxonomy - IDs and policy tag IDs.

+ IDs and policy tag IDs. display_name (str): Required. User-defined name of this policy tag. @@ -285,7 +285,7 @@ class CreatePolicyTagRequest(proto.Message): Attributes: parent (str): Required. Resource name of the taxonomy that - the policy tag will belong to.

+ the policy tag will belong to. policy_tag (google.cloud.datacatalog_v1.types.PolicyTag): The policy tag to create. """ diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/search.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/search.py index 186475ee25f7..5ce294940bc5 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/search.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/search.py @@ -105,6 +105,12 @@ class SearchCatalogResult(proto.Message): Example for a DPMS table: ``dataproc_metastore:PROJECT_ID.LOCATION_ID.INSTANCE_ID.DATABASE_ID.TABLE_ID`` + display_name (str): + The display name of the result. + description (str): + Entry description that can consist of several + sentences or paragraphs that describe entry + contents. """ search_result_type = proto.Field(proto.ENUM, number=1, enum="SearchResultType",) @@ -117,6 +123,8 @@ class SearchCatalogResult(proto.Message): ) user_specified_system = proto.Field(proto.STRING, number=9, oneof="system",) fully_qualified_name = proto.Field(proto.STRING, number=10,) + display_name = proto.Field(proto.STRING, number=12,) + description = proto.Field(proto.STRING, number=13,) __all__ = tuple(sorted(__protobuf__.manifest)) diff --git a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/table_spec.py b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/table_spec.py index 295dc842fe67..94849b3c5211 100644 --- a/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/table_spec.py +++ b/packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/table_spec.py @@ -121,11 +121,15 @@ class BigQueryDateShardedSpec(proto.Message): ``table_prefix`` is ``MyTable``. shard_count (int): Output only. Total number of shards. + latest_shard_resource (str): + Output only. BigQuery resource name of the + latest shard. """ dataset = proto.Field(proto.STRING, number=1,) table_prefix = proto.Field(proto.STRING, number=2,) shard_count = proto.Field(proto.INT64, number=3,) + latest_shard_resource = proto.Field(proto.STRING, number=4,) __all__ = tuple(sorted(__protobuf__.manifest))