Docs Home → Tools and Connectors → Relational Migrator
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 sync 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 your source and destination databases with the appropriate connection strings.
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 sync job
Sync jobs move the data from relational tables to MongoDB collections. Sync 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 sync job.