# Async MySQL (/database/providers/async-mysql/overview)



`AsyncMySQLDb` stores Agent, Team, and Workflow sessions, memories, knowledge, evaluations, and traces asynchronously in [MySQL](https://www.mysql.com/).

## Usage [#usage]

Install the `sqlalchemy`, `asyncmy`, and `openai` packages:

```shell
uv pip install sqlalchemy asyncmy openai
```

```python title="async_mysql_for_agent.py"
from agno.agent import Agent
from agno.db.mysql import AsyncMySQLDb

db_url = "mysql+asyncmy://ai:ai@localhost:3306/ai"

db = AsyncMySQLDb(db_url=db_url)
agent = Agent(db=db)
```

Use async methods such as `Agent.arun()` and `Agent.aprint_response()` with this database.

### Run MySQL [#run-mysql]

Install [Docker Desktop](https://docs.docker.com/get-started/get-docker/), then start MySQL on port `3306`:

```bash
docker run -d \
  --name mysql \
  -e MYSQL_ROOT_PASSWORD=ai \
  -e MYSQL_DATABASE=ai \
  -e MYSQL_USER=ai \
  -e MYSQL_PASSWORD=ai \
  -p 3306:3306 \
  mysql:8
```

## Parameters [#parameters]

| Parameter         | Type                    | Default | Description                                                                                                                  |
| ----------------- | ----------------------- | ------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `id`              | `Optional[str]`         | -       | The ID of the database instance. UUID by default.                                                                            |
| `db_url`          | `Optional[str]`         | -       | The database URL to connect to.                                                                                              |
| `db_engine`       | `Optional[AsyncEngine]` | -       | The SQLAlchemy async database engine to use.                                                                                 |
| `db_schema`       | `Optional[str]`         | -       | The database schema to use.                                                                                                  |
| `session_table`   | `Optional[str]`         | -       | Name of the table to store Agent, Team and Workflow sessions.                                                                |
| `runs_table`      | `Optional[str]`         | `None`  | Storage name for individual runs. Defaults to `agno_runs`, or `<session_table>_runs` when a custom session name is supplied. |
| `memory_table`    | `Optional[str]`         | -       | Name of the table to store memories.                                                                                         |
| `metrics_table`   | `Optional[str]`         | -       | Name of the table to store metrics.                                                                                          |
| `eval_table`      | `Optional[str]`         | -       | Name of the table to store evaluation runs data.                                                                             |
| `knowledge_table` | `Optional[str]`         | -       | Name of the table to store knowledge content.                                                                                |
| `traces_table`    | `Optional[str]`         | -       | Name of the table to store traces.                                                                                           |
| `spans_table`     | `Optional[str]`         | -       | Name of the table to store spans.                                                                                            |
| `versions_table`  | `Optional[str]`         | -       | Name of the table to store schema versions.                                                                                  |
| `create_schema`   | `bool`                  | `True`  | Whether to create the database schema if it doesn't exist. Set to `False` when the schema is managed externally.             |