You are currently browsing legacy 4.2 version of documentation. Click here to switch to the newest 6.0 version.
    We can help you with migration to the latest RavenDB
    Contact Us Now
    see on GitHub

    Import from Other Databases

    • You can import your existing NoSQL Databases to an empty RavenDB database.

    • Currently supported:

      • MongoDB
      • CosmosDB

    • You can import all collections, or select specific collections to import.

    • In this page:

    Before you start

    To migrate data from your existing NoSQL database, you need to download an external tool called Raven.Migrator.
    The application is available at ravendb.net/downloads, in the TOOLS package (see image below).
    The Raven.Migrator tool can be found in the downloaded Tools folder.

    Raven.Migrator Tool Download

    Raven.Migrator Tool Download

    Import from MongoDB

    In the RavenDB Studio client on the left side, select Tasks -> Import Data.
    Figure 1.

    Import from MongoDB

    1. Migrator Path

      • Find Raven.Migrator.exe in the tools package here: ravendb.net/downloads
      • Provide a path to Raven.Migrator.exe's folder.

    2. Database Source

      • Select MongoDB

    3. Connection String

      • Provide the connection string to your MongoDB instance.

    4. Migrate GridFS

      • Choosing this option will import GridFS attachments and save them as documents with attachments in the @files collection.

    5. Database Name

      • Provide the name of the source database.

    6. Migrate all collections

      • You can either import all collections or select the collections you'd like to import.
      • Optionally, you can rename the imported collections.

    7. Use Transform script

      • Use a JavaScript to filter / modify imported documents.

    Import from CosmosDB

    In the RavenDB Studio client on the left side, select Tasks -> Import Data.
    Figure 2.

    Import from CosmosDB

    1. Migrator Path

      • Find Raven.Migrator.exe in the tools package here: ravendb.net/downloads
      • Provide a path to Raven.Migrator.exe's folder.

    2. Database Source

      • Select CosmosDB

    3. Azure Endpoint URL

      • Provide a URL to CosmosDB database

    4. Primary Key

      • Provide the Primary key for CosmosDB

    5. Database Name

      • Provide the source database name

    6. Migrate all collections

      • You can either import all collections or select the collections you'd like to import.
      • Optionally, you can rename the imported collections.

    7. Use Transform script

      • Use a JavaScript to filter / modify imported documents.

    see on GitHub
    Home / Docs / Studio / Database / Tasks / Import Data / Import From Other