Database Migrator
a CLI tool to migrate your data to Upstash Search
Introduction
This tool helps you to migrate your data from other service providers (e.g. Algolia, Meilisearch) to your Upstash Search Database.
Migrate Using npx
The command below prompts you to provide credentials for the indexes that you want to do the migration between.
Using Flags
You can also provide your credentials and other information as command-line flags. Here are some examples:
Algolia to Upstash
Meilisearch to Upstash
Obtaining Credentials
Upstash
- Go to your Upstash Console.
- Select your Search Database.
- Under the Details section, you will find your
UPSTASH_SEARCH_REST_URL
andUPSTASH_SEARCH_REST_TOKEN
.--upstash-url
corresponds toUPSTASH_SEARCH_REST_URL
.--upstash-token
corresponds toUPSTASH_SEARCH_REST_TOKEN
.
- You may want to check out @upstash/search-migrator to see how to find credentials for other service providers
Migration Process
The migrator will:
- Connect to your source database (Algolia or Meilisearch)
- Fetch all documents from the specified index
- Transform the data to match Upstash Search’s format
- Upload the documents to your Upstash Search database
- Verify the migration by comparing document counts
Data Transformation
The migrator automatically handles the transformation of your data:
- Document IDs: Preserved from the source
- Content: Mapped to Upstash Search’s content field
- Metadata: Preserved as metadata in Upstash Search
- Searchable fields: All fields become searchable by default
For free tier, 10000 documents can be upserted daily, so a database migration with more than 10000 entries could be interrupted.
Getting Help
If you encounter any issues during migration:
- Check the error messages for specific details
- Verify your credentials are correct
- Ensure your source database is accessible
- Contact support at support@upstash.com
Final Remarks
If you’ve come to this point without any issues, congratulations! you may resume your work with upstash search, an advanced, developer frinedly search product.
For further insights, please visit @upstash/search-migrator