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

