Skip to main content

Import from Other Databases

Download Raven.Migrator Tool​

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/download, in the TOOLS package (see image below).
The Raven.Migrator tool can be found in the downloaded Tools folder.

Raven.Migrator Tool Download

Import from MongoDB​

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

Figure 1.

  1. Migrator Path

    • Find Raven.Migrator.exe in the tools package.
    • 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.

  1. Migrator Path

    • Find Raven.Migrator.exe in the tools package.
    • 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.

In this article