Skip to content
This repository has been archived by the owner on Sep 5, 2023. It is now read-only.

feat: Added BigQueryDateShardedSpec.latest_shard_resource field #256

Merged
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
18 changes: 14 additions & 4 deletions google/cloud/datacatalog_v1/services/data_catalog/async_client.py
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
syntax </data-catalog/docs/how-to/search-reference>`__.

An empty query string returns all data assets (in the
specified scope) that you have access to.
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand Down
18 changes: 14 additions & 4 deletions google/cloud/datacatalog_v1/services/data_catalog/client.py
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
syntax </data-catalog/docs/how-to/search-reference>`__.

An empty query string returns all data assets (in the
specified scope) that you have access to.
Expand Down Expand Up @@ -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
Expand Down Expand Up @@ -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.
Expand Down Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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]:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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]]:
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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.<br /><br />
to.

This corresponds to the ``parent`` field
on the ``request`` instance; if ``request`` is provided, this
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -805,7 +805,7 @@ def create_policy_tag(
parent (str):
Required. Resource name of the
taxonomy that the policy tag will belong
to.<br /><br />
to.

This corresponds to the ``parent`` field
on the ``request`` instance; if ``request`` is provided, this
Expand Down
13 changes: 10 additions & 3 deletions google/cloud/datacatalog_v1/types/datacatalog.py
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
syntax </data-catalog/docs/how-to/search-reference>`__.

An empty query string returns all data assets (in the
specified scope) that you have access to.
Expand Down Expand Up @@ -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,)
Expand Down Expand Up @@ -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``.
Expand Down
4 changes: 2 additions & 2 deletions google/cloud/datacatalog_v1/types/policytagmanager.py
Original file line number Diff line number Diff line change
Expand Up @@ -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.<br /><br />
IDs and policy tag IDs.
display_name (str):
Required. User-defined name of this policy
tag.
Expand Down Expand Up @@ -285,7 +285,7 @@ class CreatePolicyTagRequest(proto.Message):
Attributes:
parent (str):
Required. Resource name of the taxonomy that
the policy tag will belong to.<br /><br />
the policy tag will belong to.
policy_tag (google.cloud.datacatalog_v1.types.PolicyTag):
The policy tag to create.
"""
Expand Down
8 changes: 8 additions & 0 deletions google/cloud/datacatalog_v1/types/search.py
Original file line number Diff line number Diff line change
Expand Up @@ -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",)
Expand All @@ -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))
4 changes: 4 additions & 0 deletions google/cloud/datacatalog_v1/types/table_spec.py
Original file line number Diff line number Diff line change
Expand Up @@ -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))