Get Started with Relational Migrator
On this page
Relational Migrator is a tool to help you migrate your relational data to MongoDB. This page guides you through installing the tool and running your first migration job.
To get familiar with Relational Migrator capabilities, features, and use cases, review the following resources:
Steps
Install
You can install Relational Migrator with a single machine install suitable for testing or a unattended server install for production workloads.
Create a project
To start using Relational Migrator, create a project. Projects hold the settings, schema conversion logic, and table mappings for a migration. You can connect to source and destination databases with the appropriate connection strings and save the source and destination database connections.
Create mapping rules with suggested mappings
Use suggested mappings to create initial mapping rules based on your relational schema. Mapping rules specify how data from each relational table migrates to MongoDB and how columns map to fields in MongoDB documents.
Customize your mapping rules
Add or update mapping rules to create the destination data model that best matches your application needs.
Create a migration job
Migration jobs move the data from relational tables to MongoDB collections. Migration jobs have two types:
Snapshot for point in time migrations.
Continuous for ongoing change data capture zero-downtime migrations.
To start your migration to MongoDB, create a migration job.