Skip to content

Commit f36a8eb

Browse files
gcf-owl-bot[bot]gcf-owl-bot[bot]
authored
feat: Added BigQueryDateShardedSpec.latest_shard_resource field (#256)
- [ ] Regenerate this pull request now. PiperOrigin-RevId: 408274419 Source-Link: googleapis/googleapis@cbba92c Source-Link: googleapis/googleapis-gen@64b969f Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiNjRiOTY5ZjEyOTlmNTcyZmJiMjY5NTMwY2JjNDU0OTY2YjE0ODUxZCJ9 feat: Added SearchCatalogResult.display_name field feat: Added SearchCatalogResult.description field
1 parent 34a699f commit f36a8eb

10 files changed

Lines changed: 62 additions & 15 deletions

File tree

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/async_client.py‎

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -235,7 +235,7 @@ async def search_catalog(
235235
Optional. The query string with a minimum of 3
236236
characters and specific syntax. For more information,
237237
see `Data Catalog search
238-
syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
238+
syntax </data-catalog/docs/how-to/search-reference>`__.
239239
240240
An empty query string returns all data assets (in the
241241
specified scope) that you have access to.
@@ -1269,6 +1269,10 @@ async def list_entries(
12691269
) -> pagers.ListEntriesAsyncPager:
12701270
r"""Lists entries.
12711271
1272+
Note: Currently, this method can list only custom entries. To
1273+
get a list of both custom and automatically created entries, use
1274+
[SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
1275+
12721276
Args:
12731277
request (Union[google.cloud.datacatalog_v1.types.ListEntriesRequest, dict]):
12741278
The request object. Request message for
@@ -1570,14 +1574,20 @@ async def update_tag_template(
15701574
should not be set.
15711575
update_mask (:class:`google.protobuf.field_mask_pb2.FieldMask`):
15721576
Names of fields whose values to overwrite on a tag
1573-
template. Currently, only ``display_name`` can be
1574-
overwritten.
1577+
template. Currently, only ``display_name`` and
1578+
``is_publicly_readable`` can be overwritten.
15751579
15761580
If this parameter is absent or empty, all modifiable
15771581
fields are overwritten. If such fields are non-required
15781582
and omitted in the request body, their values are
15791583
emptied.
15801584
1585+
Note: Updating the ``is_publicly_readable`` field may
1586+
require up to 12 hours to take effect in search results.
1587+
Additionally, it also requires the
1588+
``tagTemplates.getIamPolicy`` and
1589+
``tagTemplates.setIamPolicy`` permissions.
1590+
15811591
This corresponds to the ``update_mask`` field
15821592
on the ``request`` instance; if ``request`` is provided, this
15831593
should not be set.
@@ -1964,7 +1974,7 @@ async def rename_tag_template_field(
19641974
[RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField].
19651975
name (:class:`str`):
19661976
Required. The name of the tag
1967-
template.
1977+
template field.
19681978
19691979
This corresponds to the ``name`` field
19701980
on the ``request`` instance; if ``request`` is provided, this

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/client.py‎

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -505,7 +505,7 @@ def search_catalog(
505505
Optional. The query string with a minimum of 3
506506
characters and specific syntax. For more information,
507507
see `Data Catalog search
508-
syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
508+
syntax </data-catalog/docs/how-to/search-reference>`__.
509509
510510
An empty query string returns all data assets (in the
511511
specified scope) that you have access to.
@@ -1495,6 +1495,10 @@ def list_entries(
14951495
) -> pagers.ListEntriesPager:
14961496
r"""Lists entries.
14971497
1498+
Note: Currently, this method can list only custom entries. To
1499+
get a list of both custom and automatically created entries, use
1500+
[SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
1501+
14981502
Args:
14991503
request (Union[google.cloud.datacatalog_v1.types.ListEntriesRequest, dict]):
15001504
The request object. Request message for
@@ -1787,14 +1791,20 @@ def update_tag_template(
17871791
should not be set.
17881792
update_mask (google.protobuf.field_mask_pb2.FieldMask):
17891793
Names of fields whose values to overwrite on a tag
1790-
template. Currently, only ``display_name`` can be
1791-
overwritten.
1794+
template. Currently, only ``display_name`` and
1795+
``is_publicly_readable`` can be overwritten.
17921796
17931797
If this parameter is absent or empty, all modifiable
17941798
fields are overwritten. If such fields are non-required
17951799
and omitted in the request body, their values are
17961800
emptied.
17971801
1802+
Note: Updating the ``is_publicly_readable`` field may
1803+
require up to 12 hours to take effect in search results.
1804+
Additionally, it also requires the
1805+
``tagTemplates.getIamPolicy`` and
1806+
``tagTemplates.setIamPolicy`` permissions.
1807+
17981808
This corresponds to the ``update_mask`` field
17991809
on the ``request`` instance; if ``request`` is provided, this
18001810
should not be set.
@@ -2185,7 +2195,7 @@ def rename_tag_template_field(
21852195
[RenameTagTemplateField][google.cloud.datacatalog.v1.DataCatalog.RenameTagTemplateField].
21862196
name (str):
21872197
Required. The name of the tag
2188-
template.
2198+
template field.
21892199
21902200
This corresponds to the ``name`` field
21912201
on the ``request`` instance; if ``request`` is provided, this

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc.py‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -608,6 +608,10 @@ def list_entries(
608608
609609
Lists entries.
610610
611+
Note: Currently, this method can list only custom entries. To
612+
get a list of both custom and automatically created entries, use
613+
[SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
614+
611615
Returns:
612616
Callable[[~.ListEntriesRequest],
613617
~.ListEntriesResponse]:

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/data_catalog/transports/grpc_asyncio.py‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -621,6 +621,10 @@ def list_entries(
621621
622622
Lists entries.
623623
624+
Note: Currently, this method can list only custom entries. To
625+
get a list of both custom and automatically created entries, use
626+
[SearchCatalog][google.cloud.datacatalog.v1.DataCatalog.SearchCatalog].
627+
624628
Returns:
625629
Callable[[~.ListEntriesRequest],
626630
Awaitable[~.ListEntriesResponse]]:

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/async_client.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -600,7 +600,7 @@ async def create_policy_tag(
600600
parent (:class:`str`):
601601
Required. Resource name of the
602602
taxonomy that the policy tag will belong
603-
to.<br /><br />
603+
to.
604604
605605
This corresponds to the ``parent`` field
606606
on the ``request`` instance; if ``request`` is provided, this

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/services/policy_tag_manager/client.py‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -805,7 +805,7 @@ def create_policy_tag(
805805
parent (str):
806806
Required. Resource name of the
807807
taxonomy that the policy tag will belong
808-
to.<br /><br />
808+
to.
809809
810810
This corresponds to the ``parent`` field
811811
on the ``request`` instance; if ``request`` is provided, this

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/datacatalog.py‎

Lines changed: 10 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -102,7 +102,7 @@ class SearchCatalogRequest(proto.Message):
102102
Optional. The query string with a minimum of 3 characters
103103
and specific syntax. For more information, see `Data Catalog
104104
search
105-
syntax <https://cloud.google.com/data-catalog/docs/how-to/search-reference>`__.
105+
syntax </data-catalog/docs/how-to/search-reference>`__.
106106
107107
An empty query string returns all data assets (in the
108108
specified scope) that you have access to.
@@ -950,11 +950,18 @@ class UpdateTagTemplateRequest(proto.Message):
950950
set.
951951
update_mask (google.protobuf.field_mask_pb2.FieldMask):
952952
Names of fields whose values to overwrite on a tag template.
953-
Currently, only ``display_name`` can be overwritten.
953+
Currently, only ``display_name`` and
954+
``is_publicly_readable`` can be overwritten.
954955
955956
If this parameter is absent or empty, all modifiable fields
956957
are overwritten. If such fields are non-required and omitted
957958
in the request body, their values are emptied.
959+
960+
Note: Updating the ``is_publicly_readable`` field may
961+
require up to 12 hours to take effect in search results.
962+
Additionally, it also requires the
963+
``tagTemplates.getIamPolicy`` and
964+
``tagTemplates.setIamPolicy`` permissions.
958965
"""
959966

960967
tag_template = proto.Field(proto.MESSAGE, number=1, message=gcd_tags.TagTemplate,)
@@ -1114,7 +1121,7 @@ class RenameTagTemplateFieldRequest(proto.Message):
11141121
11151122
Attributes:
11161123
name (str):
1117-
Required. The name of the tag template.
1124+
Required. The name of the tag template field.
11181125
new_tag_template_field_id (str):
11191126
Required. The new ID of this tag template field. For
11201127
example, ``my_new_field``.

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/policytagmanager.py‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -131,7 +131,7 @@ class PolicyTag(proto.Message):
131131
Output only. Resource name of this policy tag
132132
in the URL format.
133133
The policy tag manager generates unique taxonomy
134-
IDs and policy tag IDs.<br /><br />
134+
IDs and policy tag IDs.
135135
display_name (str):
136136
Required. User-defined name of this policy
137137
tag.
@@ -285,7 +285,7 @@ class CreatePolicyTagRequest(proto.Message):
285285
Attributes:
286286
parent (str):
287287
Required. Resource name of the taxonomy that
288-
the policy tag will belong to.<br /><br />
288+
the policy tag will belong to.
289289
policy_tag (google.cloud.datacatalog_v1.types.PolicyTag):
290290
The policy tag to create.
291291
"""

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/search.py‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -105,6 +105,12 @@ class SearchCatalogResult(proto.Message):
105105
Example for a DPMS table:
106106
107107
``dataproc_metastore:PROJECT_ID.LOCATION_ID.INSTANCE_ID.DATABASE_ID.TABLE_ID``
108+
display_name (str):
109+
The display name of the result.
110+
description (str):
111+
Entry description that can consist of several
112+
sentences or paragraphs that describe entry
113+
contents.
108114
"""
109115

110116
search_result_type = proto.Field(proto.ENUM, number=1, enum="SearchResultType",)
@@ -117,6 +123,8 @@ class SearchCatalogResult(proto.Message):
117123
)
118124
user_specified_system = proto.Field(proto.STRING, number=9, oneof="system",)
119125
fully_qualified_name = proto.Field(proto.STRING, number=10,)
126+
display_name = proto.Field(proto.STRING, number=12,)
127+
description = proto.Field(proto.STRING, number=13,)
120128

121129

122130
__all__ = tuple(sorted(__protobuf__.manifest))

‎packages/google-cloud-datacatalog/google/cloud/datacatalog_v1/types/table_spec.py‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -121,11 +121,15 @@ class BigQueryDateShardedSpec(proto.Message):
121121
``table_prefix`` is ``MyTable``.
122122
shard_count (int):
123123
Output only. Total number of shards.
124+
latest_shard_resource (str):
125+
Output only. BigQuery resource name of the
126+
latest shard.
124127
"""
125128

126129
dataset = proto.Field(proto.STRING, number=1,)
127130
table_prefix = proto.Field(proto.STRING, number=2,)
128131
shard_count = proto.Field(proto.INT64, number=3,)
132+
latest_shard_resource = proto.Field(proto.STRING, number=4,)
129133

130134

131135
__all__ = tuple(sorted(__protobuf__.manifest))

0 commit comments

Comments
 (0)