DDSQL Editor

Cette page n'est pas encore disponible en français, sa traduction est en cours.
Si vous avez des questions ou des retours sur notre projet de traduction actuel, n'hésitez pas à nous contacter.

Overview

With DDSQL Editor, you can get deeper visibility into your infrastructure by querying your resources with natural language or with DDSQL, a dialect of SQL with additional support for querying tags.

The result of a SQL query showing cloud provider host count on the DDSQL page in Datadog

Query in natural language

Type your question into the search box, and Datadog builds the SQL query for you. If you haven’t already, reach out to support to enable this feature.

A query inputted into the natural language search box

Use SQL syntax (DDSQL)

DDSQL is a query language for Datadog data. It implements several standard SQL operations, such as SELECT, and allows queries against unstructured data, such as tags. Get exactly the data you want by writing your own SELECT statement. Query tags as if they are standard table columns.

There are two different variants of DDSQL. See the syntax documented in DDSQL Reference.
SELECT instance_type, count(instance_type)
FROM aws.ec2_instance
WHERE tags->'region' = 'us-east-1' -- env is a tag, not a column
GROUP BY instance_type

Explore your infrastructure data

View and filter the list of tables and fields in the schema side panel:

Side panel showing a list of available tables for querying in the DDSQL Editor

Click a table name to view its columns and relationships:

The data tab showing table information for aws.ec2_instance

Save and share queries

Save useful queries for future reference or download the data as CSV.

DDSQL Editor interface showing query results with save and export options highlighted

Export a saved query to a dashboard by clicking Save to Dashboard. From a dashboard you can visualize results and send Scheduled Reports.

Browse and re-run recent or saved queries in the side panel.

Side panel showing the Queries tab with a list of saved and recent queries in the DDSQL Editor

Permissions

To access the DDSQL Editor app, users need the ddsql_editor_read permission. This permission is included in the Datadog Read Only Role by default. If your organization uses custom roles, add this permission to the appropriate role. For more information on managing permissions, see the RBAC documentation.

Further reading

Documentation, liens et articles supplémentaires utiles:

PREVIEWING: guacbot/translation-pipeline