Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 4 additions & 0 deletions src/current/molt/migrate-data-load-and-replication.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ docs_area: migrate

{% include filter-tabs.md tab_names=tab_names_html page_filenames=html_page_filenames page_folder="molt" %}

{{site.data.alerts.callout_danger}}
MOLT Fetch replication modes will be deprecated in favor of a separate replication workflow in an upcoming release. This includes the `data-load-and-replication`, `replication-only`, and `failback` modes.
{{site.data.alerts.end}}

Use `data-load-and-replication` mode to perform a one-time bulk load of source data and start continuous replication in a single command.

{{site.data.alerts.callout_success}}
Expand Down
4 changes: 4 additions & 0 deletions src/current/molt/migrate-data-load-replicate-only.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,10 @@ docs_area: migrate

{% include filter-tabs.md tab_names=tab_names_html page_filenames=html_page_filenames page_folder="molt" %}

{{site.data.alerts.callout_danger}}
MOLT Fetch replication modes will be deprecated in favor of a separate replication workflow in an upcoming release. This includes the `data-load-and-replication`, `replication-only`, and `failback` modes.
{{site.data.alerts.end}}

Perform an initial bulk load of the source data using `data-load` mode, then use `replication-only` mode to replicate ongoing changes to the target.

{{site.data.alerts.callout_success}}
Expand Down
4 changes: 4 additions & 0 deletions src/current/molt/migrate-failback.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ toc: true
docs_area: migrate
---

{{site.data.alerts.callout_danger}}
MOLT Fetch replication modes will be deprecated in favor of a separate replication workflow in an upcoming release. This includes the `data-load-and-replication`, `replication-only`, and `failback` modes.
{{site.data.alerts.end}}

If issues arise during migration, run MOLT Fetch in `failback` mode after stopping replication and before writing to CockroachDB. This ensures that data remains consistent on the source in case you need to roll back the migration.

<div class="filters filters-big clearfix">
Expand Down
4 changes: 4 additions & 0 deletions src/current/molt/migrate-replicate-only.md
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,10 @@ toc: true
docs_area: migrate
---

{{site.data.alerts.callout_danger}}
MOLT Fetch replication modes will be deprecated in favor of a separate replication workflow in an upcoming release. This includes the `data-load-and-replication`, `replication-only`, and `failback` modes.
{{site.data.alerts.end}}

Use `replication-only` mode to resume replication to CockroachDB after an interruption, without reloading data.

{{site.data.alerts.callout_info}}
Expand Down
6 changes: 4 additions & 2 deletions src/current/molt/migration-overview.md
Original file line number Diff line number Diff line change
Expand Up @@ -21,9 +21,7 @@ Before you begin the migration, review [Migration Strategy]({% link molt/migrati

A migration to CockroachDB generally follows this sequence:

<div style="text-align: center;">
<img src="{{ 'images/molt/migration_flow.svg' | relative_url }}" alt="MOLT tooling overview" style="max-width:100%" />
</div><br>

1. Prepare the source database: Configure users, permissions, and replication settings as needed.
1. Convert the source schema: Use the [Schema Conversion Tool]({% link cockroachcloud/migrations-page.md %}) to generate CockroachDB-compatible [DDL]({% link {{ site.current_cloud_version }}/sql-statements.md %}#data-definition-statements). Apply the converted schema to the target database. Drop constraints and indexes to facilitate data load.
Expand Down Expand Up @@ -101,6 +99,10 @@ The [MOLT Schema Conversion Tool]({% link cockroachcloud/migrations-page.md %})

MOLT Fetch supports various migration flows using [MOLT Fetch modes]({% link molt/molt-fetch.md %}#fetch-mode).

{{site.data.alerts.callout_danger}}
MOLT Fetch replication modes will be deprecated in favor of a separate replication workflow in an upcoming release. This includes the `data-load-and-replication`, `replication-only`, and `failback` modes.
{{site.data.alerts.end}}

| Migration flow | Mode | Description | Best for |
|----------------------------------------------------------------------------------------|----------------------------------------------------|--------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------|
| [Bulk load]({% link molt/migrate-bulk-load.md %}) | `--mode data-load` | Perform a one-time bulk load of source data into CockroachDB. | Testing, migrations with [planned downtime]({% link molt/migration-strategy.md %}#approach-to-downtime) |
Expand Down
8 changes: 8 additions & 0 deletions src/current/molt/molt-fetch.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,10 @@ MOLT Fetch moves data from a source database into CockroachDB as part of a [data

MOLT Fetch uses [`IMPORT INTO`]({% link {{site.current_cloud_version}}/import-into.md %}) or [`COPY FROM`]({% link {{site.current_cloud_version}}/copy.md %}) to move the source data to cloud storage (Google Cloud Storage, Amazon S3, or Azure Blob Storage), a local file server, or local memory. Once the data is exported, MOLT Fetch can load the data into a target CockroachDB database and replicate changes from the source database. For details, refer to [Migration phases](#migration-phases).

{{site.data.alerts.callout_danger}}
MOLT Fetch replication modes will be deprecated in favor of a separate replication workflow in an upcoming release. This includes the `data-load-and-replication`, `replication-only`, and `failback` modes.
{{site.data.alerts.end}}

## Supported databases

The following source databases are currently supported:
Expand Down Expand Up @@ -284,6 +288,10 @@ The `--source-cdb` flag specifies the connection string for the Oracle container
- [Export and import the data only](#export-only-and-import-only)
- [Fail back to source database](#failback)

{{site.data.alerts.callout_danger}}
MOLT Fetch replication modes will be deprecated in favor of a separate replication workflow in an upcoming release. This includes the `data-load-and-replication`, `replication-only`, and `failback` modes.
{{site.data.alerts.end}}

#### `data-load`

`data-load` (default) instructs MOLT Fetch to load the source data into CockroachDB. It does not replicate any subsequent changes on the source.
Expand Down
Loading