---
title: Database Instances
description: Datadog, the leading service for cloud-scale monitoring.
breadcrumbs: Docs > DDSQL Reference > Data Directory > Database Instances
---

# Database Instances

The Database Instances table provides metadata about monitored database instances across DBMS types supported by Database Monitoring (e.g., PostgreSQL, MySQL, SQL Server, MongoDB, Oracle, ClickHouse). Each row represents an instance and includes connection details, version, tags, and settings. Use the `dbms` field to filter by engine (lowercase identifiers such as postgres, mysql, sqlserver, mongo, oracle, clickhouse). Logical database datasets expose `database_instance_key` to join to this table's `_key`.

```
dd.database_instances
```

## Fields

| Title               | ID                  | Type | Data Type | Description                                                                                                                                                                        |
| ------------------- | ------------------- | ---- | --------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Key                 | _key                | core | string    | Unique identifier for the database instance record (e.g., 1f2c34a5b06d7e6c5ab12f8901abcdef).                                                                                       |
| Name                | name                | core | string    | Name of the database instance (e.g., storefront-db-0.storefront-db.postgres-storefront.svc.internal.cluster.local).                                                                |
| Display Name        | display_name        | core | string    | Human-readable display name for the instance (e.g., storefront-db-0.storefront-db.postgres-storefront.svc.internal.cluster.local).                                                 |
| DBMS                | dbms                | core | string    | Database management system identifier in lowercase (e.g., postgres).                                                                                                               |
| Connection Host     | connection_host     | core | string    | Host used to connect to the database instance (e.g., 123.45.67.89).                                                                                                                |
| Hostname            | hostname            | core | string    | Hostname associated with the instance (e.g., orders-api-db-0.orders-api-db.postgres-orders.svc.internal.cluster.local).                                                            |
| Database Version    | database_version    | core | string    | Reported database engine version (e.g., v11.22.0).                                                                                                                                 |
| Integration Version | integration_version | core | string    | Version of the Datadog integration collecting this instance (e.g., v18.3.0).                                                                                                       |
| DBM                 | dbm                 | core | bool      | Whether Database Monitoring is enabled for this instance.                                                                                                                          |
| Tags                | tags                | core | json      | Tags associated with the instance as a JSON array of strings; shape may vary (e.g., ["app:postgres","env:staging","dbms:postgres"]).                                               |
| Cloud Metadata      | cloud_metadata      | core | json      | Cloud provider metadata for the instance as a JSON object (e.g., {"aws":{"instance_id":"i-0abc123..."}}). May be empty when the instance is not in a recognized cloud environment. |
| Settings            | settings            | core | json      | Instance-level settings as a JSON object (e.g., {"instance_endpoint":"postgres-instance.example.rds.amazonaws.com"}). May be empty or null when unused.                            |