/<org-slug>/queries にある保存済みクエリのライブラリ：組み込みプリセットとチームが保存したクエリが並んで表示されます。
白紙のページではなく、プリセットから始める
テーブル名を覚えたり、SQL をゼロから書いたりする必要はありません。ライブラリは、チームがよく尋ねる質問に対応した組み込みプリセットと、自分のチームが保存・命名したクエリが隣り合わせで表示された状態で開きます。求めているものに近いものを選べば、答えのほとんどは得られています。 保存済みクエリはすべて組織スコープで共有されるため、チームメンバーが書いた便利なクエリはあなたのものにもなります。クエリに名前と説明を一度つけておけば、組織内の誰でも見つけて実行したり、後でダッシュボードに結果をピン留めしたりできます。/<org-slug>/queries からアクセスできます。
SQL コンポーザーで調整して実行する
クエリを開くと SQL コンポーザーが表示され、そこで調整してすぐに答えを確認できます。エクスポートも往復も、他の誰かを待つ必要もありません。
- スキーマサイドバーにより、分析テーブルとそのカラムが一覧表示されるため、フィールド名を探し回らずにクエリを組み立てられます。
- ライブ結果グリッドは実行した瞬間に行を返すため、何度も推測を繰り返すのではなく、数秒で反復作業を進められます。
- 設計上、読み取り専用です。 クエリはイベントストアに対して実行され、サーバー側で検証されます。
SELECTおよびWITHステートメントのみが許可され、ステートメントのタイムアウトと行数の上限が設けられています。探索的なクエリがデータを変更することはなく、暴走したクエリは自動的に停止されます。
ターミナルから実行する、またはアシスタントに作成させる
保存済みクエリは、どこで作業していても同じように使えます。- ターミナルから。
agenteyeCLI は同じ保存済みクエリを一覧表示、実行、保存できるため、スクリプトに結果を組み込んだり、CI に組み入れたり、コーディングエージェントに渡したりできます。
- AI アシスタントから。 SQL をどう書けばよいかわからない場合は、ダッシュボード内の AI アシスタント に平易な言葉で尋ねると、クエリを作成してライブラリに保存してくれます。
queries:run 権限によって管理され、クエリの作成や削除の権限とは別になっています。そのため、ライブラリを書き換える権限を与えることなく、読み取りアクセスだけを付与できます。
関連項目
- ダッシュボード：クエリ結果を組織全体で共有できるチャートにピン留めする。
- AI アシスタント：平易な言葉で質問してクエリを取得する。
- CLI とエージェント：ターミナルから同じクエリを実行・保存する。