結果とグラフ
エディタの下のパネルには 結果、グラフ、概要 の 3 つのタブがあります。タブの右側には、結果のサイズ(N rows · M columns)と CSV をエクスポート、Parquet をエクスポート ボタンがあります。
結果 タブには、エディタの Explain ボタンと Profile ボタンが出力する内容も表示されます。Explain と Profile の出力 を参照してください。
結果グリッド
グリッドは # の行番号列から始まり、その後にクエリ結果の列が続きます。数値列は右揃えです。初期の幅はヘッダーと先頭 200 行から計算し、中国語や日本語の文字は 2 文字分の幅として数えます。幅はデフォルトのインターフェースサイズで 80〜360 ピクセルの範囲になり、他のサイズでは比例して変化します。列の境界をドラッグすると幅を調整できます。# 列はサイズ変更できません。列がパネルより広い場合、水平スクロールバーが列の下に常に表示されます。
列のヘッダーの矢印をクリックすると、読み込み済みの行をその列で並べ替えられます。降順、昇順、クエリの順序に戻る、の順です。数値列は数値として、それ以外はテキストとして並べ替えます(ISO 形式の日付や時刻が正しい順序になります)。NULL は最後に並び、値が等しい行はクエリの順序を保ちます。フィルター を適用しても並べ替えは維持され、次の結果は並べ替えなしで始まります。並べ替えはフィルターと同様にクライアント側で行われるため、読み込んだ以上の行を並べ替えるには 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 で表示されることを覚えておくとよいでしょう。
フィルター
フィルターボックスは、読み込み済みの行のすべてのセルに対して、大文字小文字を区別しない部分一致検索を行います。クライアント側で動作するため、データベースにクエリを発行することはなく、実際の結果サイズではなく読み込まれた行だけが対象です。
フィルターは Enter を押したとき、またはボックスをクリアしたときに適用され、キー入力ごとには適用されません。フィルターが適用されている間、グリッドの横に visible / total rows と表示されます。
行の上限
結果は、次のいずれかに先に達した時点で切り捨てられます:
- 100,000 行
- 2,000,000 セル — そのため 400 列の結果では約 5,000 行しか生成されません
セルの上限があるのは、行数の上限だけでは作業量を抑えられないからです。カーディナリティの高い列に対する PIVOT は個別値ごとに 1 列を返すため、数千万セルを整形するとハングしたように見えてしまいます。
切り捨てはバナーで通知され、実際に読み込まれた行数が示されます。ページネーションも「さらに読み込む」もありません。代わりにクエリを絞り込んでください。
コピー
セルにカーソルを合わせるとコピーボタンが現れ、そのセルのテキストをクリップボードにコピーできます。セルを右クリックすると セルをコピー、行をコピー(タブ区切り)、列をコピー(表示順に 1 行 1 値)を選べます。行番号を右クリックするとその行をコピーできます。コピーは現在のフィルターと並べ替えに従います。ダッシュボードのテーブルでも同じ 3 つのコピー操作が使えます。範囲選択や「SQL としてコピー」はありません。1 行や 1 列を超える場合は エクスポート を使ってください。
エクスポート
Export CSV と Export Parquet は、パス入力欄のある小さなダイアログを開きます。初期値は ~/Desktop/export.csv または ~/Desktop/export.parquet です。
注意点が 2 つあります:
- エクスポートは現在の行を生成した SQL を再実行します。そのためファイルには、フィルター後のビューでも切り捨てられたグリッドでもなく、クエリの完全な結果セットが入ります。
- ファイル選択ダイアログも上書き確認もありません。パスを入力すれば、そのまま書き込まれます。
グラフ
列を選ぶまでは、グラフはグリッドにすでにある行から、クエリが返した順序で、集計なしで描かれます。X、Y、分割 メニューを使うと、代わりに DuckDB が結果全体をグループ化します。
グラフの上のグラフ選択は 自動 から始まり、結果の列に応じて選びます:
| 結果に含まれるもの | 自動で描かれるもの |
|---|---|
| 緯度と経度の列 | 地図 |
| 時間型の最初の列(日付 / タイムスタンプ) | エリアグラフ。x は 0 列目、数値列ごとに 1 系列 |
| それ以外 | 棒グラフ。0 列目がラベル、最初の数値列が値 |
「数値列」には最初の列も含まれます。0 列目が数値(時間、年、ID など)の場合、棒グラフのラベルではなく値になります。ラベルにしたい場合はテキストにキャストしてください(year::VARCHAR、または format('{:02d}:00', hour(ts)))。
棒、折れ線、エリア、散布図 はどの結果でもワンクリックで選べます。円 は最初の列が時刻でない結果で、地図 は座標のある結果で選べます。選択は実行をまたいで保持されます。新しい結果でその種類を描けない場合(座標のない地図など)、グラフはあなたの選択を忘れずに、自動の選択にフォールバックします。
列を選択
グラフの上の X、Y、分割 メニューで、描く内容を選びます。Y は行数、または数値の合計、平均、最小、最大です。すると DuckDB は読み込み済みの行ではなく結果全体をグループ化し、上位 200 カテゴリー(または並べ替えた先頭 50,000 値)と上位 12 系列を保持します。除外されたものは通知で示されます。
- 分割 を選ぶと、積み上げ と ヒートマップ がグラフ選択に加わり、円 が外れます。
- ヒストグラム はビン分けできる数値があるときに表示されます。DuckDB が結果全体をビン分けします。
- .dash としてコピー は、選択内容を ダッシュボードで同じグラフを描く
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 の地図点 | 超過分の点は除外されます |
タイトルには常にプロットされた点数が表示されるので、曲線の形を信じる前に確認してください。
列の概要
概要 タブは、現在の結果のすべての列を一度に説明します。どれだけ埋まっているか、いくつの値をとるか、範囲、そして値がどのようなものかです。
見出し行は Current result · N rows · M columns · took … と表示されます。その後、各列に 1 行が割り当てられます:
| 部分 | 表示内容 |
|---|---|
| 名前と型 | 列名とその DuckDB の型 |
| NULL | NULL である行の割合(小さなバー付き)。0% を超えると強調表示されます |
| 個別値 | ~N distinct — DuckDB による個別値数の推定値 |
| 範囲 | 最小 – 最大、等しい場合はその単一の値 |
| 中央値 | 数値、日付、タイムスタンプの場合 |
| 分布 | 小さなグラフ(後述) |
分布は列の型によって異なります:
- 数値、日付、タイムスタンプ は約 12 本の等幅バーによるヒストグラムになります。単一の値しかない列は、その値を列挙します。
- テキストと真偽値 は最も多い 5 つの値を、それぞれ行に占める割合とともに列挙します。値にカーソルを合わせると正確な件数が表示されます。個別値が約 10,000 を超えると、値は推定され、割合なしで 一般的な値(推定) として列挙されます。
- リスト、構造体、マップ、ユニオン にはグラフがありません。
仕組み:
- 概要はクエリを全体として再度実行します。2 回のスキャンで、統計には
SUMMARIZE、続いて各列の分布のために 1 つのSELECTを使います。そのため行の上限でグリッドが保持した行だけでなく、結果全体を対象にします。遅いクエリはまた遅くなります。非決定的なクエリ(random()、USING SAMPLE)は、その 2 回目の実行で得られた内容として説明されます。 - タブを開いたときに計算され、タブを開いている間は新しい結果ごとに再計算されます。
FROM ( … )の中に入れられるクエリだけが要約できます。SELECT、WITH、FROM、VALUES、TABLE、PIVOT、UNPIVOTで始まるクエリです(先頭の--コメントは読み飛ばされます)。それ以外(SHOW、DESCRIBE、PRAGMA、CALL、SUMMARIZE)では クエリの結果(SELECT、WITH、FROM…)だけが要約できます。概要はそれを再実行します。 と表示されます。
クエリを書かずにテーブル、ビュー、登録済みファイル全体を要約するには、サイドバーで右クリックして 列の概要 を選びます。エディタに FROM <name>; が入り、実行されてこのタブが開きます。右クリックメニュー を参照してください。
Explain と Profile の出力
エディタツールバーの Explain と 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) があり、単独で最も時間を費やした演算子を示し、その演算子の行は赤で描かれます。
