|
1 | 1 | --- |
2 | 2 | title: MOLT Releases |
3 | | -summary: Changelog for MOLT Fetch and Verify |
| 3 | +summary: Changelog for MOLT Fetch, Verify, and Replicator |
4 | 4 | toc: true |
5 | 5 | docs_area: releases |
6 | 6 | --- |
7 | 7 |
|
8 | 8 | This page has details about each release of the following [MOLT (Migrate Off Legacy Technology) tools]({% link molt/migration-overview.md %}): |
9 | 9 |
|
10 | | -- [Fetch]({% link molt/molt-fetch.md %}) |
11 | | -- [Verify]({% link molt/molt-verify.md %}) |
| 10 | +- `molt`: [MOLT Fetch]({% link molt/molt-fetch.md %}) and [MOLT Verify]({% link molt/molt-verify.md %}) |
| 11 | +- `replicator`: [MOLT Replicator]({% link molt/molt-replicator.md %}) |
12 | 12 |
|
13 | 13 | Cockroach Labs recommends using the latest available version of each tool. See [Installation](#installation). |
14 | 14 |
|
15 | 15 | ## Installation |
16 | 16 |
|
17 | 17 | {% include molt/molt-install.md %} |
18 | 18 |
|
| 19 | +## October 23, 2025 |
| 20 | + |
| 21 | +`molt` 1.3.2 is [available](#installation): |
| 22 | + |
| 23 | +- MOLT Fetch replication modes are deprecated in favor of a separate replication workflow using `replicator`. For details, refer to [MOLT Replicator]({% link molt/molt-replicator.md %}). |
| 24 | +- Added retry logic to the export phase for CockroachDB and PostgreSQL sources to handle transient errors while maintaining a consistent snapshot point. Not currently supported for Oracle or MySQL sources. |
| 25 | +- Added `--export-retry-max-attempts` and `--export-retry-max-duration` flags to control retry behavior for source query exports. |
| 26 | + |
| 27 | +`replicator` 1.1.3 is [available](#installation): |
| 28 | + |
| 29 | +- Added `commit_to_stage_lag_seconds` Prometheus histogram metric to track the distribution of source CockroachDB to staged data times. |
| 30 | +- Added `core_parallelism_utilization_percent` gauge to track parallelism utilization and identify when the system is nearing parallelism limits, and should be sized up. |
| 31 | +- Added `core_flush_count` metric to track the number of flushed batches in the applier flow and the reason for each flush. |
| 32 | + |
19 | 33 | ## September 25, 2025 |
20 | 34 |
|
21 | 35 | MOLT Fetch/Verify 1.3.2 is [available](#installation). |
@@ -132,9 +146,9 @@ MOLT Fetch/Verify 1.2.1 is [available](#installation). |
132 | 146 | - MySQL 5.7 and later are now supported with MOLT Fetch replication modes. |
133 | 147 | - Fetch replication mode now defaults to a less verbose `INFO` logging level. To specify `DEBUG` logging, pass in the `--replicator-flags '-v'` setting, or `--replicator-flags '-vv'` for trace logging. |
134 | 148 | - MySQL columns of type `BIGINT UNSIGNED` or `SERIAL` are now auto-mapped to [`DECIMAL`]({% link {{ site.current_cloud_version }}/decimal.md %}) type in CockroachDB. MySQL regular `BIGINT` types are mapped to [`INT`]({% link {{ site.current_cloud_version }}/int.md %}) type in CockroachDB. |
135 | | -- The `pglogical` replication workflow was modified in order to enforce safer and simpler defaults for the [`data-load`]({% link molt/molt-fetch.md %}#data-load), `data-load-and-replication`, and `replication-only` workflows for PostgreSQL sources. Fetch now ensures that the publication is created before the slot, and that `replication-only` defaults to using publications and slots created either in previous Fetch runs or manually. |
| 149 | +- The `pglogical` replication workflow was modified in order to enforce safer and simpler defaults for the [`data-load`]({% link molt/molt-fetch.md %}#fetch-mode), `data-load-and-replication`, and `replication-only` workflows for PostgreSQL sources. Fetch now ensures that the publication is created before the slot, and that `replication-only` defaults to using publications and slots created either in previous Fetch runs or manually. |
136 | 150 | - Fixed scan iterator query ordering for `BINARY` and `TEXT` (of same collation) PKs so that they lead to the correct queries and ordering. |
137 | | -- For a MySQL source in `replication-only` mode, the [`--stagingSchema` replicator flag]({% link molt/molt-replicator.md %}#flags) can now be used to resume streaming replication after being interrupted. Otherwise, the [`--defaultGTIDSet` replicator flag]({% link molt/molt-replicator.md %}#mysql-replication-flags) is used to start initial replication after a previous Fetch run in [`data-load`]({% link molt/molt-fetch.md %}#data-load) mode, or as an override to the current replication stream. |
| 151 | +- For a MySQL source in `replication-only` mode, the [`--stagingSchema` replicator flag]({% link molt/molt-replicator.md %}#flags) can now be used to resume streaming replication after being interrupted. Otherwise, the [`--defaultGTIDSet` replicator flag]({% link molt/molt-replicator.md %}#mylogical-replication-flags) is used to start initial replication after a previous Fetch run in [`data-load`]({% link molt/molt-fetch.md %}#fetch-mode) mode, or as an override to the current replication stream. |
138 | 152 |
|
139 | 153 | ## October 29, 2024 |
140 | 154 |
|
@@ -167,8 +181,8 @@ MOLT Fetch/Verify 1.1.6 is [available](#installation). |
167 | 181 | MOLT Fetch/Verify 1.1.5 is [available](#installation). |
168 | 182 |
|
169 | 183 | - **Deprecated** the `--ongoing-replication` flag in favor of `--mode data-load-and-replication`, using the new `--mode` flag. Users should replace all instances of `--ongoing-replication` with `--mode data-load-and-replication`. |
170 | | -- Fetch can now be run in an export-only mode by specifying [`--mode export-only`]({% link molt/molt-fetch.md %}#export-only-and-import-only). This will export all the data in `csv` or `csv.gz` format to the specified cloud or local store. |
171 | | -- Fetch can now be run in an import-only mode by specifying [`--mode import-only`]({% link molt/molt-fetch.md %}#export-only-and-import-only). This will load all data in the specified cloud or local store into the target CockroachDB database, effectively skipping the export data phase. |
| 184 | +- Fetch can now be run in an export-only mode by specifying [`--mode export-only`]({% link molt/molt-fetch.md %}#fetch-mode). This will export all the data in `csv` or `csv.gz` format to the specified cloud or local store. |
| 185 | +- Fetch can now be run in an import-only mode by specifying [`--mode import-only`]({% link molt/molt-fetch.md %}#fetch-mode). This will load all data in the specified cloud or local store into the target CockroachDB database, effectively skipping the export data phase. |
172 | 186 | - Strings for the `--mode` flag are now word-separated by hyphens instead of underscores. For example, `replication-only` instead of `replication_only`. |
173 | 187 |
|
174 | 188 | ## August 8, 2024 |
|
0 commit comments