# クエリ結果テーブル

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

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

## 目的

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

## 前提条件

- Treasure AI Studio にサインイン済みであること（[はじめに](/ja/products/ai-studio/getting-started)）
- クエリ実行が完了していること（[クエリ実行](/ja/products/ai-studio/query/query-execution)を参照）
- **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は通常、結果に基づいた分析や次のステップを提示します。例えば：

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


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

## ツールコールとの統合

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

1. **ステータスアイコン** — スピニング（実行中）、緑のチェックマーク（完了）、赤のX（エラー）
2. **説明** — ツールが実行している内容（例：Bashコマンドの説明）
3. **コマンドプレビュー** — 等幅フォントで表示される完全なコマンド（1行に省略）
4. **展開/折りたたみ** — クリックして完全なコマンドテキストと結果を切り替え
5. **コピーボタン** — ホバー時に表示され、コマンドテキストをクリップボードにコピー
6. **実行時間バッジ** — 1秒以上の場合に実行レイテンシを表示（例：「3.2s」）
7. **終了コードバッジ** — コマンドがゼロ以外の終了コードを返した場合に「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 "..."` を使用してファイルに出力を保存するよう依頼してください。
- **カラムのリサイズ** — カラム幅はコンテンツに基づいて固定されています。


Pro Tip
ソート、フィルタリング、リサイズなどのスプレッドシート機能を使用するには、AIにクエリ結果をCSVまたはXLSXファイルとして保存するよう依頼してください。その後、ソートとリサイズ可能なカラムをサポートする[スプレッドシートビューアー](/ja/products/ai-studio/files/file-viewers#spreadsheet-viewer)で開くことができます。

## 確認事項

- [ ] 各カラム名の下に型アノテーション（例：`bigint`、`varchar`）が付いたカラムヘッダーが表示される
- [ ] 数値カラムが右揃えで表示され、NULL値がイタリック体のミュートテキストで表示される
- [ ] テーブルの下に行数と実行時間を含む統計行が表示される


## トラブルシューティング

| 問題 | 解決策 |
|  --- | --- |
| テーブルがフォーマット済みテーブルではなく生のテキストで表示される | コマンドが `tdx query`（生のSQLクライアントではなく）を使用していることを確認してください。Studioが解析できる期待されるフォーマットが出力に含まれます |
| カラムの型が表示されない | 型アノテーションはカラムヘッダーの下に表示されます。表示されない場合、クエリ出力にスキーマメタデータが含まれていない可能性があります — 直接コマンドではなくAIを通じてクエリを実行してください |
| 統計行が表示されない | 統計行は `tdx query` で実行されたクエリのみテーブルの下に表示されます。直接のSQL出力には実行メタデータが含まれない場合があります |


## 次のステップ

- [クエリ実行](/ja/products/ai-studio/query/query-execution) — AIと直接コマンドを通じたクエリの実行
- [TDXコマンド](/ja/products/ai-studio/query/tdx-commands) — 完全なCLIコマンドリファレンス
- [ファイルビューアー](/ja/products/ai-studio/files/file-viewers) — エクスポートされた結果のスプレッドシートビューアー
- [チャートとデータビジュアライゼーション](/ja/products/ai-studio/visualization/charts) — クエリ結果の可視化