FazBrowse GitHub Viewer | Trending |
URL:
| Home
Tools: [Download Repo ZIP]   [Original HTTPS Page]

feat: add DdlStatementActionInfo and add actions to UpdateDatabaseDdl… · googleapis/google-cloud-python@71f637d · GitHub

/ google-cloud-python Public

Commit 71f637d

Browse files
gcf-owl-bot[bot]
authored
feat: add DdlStatementActionInfo and add actions to UpdateDatabaseDdlMetadata (#948)
* feat(spanner): add DdlStatementActionInfo and add actions to UpdateDatabaseDdlMetadata PiperOrigin-RevId: 536483675 Source-Link: googleapis/googleapis@9b1c253 Source-Link: googleapis/googleapis-gen@b901406 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiYjkwMTQwNjQ1ZDRlMWNmYTdiNTZmNjA4M2E0M2NmZGQ4NzI1NThiYSJ9 * 🦉 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>
1 parent 707b797 commit 71f637d

6 files changed

Lines changed: 63 additions & 11 deletions

File tree

‎packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/__init__.py‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@
4444
from .types.spanner_database_admin import CreateDatabaseRequest
4545
from .types.spanner_database_admin import Database
4646
from .types.spanner_database_admin import DatabaseRole
47+
from .types.spanner_database_admin import DdlStatementActionInfo
4748
from .types.spanner_database_admin import DropDatabaseRequest
4849
from .types.spanner_database_admin import GetDatabaseDdlRequest
4950
from .types.spanner_database_admin import GetDatabaseDdlResponse
@@ -81,6 +82,7 @@
8182
"DatabaseAdminClient",
8283
"DatabaseDialect",
8384
"DatabaseRole",
85+
"DdlStatementActionInfo",
8486
"DeleteBackupRequest",
8587
"DropDatabaseRequest",
8688
"EncryptionConfig",

‎packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/types/__init__.py‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -41,6 +41,7 @@
4141
CreateDatabaseRequest,
4242
Database,
4343
DatabaseRole,
44+
DdlStatementActionInfo,
4445
DropDatabaseRequest,
4546
GetDatabaseDdlRequest,
4647
GetDatabaseDdlResponse,
@@ -87,6 +88,7 @@
8788
"CreateDatabaseRequest",
8889
"Database",
8990
"DatabaseRole",
91+
"DdlStatementActionInfo",
9092
"DropDatabaseRequest",
9193
"GetDatabaseDdlRequest",
9294
"GetDatabaseDdlResponse",

‎packages/google-cloud-spanner/google/cloud/spanner_admin_database_v1/types/spanner_database_admin.py‎

Lines changed: 56 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -40,6 +40,7 @@
4040
"UpdateDatabaseRequest",
4141
"UpdateDatabaseMetadata",
4242
"UpdateDatabaseDdlRequest",
43+
"DdlStatementActionInfo",
4344
"UpdateDatabaseDdlMetadata",
4445
"DropDatabaseRequest",
4546
"GetDatabaseDdlRequest",
@@ -533,6 +534,46 @@ class UpdateDatabaseDdlRequest(proto.Message):
533534
)
534535

535536

