#meilisearch #import #csv #dataset #json #json-array #progress-bar

app meilisearch-importer

A tool to import massive datasets into Meilisearch by sending them in batches

2 releases

0.2.1 Mar 26, 2024
0.2.0 Mar 26, 2024

#596 in Encoding

21 downloads per month

MIT license

19KB
343 lines

Meilisearch Importer

The most efficient CLI tool to import massive CSVs, NSJSON or JSON (array of objects) into Meilisearch.

This tool has been tested with multiple datasets from hundreds of thousand documents to some with more than forty millions documents. The progress bar is very handy in this case.

Features

  • Uploads millions of documents to Meilisearch.
  • Automatically retries on error.
  • Shows the upload progress along with the estimated time of arrival (ETA).
  • Works on the Cloud and on self-hosted instances.

Installation

You can download the latest version of this tool on the release page.

Example Usage

Send Documents to the Cloud

It's straightforward to create a project on the Cloud and send your documents into it.

If you cannot send your dataset directly from the website by drag-and-dropping it, this tool is perfect for you. You can send them by running the following command:

meilisearch-importer \
    --url 'https://ms-************.sfo.meilisearch.io'
    --index crunchbase \
    --primary-key uuid \
    --api-key 'D2jkS***************' \
    --files ./dataset/organizations.csv

Send Documents to a Local Instance

This tool is also useful when you want to test Meilisearch locally. The only mandatory parameters to define are the URL, the index name and your dataset.

However, you can also increase the batch size to make meilisearch index faster.

meilisearch-importer \
    --url 'http://localhost:7700'
    --index movies \
    --files movies.json \
    --batch-size 100MB

Dependencies

~9–17MB
~211K SLoC