# 結果とグラフ

> DuckLocal のクエリ結果を絞り込み、コピーし、すべての列をプロファイルして、棒グラフ、折れ線、散布図、円グラフ、地図を描き、結果を CSV や Parquet にエクスポートする方法。

Source: https://ducklocal.app/docs/ja/results-and-charts

エディタの下のパネルには **結果**、**グラフ**、**概要** の 3 つのタブがあります。タブの右側には、結果のサイズ（`N rows · M columns`）と **CSV をエクスポート**、**Parquet をエクスポート** ボタンがあります。

**結果** タブには、エディタの **Explain** ボタンと **Profile** ボタンが出力する内容も表示されます。[Explain と Profile の出力](#explain-and-profile) を参照してください。

## 結果グリッド

グリッドは `#` の行番号列から始まり、その後にクエリ結果の列が続きます。数値列は右揃えです。初期の幅はヘッダーと先頭 200 行から計算し、中国語や日本語の文字は 2 文字分の幅として数えます。幅はデフォルトの[インターフェースサイズ](settings-and-data.md#interface-size)で 80〜360 ピクセルの範囲になり、他のサイズでは比例して変化します。列の境界をドラッグすると幅を調整できます。`#` 列はサイズ変更できません。列がパネルより広い場合、水平スクロールバーが列の下に常に表示されます。

列のヘッダーの矢印をクリックすると、読み込み済みの行をその列で並べ替えられます。降順、昇順、クエリの順序に戻る、の順です。数値列は数値として、それ以外はテキストとして並べ替えます（ISO 形式の日付や時刻が正しい順序になります）。`NULL` は最後に並び、値が等しい行はクエリの順序を保ちます。[フィルター](#filtering) を適用しても並べ替えは維持され、次の結果は並べ替えなしで始まります。並べ替えはフィルターと同様にクライアント側で行われるため、読み込んだ以上の行を並べ替えるには `ORDER BY` を使ってください。

### セルの表示

| 値 | 表示 |
| --- | --- |
| `NULL` | 文字列 `NULL`（淡い色で表示） |
| BLOB | `<blob N bytes>` |
| GEOMETRY | `<geometry N bytes>` |
| 整数値の浮動小数点 | `3.0` |
| タイムスタンプ | `2026-09-17 04:21:09.5` — **UTC であり、ローカル時刻ではありません**。小数部の桁数は値の桁数と同じです（TIMESTAMP_NS なら 9 桁） |
| インターバル | `1 day 02:00:00` のような DuckDB の記法 |
| リスト / 構造体 / マップ | 整形して表示 |

タイムスタンプを SQL で比較するのではなく目視で確認する場合は、UTC で表示されることを覚えておくとよいでしょう。

### フィルター {#filtering}

フィルターボックスは、読み込み済みの行の**すべてのセル**に対して、大文字小文字を区別しない部分一致検索を行います。クライアント側で動作するため、データベースにクエリを発行することはなく、実際の結果サイズではなく読み込まれた行だけが対象です。

フィルターは Enter を押したとき、またはボックスをクリアしたときに適用され、キー入力ごとには適用されません。フィルターが適用されている間、グリッドの横に `visible / total rows` と表示されます。

## 行の上限 {#row-limits}

結果は、次のいずれかに先に達した時点で切り捨てられます:

- **100,000 行**
- **2,000,000 セル** — そのため 400 列の結果では約 5,000 行しか生成されません

セルの上限があるのは、行数の上限だけでは作業量を抑えられないからです。カーディナリティの高い列に対する `PIVOT` は個別値ごとに 1 列を返すため、数千万セルを整形するとハングしたように見えてしまいます。

切り捨てはバナーで通知され、実際に読み込まれた行数が示されます。**ページネーションも「さらに読み込む」もありません**。代わりにクエリを絞り込んでください。

## コピー

セルにカーソルを合わせるとコピーボタンが現れ、そのセルのテキストをクリップボードにコピーできます。セルを右クリックすると **セルをコピー**、**行をコピー**（タブ区切り）、**列をコピー**（表示順に 1 行 1 値）を選べます。行番号を右クリックするとその行をコピーできます。コピーは現在のフィルターと並べ替えに従います。ダッシュボードのテーブルでも同じ 3 つのコピー操作が使えます。範囲選択や「SQL としてコピー」はありません。1 行や 1 列を超える場合は [エクスポート](#export) を使ってください。

## エクスポート {#export}

`Export CSV` と `Export Parquet` は、パス入力欄のある小さなダイアログを開きます。初期値は `~/Desktop/export.csv` または `~/Desktop/export.parquet` です。

注意点が 2 つあります:

- エクスポートは**現在の行を生成した SQL を再実行します**。そのためファイルには、フィルター後のビューでも切り捨てられたグリッドでもなく、クエリの完全な結果セットが入ります。
- ファイル選択ダイアログも上書き確認もありません。パスを入力すれば、そのまま書き込まれます。

## グラフ {#charts}

列を選ぶまでは、グラフはグリッドにすでにある行から、クエリが返した順序で、集計なしで描かれます。[**X**、**Y**、**分割** メニュー](#pick-columns)を使うと、代わりに DuckDB が結果全体をグループ化します。

グラフの上のグラフ選択は **自動** から始まり、結果の列に応じて選びます:

| 結果に含まれるもの | 自動で描かれるもの |
| --- | --- |
| 緯度と経度の列 | 地図 |
| 時間型の最初の列（日付 / タイムスタンプ） | エリアグラフ。x は 0 列目、数値列ごとに 1 系列 |
| それ以外 | 棒グラフ。0 列目がラベル、最初の数値列が値 |

「数値列」には最初の列も含まれます。0 列目が数値（時間、年、ID など）の場合、棒グラフのラベルではなく値になります。ラベルにしたい場合はテキストにキャストしてください（`year::VARCHAR`、または `format('{:02d}:00', hour(ts))`）。

**棒**、**折れ線**、**エリア**、**散布図** はどの結果でもワンクリックで選べます。**円** は最初の列が時刻でない結果で、**地図** は座標のある結果で選べます。選択は実行をまたいで保持されます。新しい結果でその種類を描けない場合（座標のない地図など）、グラフはあなたの選択を忘れずに、自動の選択にフォールバックします。

### 列を選択 {#pick-columns}

グラフの上の **X**、**Y**、**分割** メニューで、描く内容を選びます。**Y** は行数、または数値の合計、平均、最小、最大です。すると DuckDB は読み込み済みの行ではなく結果全体をグループ化し、上位 200 カテゴリー（または並べ替えた先頭 50,000 値）と上位 12 系列を保持します。除外されたものは通知で示されます。

- **分割** を選ぶと、**積み上げ** と **ヒートマップ** がグラフ選択に加わり、**円** が外れます。
- **ヒストグラム** はビン分けできる数値があるときに表示されます。DuckDB が結果全体をビン分けします。
- **.dash としてコピー** は、選択内容を [ダッシュボード](dashboards.md)で同じグラフを描く `query` ブロックと `plot` ブロックとしてコピーします。

選択がない場合、切り捨てられた結果のグラフには **グリッドが読み込んだ先頭 N 行から描画しており、結果全体ではありません** と表示されます。切り捨てられた時系列はバックグラウンドで再実行され、すべての行で平均されます。

### グラフの種類と制限

**円** グラフはラベルごとに最初の数値列の値を描き、大きい順に並べます。ゼロ、負の値、欠損値はスライスとして描かれず、通知でその件数が示されます。8 スライスを超えると、上位 7 つがスライスを保ち、残りは「その他」にまとめられます。

**地図** は列名で判定されます:

- **緯度:** `lat`、`latitude`、またはそれらを含む名前（`geo_lat`、`start_lat`）— `纬度` も使えます。
- **経度:** `lng`、`lon`、`long`、`longitude`、同様に — `经度` も使えます。

各行は、点に合わせて調整された Web メルカトル図法上の点として、度でラベル付けされた緯度経度グリッドの上に描かれます。個別値が少ないテキスト列は色分けされます。点にカーソルを合わせるとその行が表示されます。

点の下には OpenStreetMap のベースマップを描けます。**表示 → オンラインベースマップ（OpenStreetMap）** でオンにします。タイルの読み込みにはネットワークが必要なため、デフォルトではオフです。リクエストから分かるのはおおよそ表示中の領域だけで、行のデータは一切送られません。タイルは 1 週間キャッシュされ、オフラインでは緯度経度グリッドだけの上に地図を描きます。

値のセルが数値でない行（`NULL` など）は、プロット前に除外されます。

制限はすべて、グラフタイトルの下の通知行で告知されます:

| 制限 | 動作 |
| --- | --- |
| 12 系列 | 余分な数値列は破棄されます |
| 1,500 点 | 系列はバケットに分けられ、各バケット内で**平均**されます |
| 200 本の棒 | 超過分の棒は切り捨てられ、統合はされません |
| 8 つの円スライス | 最小のものが「その他」にまとめられます |
| 20,000 の地図点 | 超過分の点は除外されます |

タイトルには常にプロットされた点数が表示されるので、曲線の形を信じる前に確認してください。

## 列の概要 {#overview}

**概要** タブは、現在の結果のすべての列を一度に説明します。どれだけ埋まっているか、いくつの値をとるか、範囲、そして値がどのようなものかです。

見出し行は `Current result · N rows · M columns · took …` と表示されます。その後、各列に 1 行が割り当てられます:

| 部分 | 表示内容 |
| --- | --- |
| 名前と型 | 列名とその DuckDB の型 |
| NULL | `NULL` である行の割合（小さなバー付き）。0% を超えると強調表示されます |
| 個別値 | `~N distinct` — DuckDB による個別値数の推定値 |
| 範囲 | 最小 – 最大、等しい場合はその単一の値 |
| 中央値 | 数値、日付、タイムスタンプの場合 |
| 分布 | 小さなグラフ（後述） |

分布は列の型によって異なります:

- **数値、日付、タイムスタンプ** は約 12 本の等幅バーによるヒストグラムになります。単一の値しかない列は、その値を列挙します。
- **テキストと真偽値** は最も多い 5 つの値を、それぞれ行に占める割合とともに列挙します。値にカーソルを合わせると正確な件数が表示されます。個別値が約 10,000 を超えると、値は推定され、割合なしで *一般的な値（推定）* として列挙されます。
- **リスト、構造体、マップ、ユニオン** にはグラフがありません。

仕組み:

- **概要はクエリを全体として再度実行します**。2 回のスキャンで、統計には `SUMMARIZE`、続いて各列の分布のために 1 つの `SELECT` を使います。そのため[行の上限](#row-limits)でグリッドが保持した行だけでなく、結果全体を対象にします。遅いクエリはまた遅くなります。非決定的なクエリ（`random()`、`USING SAMPLE`）は、その 2 回目の実行で得られた内容として説明されます。
- タブを開いたときに計算され、タブを開いている間は新しい結果ごとに再計算されます。
- **`FROM ( … )` の中に入れられるクエリだけが要約できます**。`SELECT`、`WITH`、`FROM`、`VALUES`、`TABLE`、`PIVOT`、`UNPIVOT` で始まるクエリです（先頭の `--` コメントは読み飛ばされます）。それ以外（`SHOW`、`DESCRIBE`、`PRAGMA`、`CALL`、`SUMMARIZE`）では *クエリの結果（SELECT、WITH、FROM…）だけが要約できます。概要はそれを再実行します。* と表示されます。

クエリを書かずにテーブル、ビュー、登録済みファイル全体を要約するには、サイドバーで右クリックして **列の概要** を選びます。エディタに `FROM <name>;` が入り、実行されてこのタブが開きます。[右クリックメニュー](schema-and-history.md#right-click-menu) を参照してください。

## Explain と Profile の出力 {#explain-and-profile}

エディタツールバーの [**Explain** と **Profile** ボタン](sql-editor.md#explain-and-profile)は、出力を **結果** タブに表示し、別のタブが開いていれば切り替えます。どちらもグリッドを置き換えるので、行を元に戻すにはクエリを再実行してください。

**Explain** は DuckDB のプランを、`EXPLAIN · took …` の行の下に等幅のプレーンテキストで表示します。

**Profile** は実際に実行されたプランをツリーとして表示し、演算子ごとに 1 行、それぞれが供給元の演算子の下にインデントされます:

- すべての演算子が使った時間に占める、その演算子の割合のバー
- その演算子自身の時間（子の時間は除く）
- `TABLE_SCAN`、`FILTER`、`HASH_GROUP_BY` などの名前
- `N rows` — その演算子が生成した行数
- `est. N` — プランに推定値がある場合の、オプティマイザーによる行数の推定値。10 倍を超えて外れている場合は強調表示されます（カーソルを合わせると *推定が 10 倍以上外れています* と表示されます）。その規模の外れは、結合が遅いよくある原因です
- その下に、その演算子が扱ったもの（フィルター、結合キー、射影）

見出し行は `Profile · took … · operators …` と表示されます。ウォールクロック時間の後に、演算子自身の時間の合計が続きます。1 つのパイプラインの演算子は交互に実行されるため、この 2 つは異なります。バーは後者の割合です。その横には `Hottest: NAME (time)` があり、単独で最も時間を費やした演算子を示し、その演算子の行は赤で描かれます。
