feat(spanner): add proto descriptors for proto and enum types in create/update/get database ddl requests

Google APIs · copybara-github · commit 81b24a52c7d8 · 2024-01-23T22:48:06.000-08:00
PiperOrigin-RevId: 601013501
diff --git a/google/spanner/admin/database/v1/spanner_database_admin.proto b/google/spanner/admin/database/v1/spanner_database_admin.proto
@@ -572,6 +572,23 @@ message CreateDatabaseRequest {
 
   // Optional. The dialect of the Cloud Spanner Database.
   DatabaseDialect database_dialect = 5 [(google.api.field_behavior) = OPTIONAL];
+
+  // Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements in
+  // 'extra_statements' above.
+  // Contains a protobuf-serialized
+  // [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto).
+  // To generate it, [install](https://grpc.io/docs/protoc-installation/) and
+  // run `protoc` with --include_imports and --descriptor_set_out. For example,
+  // to generate for moon/shot/app.proto, run
+  // ```
+  // $protoc  --proto_path=/app_path --proto_path=/lib_path \
+  //          --include_imports \
+  //          --descriptor_set_out=descriptors.data \
+  //          moon/shot/app.proto
+  // ```
+  // For more details, see protobuffer [self
+  // description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
+  bytes proto_descriptors = 6 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Metadata type for the operation returned by
@@ -674,6 +691,22 @@ message UpdateDatabaseDdlRequest {
   // [UpdateDatabaseDdl][google.spanner.admin.database.v1.DatabaseAdmin.UpdateDatabaseDdl] returns
   // `ALREADY_EXISTS`.
   string operation_id = 3;
+
+  // Optional. Proto descriptors used by CREATE/ALTER PROTO BUNDLE statements.
+  // Contains a protobuf-serialized
+  // [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto).
+  // To generate it, [install](https://grpc.io/docs/protoc-installation/) and
+  // run `protoc` with --include_imports and --descriptor_set_out. For example,
+  // to generate for moon/shot/app.proto, run
+  // ```
+  // $protoc  --proto_path=/app_path --proto_path=/lib_path \
+  //          --include_imports \
+  //          --descriptor_set_out=descriptors.data \
+  //          moon/shot/app.proto
+  // ```
+  // For more details, see protobuffer [self
+  // description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
+  bytes proto_descriptors = 4 [(google.api.field_behavior) = OPTIONAL];
 }
 
 // Action information extracted from a DDL statement. This proto is used to
@@ -762,6 +795,13 @@ message GetDatabaseDdlResponse {
   // A list of formatted DDL statements defining the schema of the database
   // specified in the request.
   repeated string statements = 1;
+
+  // Proto descriptors stored in the database.
+  // Contains a protobuf-serialized
+  // [google.protobuf.FileDescriptorSet](https://github.com/protocolbuffers/protobuf/blob/main/src/google/protobuf/descriptor.proto).
+  // For more details, see protobuffer [self
+  // description](https://developers.google.com/protocol-buffers/docs/techniques#self-description).
+  bytes proto_descriptors = 2;
 }
 
 // The request for
