DDSQL エディター

高度なデータソース

まだ利用できないデータソースをクエリしたい場合は、以下のフォームを使用してリクエストを送信してください。サポートされているデータソースの全リストについては、データディレクトリを参照してください。

Request Access

概要

DDSQL エディタ を使用すると、自然言語またはタグクエリを追加サポートした SQL 方言の DDSQL でリソースにクエリを実行し、テレメトリをより深く可視化できます。

DDSQL クエリの結果をエクスポートして Dashboard やノートブックで可視化したり、DDSQL Actionを通じて Datadog ワークフローで自動化したりすることもできます。

DDSQL クエリは、Datadog MCP Server ddsql ツールセットを使用して、AI エージェントから実行できます (プレビュー)。

Datadog の DDSQL ページで、ホストごとの平均 CPU 使用率を示す SQL クエリの結果

自然言語でクエリ

検索ボックスに質問を入力すると、Datadog があなたに代わって SQL クエリを構築します。変更を承諾または破棄したり、フィードバックを提供して機能の改善に役立てたりすることができます。

自然言語検索ボックスに入力されたクエリ

SQL 構文を使用する (DDSQL)

DDSQL は、Datadog データのクエリ言語です。SELECT などの標準的な SQL 操作をいくつか実装しており、タグ などの非構造化データに対するクエリを可能にします。独自の SELECT ステートメントを作成して、必要なデータを正確に取得します。タグを、標準のテーブルの列としてクエリします。詳細については、DDSQL リファレンスを参照してください。

SELECT instance_type, count(instance_type)
FROM aws.ec2_instance
WHERE tags->'region' = 'us-east-1' -- region is a tag, not a column
GROUP BY instance_type

テレメトリを探索する

Data Explorer でクエリをビュー、フィルター、およびビルドします。

テーブル名をクリックすると、そのカラムとリレーションシップを表示できます:

aws.ec2_instance のテーブル情報を表示するデータタブ

Logs などのデータソースについては、クエリビルダーを使用してテーブル関数を生成します。

クエリを保存および共有する

将来参照できるよう便利なクエリを保存したり、データを CSV としてダウンロードしたりできます。サイド パネルで最近または保存済みのクエリを閲覧および再実行できます。

保存およびアクションのドロップダウンが強調表示された、クエリ結果を表示する DDSQL エディターインターフェース

保存済みクエリの結果を以下にエクスポートします。

DDSQL エディターで、保存済みクエリと最近のクエリを一覧表示する [Queries] タブを示すサイドパネル

権限

DDSQL エディターアプリにアクセスするには、ユーザーに ddsql_editor_read 権限が必要です。この権限は、デフォルトで Datadog Read Only ロールに含まれています。組織でカスタムロールを使用している場合は、適切なロールにこの権限を追加してください。権限の管理の詳細については、RBAC のドキュメントを参照してください。

参考資料