feat: Publish message definitions for new Cloud Datastore migration logging steps.

Google APIs · copybara-github · commit e96a2e6ad25a · 2021-07-09T14:46:44.000-07:00
PiperOrigin-RevId: 383927106
diff --git a/google/datastore/admin/v1/migration.proto b/google/datastore/admin/v1/migration.proto
@@ -36,11 +36,45 @@ message MigrationStateEvent {
 // Datastore to Cloud Firestore in Datastore
 // mode](https://cloud.google.com/datastore/docs/upgrade-to-firestore).
 message MigrationProgressEvent {
+  // Details for the `PREPARE` step.
+  message PrepareStepDetails {
+    // The concurrency mode this database will use when it reaches the
+    // `REDIRECT_WRITES` step.
+    ConcurrencyMode concurrency_mode = 1;
+  }
+
+  // Details for the `REDIRECT_WRITES` step.
+  message RedirectWritesStepDetails {
+    // Ths concurrency mode for this database.
+    ConcurrencyMode concurrency_mode = 1;
+  }
+
+  // Concurrency modes for transactions in Cloud Firestore.
+  enum ConcurrencyMode {
+    // Unspecified.
+    CONCURRENCY_MODE_UNSPECIFIED = 0;
+
+    // Pessimistic concurrency.
+    PESSIMISTIC = 1;
+
+    // Optimistic concurrency.
+    OPTIMISTIC = 2;
+  }
+
   // The step that is starting.
   //
   // An event with step set to `START` indicates that the migration
   // has been reverted back to the initial pre-migration state.
   MigrationStep step = 1;
+
+  // Details about this step.
+  oneof step_details {
+    // Details for the `PREPARE` step.
+    PrepareStepDetails prepare_step_details = 2;
+
+    // Details for the `REDIRECT_WRITES` step.
+    RedirectWritesStepDetails redirect_writes_step_details = 3;
+  }
 }
 
 // States for a migration.
@@ -63,9 +97,15 @@ enum MigrationStep {
   // Unspecified.
   MIGRATION_STEP_UNSPECIFIED = 0;
 
+  // Pre-migration: the database is prepared for migration.
+  PREPARE = 6;
+
   // Start of migration.
   START = 1;
 
+  // Writes are applied synchronously to at least one replica.
+  APPLY_WRITES_SYNCHRONOUSLY = 7;
+
   // Data is copied to Cloud Firestore and then verified to match the data in
   // Cloud Datastore.
   COPY_AND_VERIFY = 2;
