データに関する質問を平易な日本語で入力すると、Studioが最適化されたTrino SQLに変換し、アカウントに対して実行して結果を表示します。これらすべてがチャットストリーム内で完結します。SQLの完全な可視性により、結果に基づいて行動する前にすべてのクエリを確認できます。
AIはサンドボックス実行環境内でtdx queryコマンドを使用してTrinoクエリを実行します。生成されたすべてのSQL文はツールコールの展開表示で確認できるため、独立してレビュー、コピー、再実行が可能です。
自然言語によるリクエストを通じてTreasure AIアカウントに対してTrinoクエリを実行し、会話内にインラインで構造化された読みやすい結果を受け取ります。
- Treasure AI Studioにサインイン済みであること（はじめに）
- Treasure AIアカウントでアクセス可能なデータベースが少なくとも1つあること
データをクエリする最も簡単な方法は、求めていることを平易な言葉で説明することです。
- 「過去30日間で売上上位10名の顧客を表示してください」
- 「
pageviewsテーブルには何行ありますか？」 - 「
mydb.usersにはどのようなカラムがありますか？」
AIはリクエストをTrino SQLクエリに変換し、tdx queryを使用して実行し、結果をフォーマットされたテーブルとして表示します。これらすべてがチャットストリーム内で完結します。
- クエリを自然言語で説明します
- AIがSQLを作成し、Bashツール経由で実行します：
tdx query "SELECT ..." - ツールコールがチャットに表示され、実行中のコマンドを確認できます
- クエリ結果が自動的に構造化されたテーブルとして表示されます（クエリ結果テーブルを参照）
- AIが結果を解釈し、会話を続けます
各ステップがリアルタイムで進行するのを確認できます。ツールコールインジケーターには実行中のコマンドが表示され、結果が届くと結果テーブルが自動的に展開されます。
クエリの構文と実行を正確に制御するには、実行したいコマンドをAIに直接指示します。
You: Run tdx query "SELECT count(*) AS total_users FROM mydb.users"または、スキーマの簡易確認のためにtdx describeやtdx showの使用を指示することもできます。
You: Describe the mydb.users table
You: Show me a preview of mydb.users| コマンド | 目的 | 出力 |
|---|---|---|
tdx query "<sql>" | 任意のTrino SQLを実行する | クエリ結果テーブル |
tdx describe <db.table> | テーブルスキーマを表示する（カラム名と型） | スキーマテーブル |
tdx show <db.table> | テーブルデータをプレビューする（デフォルト件数制限付きのSELECT *） | データテーブル |
完全なコマンドリファレンスについては、TDXコマンドを参照してください。
クエリが実行されると、チャットストリームにツールコールインジケーターが表示されます。
- スピニングローダーアイコンがクエリの進行中を示します
- コマンドの説明がモノスペースフォントで完全なコマンドプレビューとともに表示されます
- 実行中のSQLを正確に確認できます
- 緑色のチェックマークがスピナーと置き換わります
- ツールコールの行が展開可能になります — クリックすると完全なコマンドと生の出力を確認できます
- クエリ結果テーブルがツールコールの下に自動的に表示され、カラムヘッダー、型、フォーマットされたデータを含む構造化された結果が表示されます
- 実行統計がテーブルの下に表示されます（詳細はクエリ結果テーブルを参照）
- 実行時間バッジが1秒以上の場合に実行時間を表示します（例：「3.2s」）
- 赤いXアイコンがクエリの失敗を示します
- 「クエリが失敗しました」エラーカードが以下の情報とともに表示されます：
- 実行されたSQL（モノスペースフォント）
- クエリエンジンからのエラーメッセージ
- トラブルシューティング用のジョブID
- ツールがゼロ以外のステータスで終了した場合、終了コードバッジ（例：「Exit 1」）が表示されます
AIの応答の一部としてクエリが実行中の場合、チャット入力エリアの停止ボタン（四角いアイコン）をクリックしてAIの実行ストリームを中断できます。
応答を停止すると、AIの実行ストリームが終了します。クエリ自体はTrinoエンジン上で引き続き実行される場合があります。長時間実行されているクエリをキャンセルする必要がある場合は、Treasure AIコンソールを使用してください。
StudioはBashツールコールからクエリ結果を自動的に検出します。UIは以下を含むコマンドを認識します。
tdx query、tdx describe、tdx showtrino、prestopsql、mysql、sqlite3
検出された場合、生の出力はプレーンテキストとして表示されるのではなく、構造化されたテーブルとして解析されます。2つの出力フォーマットが認識されます。
| フォーマット | 説明 |
|---|---|
| JSON配列 | [{"col1": val1, ...}, ...] — --jsonフラグによって生成される |
| 罫線テーブル | ┌─│├┤┘文字を使用したUnicodeテーブル形式 — tdx queryのデフォルト出力 |
クエリの検出はdetectQueryResult()関数を介してクライアント側で行われます。この関数はBashコマンド文字列と出力フォーマットを検査します。Bashツールコールがクエリコマンドパターンにマッチし、その出力に有効なJSON配列または罫線テーブル文字が含まれている場合、出力はプレーンテキストの代わりにQueryResultTableコンポーネントとして表示されます。ストリーミング中に結果が検出されると、テーブルは自動的に展開されます。
複雑なクエリの場合、作業フォルダ設定で組み込みのSQLスキルを有効化することで、レイテンシを削減し効率を向上させることができます。
| スキル | 機能 |
|---|---|
sql-skills:trino | Treasure AIのベストプラクティスに基づいたTrino SQLを作成する |
sql-skills:hive | 重い処理向けのHive SQLを作成する |
sql-skills:time-filtering | 時間ベースのクエリにtd_intervalとパーティションプルーニングを適用する |
sql-skills:trino-optimizer | 低速なTrinoクエリを分析・最適化する |
sql-skills:trino-to-hive-migration | メモリ消費の多いTrinoクエリをHiveに変換する |
例：sql-skills:trino-optimizerスキルが有効な状態で、クエリのレイテンシのボトルネックを分析するようAIに依頼します。パーティションプルーニング、述語プッシュダウン、その他の最適化が提案されます。
完全なスキルカタログについては、スキルとマーケットプレイスを参照してください。
まず自然言語から始めましょう。 AIにクエリの初稿を作成させてください。結果を解釈する前に、ツールコール内のSQLを確認してください。
クエリの前に
tdx describeを使用しましょう。 スキーマ（カラム名、型）を理解することで、あなたとAIの両方が正確なクエリを作成しやすくなります。データベースコンテキストを設定しましょう。 セッションの開始時にAIに
tdx use database mydbを実行させることで、すべてのクエリで完全修飾テーブル名を入力する手間を省けます。生成されたSQLを確認しましょう。 AIはあなたの説明と検出したスキーマに基づいてSQLを作成します。結果に基づいて行動する前に、必ずツールコールの展開表示でクエリを確認してください。
大きな結果セットには出力フォーマットフラグを使用しましょう。 大きな結果セットを処理する必要がある場合、AIに
--json（構造化出力）または--output results.csv（ファイルへの保存）の使用を指示してください。
- 「[your_database].[your_table]には何行ありますか？」と質問し、
tdx queryを実行するツールコールが表示されることを確認する - 結果がカラムヘッダーと型を含む構造化されたテーブルとして表示されることを確認する
- ツールコールを展開して完全なSQLと生の出力を確認する
| 問題 | 解決策 |
|---|---|
| クエリに時間がかかりすぎる | sql-skills:trino-optimizerスキルを使用してレイテンシの問題を分析してください。一般的な原因：フルテーブルスキャン（パーティションプルーニングを追加）、過剰なJOIN、時間カラムのWHERE句の欠如 |
| 「アクセスが拒否されました」でクエリが失敗する | Treasure AIアカウントがデータベースとテーブルへのアクセス権を持っていることを確認してください。AIにtdx databasesを実行させて利用可能なデータベースを確認してください |
| AIが誤ったSQLを作成する | クエリリクエストの前にsql-skills:trinoスキルを有効化してください。これによりAIにTreasure AI固有のSQLパターンと関数が提供されます |
- クエリ結果テーブル — フォーマット、カラム型、統計情報
- TDXコマンド — 完全なCLIコマンドリファレンス
- スキルとマーケットプレイス — 最適化とベストプラクティスのためのSQLスキル