537+
class DdlStatementActionInfo(proto.Message):
538+
r"""Action information extracted from a DDL statement. This proto is
539+
used to display the brief info of the DDL statement for the
540+
operation
541+
[UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl].
542+
543+
Attributes:
544+
action (str):
545+
The action for the DDL statement, e.g.
546+
CREATE, ALTER, DROP, GRANT, etc. This field is a
547+
non-empty string.
548+
entity_type (str):
549+
The entity type for the DDL statement, e.g. TABLE, INDEX,
550+
VIEW, etc. This field can be empty string for some DDL
551+
statement, e.g. for statement "ANALYZE", ``entity_type`` =
552+
"".
553+
entity_names (MutableSequence[str]):
554+
The entity name(s) being operated on the DDL statement. E.g.
555+
556+
1. For statement "CREATE TABLE t1(...)", ``entity_names`` =
557+
["t1"].
558+
2. For statement "GRANT ROLE r1, r2 ...", ``entity_names`` =
559+
["r1", "r2"].
560+
3. For statement "ANALYZE", ``entity_names`` = [].
561+
"""
562+
563+
action: str = proto.Field(
564+
proto.STRING,
565+
number=1,
566+
)
567+
entity_type: str = proto.Field(
568+
proto.STRING,
569+
number=2,
570+
)
571+
entity_names: MutableSequence[str] = proto.RepeatedField(
572+
proto.STRING,
573+
number=3,
574+
)
575+
576+
536577
class UpdateDatabaseDdlMetadata(proto.Message):
537578
r"""Metadata type for the operation returned by
538579
[UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl].
@@ -550,20 +591,22 @@ class UpdateDatabaseDdlMetadata(proto.Message):
550591
commit timestamp for the statement ``statements[i]``.
551592
throttled (bool):
552593
Output only. When true, indicates that the
553-
operation is throttled e.g due to resource
594+
operation is throttled e.g. due to resource
554595
constraints. When resources become available the
555596
operation will resume and this field will be
556597
false again.
557598
progress (MutableSequence[google.cloud.spanner_admin_database_v1.types.OperationProgress]):
558599
The progress of the
559600
[UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl]
560-
operations. Currently, only index creation statements will
561-
have a continuously updating progress. For non-index
562-
creation statements, ``progress[i]`` will have start time
563-
and end time populated with commit timestamp of operation,
564-
as well as a progress of 100% once the operation has
565-
completed. ``progress[i]`` is the operation progress for
566-
``statements[i]``.
601+
operations. All DDL statements will have continuously
602+
updating progress, and ``progress[i]`` is the operation
603+
progress for ``statements[i]``. Also, ``progress[i]`` will
604+
have start time and end time populated with commit timestamp
605+
of operation, as well as a progress of 100% once the
606+
operation has completed.
607+
actions (MutableSequence[google.cloud.spanner_admin_database_v1.types.DdlStatementActionInfo]):
608+
The brief action info for the DDL statements. ``actions[i]``
609+
is the brief info for ``statements[i]``.
567610
"""
568611

569612
database: str = proto.Field(
@@ -588,6 +631,11 @@ class UpdateDatabaseDdlMetadata(proto.Message):
588631
number=5,
589632
message=common.OperationProgress,
590633
)
634+
actions: MutableSequence["DdlStatementActionInfo"] = proto.RepeatedField(
635+
proto.MESSAGE,
636+
number=6,
637+
message="DdlStatementActionInfo",
638+
)
591639

592640

593641
class DropDatabaseRequest(proto.Message):

‎packages/google-cloud-spanner/samples/generated_samples/snippet_metadata_google.spanner.admin.database.v1.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
],
99
"language": "PYTHON",
1010
"name": "google-cloud-spanner-admin-database",
11-
"version": "3.35.1"
11+
"version": "0.1.0"
1212
},
1313
"snippets": [
1414
{

‎packages/google-cloud-spanner/samples/generated_samples/snippet_metadata_google.spanner.admin.instance.v1.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
],
99
"language": "PYTHON",
1010
"name": "google-cloud-spanner-admin-instance",
11-
"version": "3.35.1"
11+
"version": "0.1.0"
1212
},
1313
"snippets": [
1414
{

‎packages/google-cloud-spanner/samples/generated_samples/snippet_metadata_google.spanner.v1.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
],
99
"language": "PYTHON",
1010
"name": "google-cloud-spanner",
11-
"version": "3.35.1"
11+
"version": "0.1.0"
1212
},
1313
"snippets": [
1414
{

0 commit comments

Comments
 (0)
Back | FazBrowse Home | New Git URL