{"id":6166,"date":"2023-05-23T08:00:39","date_gmt":"2023-05-23T15:00:39","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/cosmosdb\/?p=6166"},"modified":"2026-07-21T10:09:04","modified_gmt":"2026-07-21T17:09:04","slug":"introducing-vector-search-in-azure-cosmos-db-for-mongodb-vcore","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/cosmosdb\/introducing-vector-search-in-azure-cosmos-db-for-mongodb-vcore\/","title":{"rendered":"Introducing Integrated Vector Database in Azure Cosmos DB for MongoDB vCore"},"content":{"rendered":"

\"Image<\/a><\/p>\n

Editor’s note (November 2025): Azure Cosmos DB for MongoDB (vCore) has been renamed to Azure DocumentDB. This article was originally published before the rename, so it uses the product name that was current at the time. While the product name has changed, the technical concepts discussed in this article remain applicable unless otherwise noted. For the latest Azure DocumentDB announcements, features, and technical guidance, visit the Azure DocumentDB Dev Blog.<\/a><\/em><\/p>\n

We are thrilled to announce the release of Integrated Vector Database in Azure Cosmos DB for MongoDB vCore, which will be showcased at Microsoft Build. This innovative feature opens a world of new opportunities for building intelligent AI-powered applications and makes Azure Cosmos DB for MongoDB vCore the first among MongoDB-compatible offerings to feature an integrated vector database!<\/p>\n

With the integrated vector database, you can now seamlessly integrate AI-based applications, including those using OpenAI embeddings, with your data already stored in Cosmos DB. You can store, index, and query high dimensional vector data stored directly in Azure Cosmos DB for MongoDB vCore, eliminating the need to transfer your data to more expensive alternatives for vector similarity search capabilities.<\/p>\n

This comprehensive solution streamlines your AI application development by reducing complexity and enhancing efficiency. With the integrated vector database, you’ll be able to unlock new insights from your data that were previously hidden or hard to find, leading to more accurate and powerful applications.<\/p>\n

What is a vector database?<\/h2>\n

A vector database<\/a> is a database designed to store and manage\u00a0vector embeddings, which are mathematical representations of data in a high-dimensional space. In this space, each dimension corresponds to a feature of the data, and tens of thousands of dimensions might be used to represent sophisticated data. A vector’s position in this space represents its characteristics. Words, phrases, or entire documents, and images, audio, and other types of data can all be vectorized. These vector embeddings are used in similarity search, multi-modal search, recommendations engines, large languages models (LLMs), etc.<\/p>\n

In a vector database, embeddings are indexed and queried through\u00a0vector search\u00a0algorithms based on their vector distance or similarity. A robust mechanism is necessary to identify the most relevant data. Some well-known vector search algorithms include Hierarchical Navigable Small World (HNSW), Inverted File (IVF), DiskANN, etc.<\/p>\n

Besides the typical vector database functionalities above, an integrated vector database in a highly performant NoSQL or relational database converts the existing raw data in your account into embeddings and stores them alongside your original data. This way, you can avoid the extra cost of replicating your data in a separate vector database. Moreover, this architecture keeps your vector embeddings and original data together, which better facilitates multi-modal data operations, and you can achieve greater data consistency, scale, and performance.<\/p>\n

What is vector search?<\/h2>\n

Vector search is a method that helps you find similar items based on their data characteristics rather than exact matches on a property field. This is especially useful in applications such as searching for similar text, finding related images, making recommendations, or even detecting anomalies. It works by taking the vector representations (lists of numbers) of your data that you have created using an ML model, or an embeddings API such as Azure OpenAI Service Embeddings<\/a> or Hugging Face on Azure<\/a>. It then measures the distance between the data vectors and your query vector. The data vectors that are closest to your query vector are the ones that are found to be most similar semantically.<\/p>\n

By integrating vector search capabilities natively, you can now unlock the full potential of your data in your intelligent applications.<\/p>\n

 <\/p>\n

Create a Vector Index<\/h2>\n

You can create vector indexes to power vector search using the following createIndexes<\/em> Spec template:<\/p>\n

<\/code><\/pre>\n
db.runCommand({\r\n  createIndexes: 'exampleCollection',\r\n  indexes: [\r\n    {\r\n      name: 'vectorSearchIndex',\r\n      key: {\r\n        \"vectorContent\": \"cosmosSearch\"\r\n      },\r\n      cosmosSearchOptions: {\r\n        kind: 'vector-ivf',\r\n        numLists: 100,\r\n        similarity: 'COS',\r\n        dimensions: 3\r\n      }\r\n    }\r\n  ]\r\n});<\/code><\/pre>\n
This command creates a vector-ivf <\/em>index against the vectorContent<\/em> property in the documents stored in the collection exampleCollection<\/em>. The cosmosSearchOptions<\/em> property specifies the parameters for the IVF vector index. In our small example, we specify dimensions: 3<\/em>\u00a0 where each vector has a dimensionality (or size) of 3. However, the dimensionality of your vectors may be different. For example, if you were using OpenAI Embeddings<\/a> this would be set to 1536<\/em>.<\/p>\n
Add vectors to your database<\/h2>\n
To add vectors to your database’s collection, you can use the OpenAI Embeddings model, another API (such as Hugging Face), or to generate embeddings from the data. In this example, we’ll insert a few documents that contain sample embeddings:<\/p>\n
db.exampleCollection.insertMany([\r\n  {name: \"Eugenia Lopez\", bio: \"Eugenia is the CEO of AdvenureWorks.\", vectorContent: [0.51, 0.12, 0.23]},\r\n  {name: \"Cameron Baker\", bio: \"Cameron Baker CFO of AdvenureWorks.\", vectorContent: [0.55, 0.89, 0.44]},\r\n  {name: \"Jessie Irwin\", bio: \"Jessie Irwin is the former CEO of AdventureWorks and now the director of the Our Planet initiative.\", vectorContent: [0.13, 0.92, 0.85]},\r\n  {name: \"Rory Nguyen\", bio: \"Rory Nguyen is the founder of AdventureWorks and the president of the Our Planet initiative.\", vectorContent: [0.91, 0.76, 0.83]},\r\n]);\r\n<\/code><\/pre>\n
Perform a vector search<\/h2>\n
Continuing with the above example, let’s create another vector, queryVector<\/em>. Vector search measures the distance between queryVector<\/em> and the vectors in the vectorContent<\/em> path of your documents. You can set the number of results the search returns by setting the parameter k, which we’ll set to 2.<\/p>\n
const queryVector = [0.52, 0.28, 0.12];\r\ndb.exampleCollection.aggregate([\r\n  {\r\n    $search: {\r\n      \"cosmosSearch\": {\r\n        \"vector\": queryVector,\r\n        \"path\": \"vectorContent\",\r\n        \"k\": 2\r\n      },\r\n    \"returnStoredSource\": true\r\n    }\r\n  }\r\n]);\r\n<\/code><\/pre>\n
We can perform a vector search using queryVector<\/em> as an input via the Mongo shell. The search result (shown below) is a list of the two most similar items to the query vector, sorted by their similarity scores. In the example below, the document for Eugenia Lopez has the vectorContent that is most similar to\u00a0queryVector<\/em>, followed by\u00a0Rory Nguyen<\/em>.<\/p>\n
[\r\n  {\r\n    _id: ObjectId(\"645acb54413be5502badff94\"),\r\n    name: 'Eugenia Lopez',\r\n    bio: 'Eugenia is the CEO of AdvenureWorks.',\r\n    vectorContent: [ 0.51, 0.12, 0.23 ]\r\n  },\r\n  {\r\n    _id: ObjectId(\"645acb54413be5502badff97\"),\r\n    name: 'Rory Nguyen',\r\n    bio: 'Rory Nguyen is the founder of AdventureWorks and the president of the Our Planet initiative.',\r\n    vectorContent: [ 0.91, 0.76, 0.83 ]\r\n  }\r\n]<\/code><\/pre>\n
<\/h2>\n
Next Steps<\/h2>\n
Vector database is a game-changer for developers looking to use AI capabilities in their applications. Azure Cosmos DB for MongoDB vCore offers a single, seamless solution for transactional raw data and vector data utilizing embeddings from the Azure OpenAI Service API or other solutions. You’re now equipped to create smarter, more efficient, and user-focused applications that stand out. Check out these resources to help you get started:<\/p>\n