Basic Information

• Used with MongoDBAtlasEmbeddingRetriever
• Type: haystack_integrations.document_stores.mongodb_atlas.document_store.MongoDBAtlasDocumentStore

Overview

For details, see MongoDB documentation and Haystack documentation.

Authorization

To connect to the MongoDB database, you must provide a connection string in the format "mongodb+srv://{mongo_atlas_username}:{mongo_atlas_password}@{mongo_atlas_host}/?{mongo_atlas_params_string}". For detailed instructions on how to obtain it, see Create a Connection String in MongoDB documentation.

Once you have your connection string, connect MongoDB to deepset AI Platform on the Connections page:

1. Log in to deepset AI Platform.

2. Click your initials in the top right corner and choose Connections.

   

3. Scroll down the page to find MongoDB and click Connect next to it.

4. Paste your MongoDB connection string and click Connect.

Usage

To configure MongoDB as the document store, you need:

• The name of the database to use.
• The name of the collection to use. This collection must have a vector search index set up on the embedding field.
• The name of the vector search index to use for vector search. You can create a vector search index on your collection in the Atlas web user interface.
  Important: Your MongoDB vector search index must have an embedding field of type knnVector defined, for example:
  Python

  const index = {  
           name: "vector_index",  
           type: "vectorSearch",  
           definition: {  
             "fields": [  
               {  
                 "type": "knnVector",  
                 "path": "embedding",  
                 "similarity": "cosine",  
                 "numDimensions": 768  
               }  
             ]  
           }  
       }
  

  This allows you to use embedding retrieval with the MongoDB document store.
  For details, see MongoDB documentation.

Writing Data to MongoDB

To write the preprocessed files into the MongoDB document store:

1. Add DocumentWriter to your indexing pipeline.
2. Add MongoDBAtlasDocumentStore and configure the required parameters on the component card. You must provide:
   • database_name: The name of your MongoDB database.
   • collection_name: The name of your collection.
   • vector_search_index: The name of the vector search index created on your collection. Make sure the index has an embedding field of type knnVector defined.
3. Connect MongoDBAtlasDocumentStore to DocumentWriter.

Retrieving Files From MongoDB

To retrieve files from the MongoDB document store and use them for search:

1. Add the MongoDBAtlasEmbeddingRetriever to your query pipeline.
2. Add MongoDBAtlasDocumentStore and configure the required parameters on the component card. You must provide:
   • database_name: The name of your MongoDB database.
   • collection_name: The name of your collection.
   • vector_search_index: The name of the vector search index created on your collection. Make sure the index has an embedding field of type knnVector defined.
3. Connect MongoDBAtlasDocumentStore to MongoDBAtlasEmbeddingRetriever.

Examples

This is how you connect the document store to writer:

When you switch to YAML, you can see that the document store is a parameter of DocumentWriter and that's where you can configure it as well:

writer:
    type: haystack.components.writers.document_writer.DocumentWriter
    init_parameters:
      document_store:
        type: haystack_integrations.document_stores.mongodb_atlas.document_store.MongoDBAtlasDocumentStore #document store configuration
        init_parameters:
          mongo_connection_string: "type: env_var\nenv_vars:\n  - MONGO_CONNECTION_STRING\nstrict: false\n"
          database_name: myDatabase
          collection_name: myCollection
          vector_search_index: vectorIndex
          full_text_search_index: fullTextIndex
      policy: OVERWRITE

Init Parameters

To check the initialization parameters MongoDB takes, see MongoDB Atlas API reference in Haystack documentation.