Materialize indexes: api (#30213)

Author: CyberROFL

ydb/public/api/protos/ydb_export.proto

@@ -139,6 +139,12 @@ message ExportToS3Settings {
     // If encryption_settings field is not specified,
     // the resulting data will not be encrypted.
     EncryptionSettings encryption_settings = 15;
+
+    // Materialization of index table data.
+    // By default, only index metadata is uploaded and indexes are built during import — it saves space
+    // and reduces export time, but it can potentially increase the import time.
+    // Indexes can be materialized, then their data will be uploaded during export and downloaded during import.
+    bool materialize_indexes = 16;
 }
 
 message ExportToS3Result {

ydb/public/api/protos/ydb_import.proto

@@ -62,6 +62,17 @@ message ImportFromS3Settings {
         string destination_path = 2;
     }
 
+    enum IndexFillingMode {
+        // If unspecified, use default - Build
+        INDEX_FILLING_MODE_UNSPECIFIED = 0;
+        // Build index
+        INDEX_FILLING_MODE_BUILD = 1;
+        // Import materialized index
+        INDEX_FILLING_MODE_IMPORT = 2;
+        // Try to import materialized index, build otherwise
+        INDEX_FILLING_MODE_AUTO = 3;
+    }
+
     string endpoint = 1 [(required) = true];
     Scheme scheme = 2; // HTTPS if not specified
     string bucket = 3 [(required) = true];
@@ -100,6 +111,10 @@ message ImportFromS3Settings {
     // If encryption_settings field is not specified,
     // the resulting data is considered not encrypted.
     Ydb.Export.EncryptionSettings encryption_settings = 15;
+
+    // Index filling mode.
+    // If not specified, indexes will be built.
+    IndexFillingMode index_filling_mode = 16;
 }
 
 message ImportFromS3Result {