コンテンツへスキップ

結果とグラフ ​

エディタの下のパネルには 結果、グラフ、概要 の 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 の型
NULLNULL である行の割合(小さなバー付き)。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) があり、単独で最も時間を費やした演算子を示し、その演算子の行は赤で描かれます。

Apache-2.0 ライセンスで公開されています。