クエリ結果テーブル

WebDesktop

すべてのクエリ結果は、チャット内で読みやすい構造化テーブルとして表示されます。カラムの型、数値の配置、NULLの処理、実行統計が自動的にレンダリングされるため、スプレッドシートに切り替えることなく結果を確認できます。

Note

クエリ結果テーブルは、tdx query の生の出力からクライアント側でレンダリングされます。AIはクエリ出力を自動的に検出し、プレーンテキストではなく構造化テーブルとして表示します。追加の処理は必要ありません。

目的

カラムの型、フォーマット済み値、実行メタデータ、エラー診断など、チャットストリーム内でクエリ結果をインラインで読み取り、解釈します。

前提条件

Treasure AI Studio にサインイン済みであること（はじめに）
クエリ実行が完了していること（クエリ実行を参照）
Web またはDesktopのみ — クエリ結果テーブルはモバイルでは利用できません

テーブルのレイアウト

クエリ結果テーブルは、それを生成したツールコールの下に、チャット内でインライン表示されます。ストリーミング中に結果が検出されると、テーブルは自動的に展開されます。

構造

セクション	説明
ヘッダー行	太字のカラム名と、各名前の下に小さいテキストで表示されるカラムの型（例：`varchar`、`bigint`、`double`）
データ行	データ型に基づいてフォーマットされたクエリ結果
統計行	テーブル下部の実行メタデータ

ヘッダー行は固定表示されます — 長い結果セットをスクロールしても常に表示されます。テーブルの最大高さは300ピクセルで、大きな結果には縦スクロール、幅の広いテーブルには横スクロールが使用されます。

カラムの型とフォーマット

テーブルは、クエリエンジンから報告されたカラムの型に基づいて値をフォーマットします。

数値

数値型のカラムは、カラムの視認性を高めるために右揃えでタブ区切り数値フォーマットで表示されます。認識される数値型：

int、bigint、double、float、decimal、smallint、tinyint、real、long、number

その他のすべての型は左揃えで表示されます。

特殊な値

値	表示
NULL	イタリック体のミュートテキストで `NULL` と表示
true	緑色のテキストで表示
false	ミュートテキストで表示
文字列	そのまま表示

行のハイライト

任意の行にカーソルを合わせると、背景が薄くハイライトされます — 多くのカラムを持つ幅の広いテーブルで行を追跡する際に便利です。

実行統計

結果テーブルの下に、クエリ実行に関するメタデータを示す統計行が表示されます。フォーマットは次のとおりです：

X rows · Processed Y rows · in Z · Job N

統計	説明	例
行数	返された行数	`42 rows`
処理行数	Trinoエンジンがスキャンした合計行数	`Processed 1.2M rows`
経過時間	クエリ実行時間（レイテンシ）	`in 3.2s`
ジョブID	Treasure AIのジョブ識別子	`Job 987654321`

すべての統計がすべてのクエリで表示されるわけではありません。統計行には、クエリエンジンの出力から取得できるフィールドのみが表示されます。

Pro Tip

ジョブIDを使用して、Treasure AIコンソールでクエリを検索し、詳細な実行プラン、リソース使用状況、ログを確認できます。返された行数に対して「処理行数」が多い場合は、パーティションプルーニングが適用されていない可能性があります — /sql-skills:trino-optimizer を使用して診断してください。

エラー表示

クエリが失敗した場合、結果テーブルはエラーカードに置き換えられます：

エラーカードには以下が含まれます：

要素	説明
警告アイコン	失敗を示す赤い三角形
「Query failed」ラベル	赤色のヘッダーテキスト
SQL	実行されたクエリ（等幅フォント）
エラーメッセージ	クエリエンジンからの完全なエラーテキスト
ジョブID	Treasure AIのジョブ識別子（利用可能な場合）

よくあるエラーのシナリオ：

エラー	原因	対処法
テーブルが見つからない	データベースまたはテーブル名が間違っている	AIに `tdx databases` と `tdx tables <db>` を実行させて確認する
カラムが見つからない	カラム名のスペルミスまたは存在しないカラム	AIに `tdx describe <db.table>` を実行させてスキーマを確認する
権限が拒否された	データベースへのアクセス権限が不足している	Treasure AIの管理者に連絡する
構文エラー	無効なSQL	エラーカードのSQLを確認して構文を修正する

コンテキスト内での結果の読み取り

クエリ結果テーブルは、会話の流れの一部として表示されます。テーブルがレンダリングされた後、AIは通常、結果に基づいた分析や次のステップを提示します。例えば：

ユーザーが質問します：「売上上位5社の顧客は？」
AIが実行します：tdx query "SELECT customer_id, SUM(revenue) AS total ... LIMIT 5"
5行の結果テーブルがレンダリングされます
AIが要約します：「顧客ID 12345が合計売上$2.3Mでトップです...」

クエリ出力は会話コンテキストの一部であるため、AIは後続のメッセージで結果を参照できます。

ツールコールとの統合

クエリ結果はツールコールインジケーター内に表示されます。各クエリ実行には以下が表示されます：

ステータスアイコン — スピニング（実行中）、緑のチェックマーク（完了）、赤のX（エラー）
説明 — ツールが実行している内容（例：Bashコマンドの説明）
コマンドプレビュー — 等幅フォントで表示される完全なコマンド（1行に省略）
展開/折りたたみ — クリックして完全なコマンドテキストと結果を切り替え
コピーボタン — ホバー時に表示され、コマンドテキストをクリップボードにコピー
実行時間バッジ — 1秒以上の場合に実行レイテンシを表示（例：「3.2s」）
終了コードバッジ — コマンドがゼロ以外の終了コードを返した場合に「Exit 1」（赤）を表示

クエリ結果はストリーミング中に検出されると自動的に展開されるため、クリックしなくてもテーブルが表示されます。

Technical Note

12行を超えるツールコール結果には「Show N more lines」リンクが表示されます。ただし、クエリ結果はこの省略を回避します — 常に独自の300pxスクロール可能なビューポートを持つ完全な QueryResultTable コンポーネントとしてレンダリングされます。

現在の制限事項

クエリ結果テーブルはクエリ出力をインラインで表示するために設計されています。現在のリリースでは以下の機能は利用できません：

ソート — レンダリングされたテーブルではカラムのソートができません。結果を並び替えるには、AIに ORDER BY 句を追加してクエリを再実行するよう依頼してください。
フィルタリング — クライアント側の行フィルタリングはありません。フィルタリングにはクエリに WHERE 句を追加してください。
ページネーション — 返されたすべての行がスクロール可能なビューポート（最大高さ300px）に表示されます。大きな結果セットには、クエリで LIMIT を使用してください。
エクスポート — テーブルからの直接CSV/Excelエクスポートはありません。結果をエクスポートするには、AIに tdx query --output results.csv "..." を使用してファイルに出力を保存するよう依頼してください。
カラムのリサイズ — カラム幅はコンテンツに基づいて固定されています。