# AsyncCosmosDBStore

> **Class** in `langchain_azure_cosmosdb`

📖 [View in docs](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_store/AsyncCosmosDBStore)

Async Azure Cosmos DB-backed store with optional vector search.

Provides async LangGraph long-term memory persistence using Azure Cosmos DB.

## Signature

```python
AsyncCosmosDBStore(
    self,
    conn: AsyncCosmosClient,
    *,
    database_name: str = 'langgraph',
    container_name: str = 'store',
    deserializer: Callable[[bytes | orjson.Fragment], dict[str, Any]] | None = None,
    index: CosmosDBIndexConfig | None = None,
    ttl: TTLConfig | None = None,
)
```

## Description

**Example:**

Basic setup and usage::

from langchain_azure_cosmosdb import AsyncCosmosDBStore

async with AsyncCosmosDBStore.from_conn_string(
    conn_string="AccountEndpoint=https://...;AccountKey=...",
    database_name="langgraph",
    container_name="store",
) as store:
    await store.setup()
    await store.aput(("users", "123"), "prefs", {"theme": "dark"})
    item = await store.aget(("users", "123"), "prefs")

**Note:**

Semantic search is disabled by default. Provide an ``index``
configuration when creating the store to enable it.

**Warning:**

Make sure to call ``setup()`` before first use.

## Extends

- `AsyncBatchedBaseStore`
- `BaseCosmosDBStore[AsyncCosmosClient]`

## Constructors

```python
__init__(
    self,
    conn: AsyncCosmosClient,
    *,
    database_name: str = 'langgraph',
    container_name: str = 'store',
    deserializer: Callable[[bytes | orjson.Fragment], dict[str, Any]] | None = None,
    index: CosmosDBIndexConfig | None = None,
    ttl: TTLConfig | None = None,
) -> None
```

| Name | Type |
|------|------|
| `conn` | `AsyncCosmosClient` |
| `database_name` | `str` |
| `container_name` | `str` |
| `deserializer` | `Callable[[bytes \| orjson.Fragment], dict[str, Any]] \| None` |
| `index` | `CosmosDBIndexConfig \| None` |
| `ttl` | `TTLConfig \| None` |


## Properties

- `supports_ttl`
- `conn`
- `index_config`
- `embeddings`
- `ttl_config`
- `container`

## Methods

- [`from_conn_string()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_store/AsyncCosmosDBStore/from_conn_string)
- [`from_endpoint()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_store/AsyncCosmosDBStore/from_endpoint)
- [`setup()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_store/AsyncCosmosDBStore/setup)
- [`abatch()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_store/AsyncCosmosDBStore/abatch)
- [`sweep_ttl()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_store/AsyncCosmosDBStore/sweep_ttl)
- [`start_ttl_sweeper()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_store/AsyncCosmosDBStore/start_ttl_sweeper)
- [`stop_ttl_sweeper()`](https://reference.langchain.com/python/langchain-azure-cosmosdb/aio/_langgraph_store/AsyncCosmosDBStore/stop_ttl_sweeper)

---

[View source on GitHub](https://github.com/langchain-ai/langchain-azure/blob/e62c2a55aaa0942fdac739b4066011953b80018e/libs/azure-cosmosdb/src/langchain_azure_cosmosdb/aio/_langgraph_store.py#L56)