Write the merged database to `target` and verify it. `target` must not exist. `legacy_dir` is recorded in `atomic_meta` so an interrupted retirement of the legacy files can be finished later. # Errors Refuses to merge when a source holds a non-empty table this build does not know, when two sources define the same table, or when the merged copy does not match its sources.
(&self, target: &Path, legacy_dir: &str)
| 96 | /// not know, when two sources define the same table, or when the merged |
| 97 | /// copy does not match its sources. |
| 98 | pub fn merge_into(&self, target: &Path, legacy_dir: &str) -> PristineResult<MergeReport> { |
| 99 | if target.exists() { |
| 100 | return Err(merge_error(format!( |
| 101 | "merge target {} already exists", |
| 102 | target.display() |
| 103 | ))); |
| 104 | } |
| 105 | let known: BTreeSet<_> = table_names().into_iter().collect(); |
| 106 | let mut left_behind = Vec::new(); |
| 107 | for (path, source) in &self.sources { |
| 108 | left_behind.extend(refuse_unknown_tables(&source.begin_read()?, &known, path)?); |
| 109 | } |
| 110 | |
| 111 | let mut builder = Builder::new(); |
| 112 | builder.set_cache_size(MERGE_CACHE_BYTES); |
| 113 | let merged = builder.create(target)?; |
| 114 | let mut report = MergeReport { |
| 115 | left_behind, |
| 116 | ..MergeReport::default() |
| 117 | }; |
| 118 | let mut source_digests = Vec::new(); |
| 119 | for (path, source) in &self.sources { |
| 120 | let read = source.begin_read()?; |
| 121 | let mut write = merged.begin_write()?; |
| 122 | // Only the final metadata commit needs to be durable: until it |
| 123 | // lands the target is an unpublished scratch file. |
| 124 | write |
| 125 | .set_durability(Durability::None) |
| 126 | .map_err(|error| merge_error(error.to_string()))?; |
| 127 | let before: BTreeSet<_> = report.tables.keys().cloned().collect(); |
| 128 | visit_tables(&mut Copier { |
| 129 | source: &read, |
| 130 | target: &write, |
| 131 | report: &mut report, |
| 132 | })?; |
| 133 | write.commit()?; |
| 134 | let copied = report |
| 135 | .tables |
| 136 | .iter() |
| 137 | .filter(|(name, _)| !before.contains(*name)); |
| 138 | source_digests.push((source_key(path)?, fingerprint(copied))); |
| 139 | } |
| 140 | |
| 141 | if collect_digests(&merged.begin_read()?)? != report.tables { |
| 142 | return Err(merge_error( |
| 143 | "merged tables do not match their sources".into(), |
| 144 | )); |
| 145 | } |
| 146 | |
| 147 | let write = merged.begin_write()?; |
| 148 | { |
| 149 | let mut meta = write.open_table(ATOMIC_META)?; |
| 150 | // Preserve a source's higher required schema; ordinary legacy |
| 151 | // repositories stay on the baseline rather than being upgraded |
| 152 | // merely because this build understands projected semantics. |
| 153 | let version = meta |
| 154 | .get(SCHEMA_VERSION_KEY)? |
| 155 | .map(|value| value.value().to_vec()) |