CSV ファイルを SQL でクエリ

CSV ファイルを DuckLocal にドロップすると、ファイル名のテーブルになります。DuckDB が区切り文字、ヘッダー、列の型を判定するので、SELECT、JOIN、GROUP BY をすぐに実行できます。インポートの手順も CREATE TABLE も不要で、表計算ソフトには大きすぎるファイルも 1 つのクエリで扱えます。

macOS、Windows、Linux に対応した無料のオープンソース。アカウント不要。テレメトリーなし。

CSV ファイルから結果まで

ファイルはその場所に置いたままです。DuckLocal がその場で読み取ります。

  1. ファイルをドロップする

    sales.csv は sales というビューになります。タブ区切りの .tsv ファイル、.txt ファイル、gzip 圧縮した .csv.gz ファイルも同じように扱えます。

  2. SQL を書く

    スキーマのサイドバーに列と推論された型が表示され、自動補完もそれらを認識します。DuckDB の SQL 方言をまるごと使え、結合、ウィンドウ関数、CTE、PIVOT がそのまま動きます。

  3. 答えを残す

    結果をグラフにする、列ごとの分布を見る、あるいは結果全体を CSV や Parquet にエクスポートできます。

CSV ファイルをテーブルのように結合する

orders.csv と customers.csv を一緒に開くと、それぞれが独立したビューになります。1 つの文で結合することも、CSV を Parquet ファイル、Excel シート、DuckDB データベースのテーブルと結合することもできます。

SQL エディター · 結果とグラフ

SELECT c.region,
       count(*) AS orders,
       round(sum(o.amount), 2) AS revenue
FROM orders o
JOIN customers c USING (customer_id)
GROUP BY c.region
ORDER BY revenue DESC;

ファイルが多いとき、整っていないとき

read_csv を使えば、フォルダー内の CSV ファイルをまとめて 1 つのテーブルとして読めます。union_by_name は列が揃っていないファイルも受け付けます。1 つのテキスト値が型判定を壊す場合は、すべてをテキストとして読み、SQL でキャストします。

複数の CSV ファイルを一度に読む

SELECT try_cast(NULLIF(amount, 'NULL') AS DOUBLE) AS amount
FROM read_csv('data/*.csv',
              union_by_name = true,
              all_varchar = true);

クエリのまわりにあるもの

クエリを書く欄は出発点にすぎません。ワークスペースを成り立たせているのは、そのまわりの部分です。

  • .csv .tsv .txt区切り文字、ヘッダー、型は DuckDB が判定
  • .csv.gzgzip 圧縮したファイルもデータとして開ける
  • data/*.csvパターンに一致するファイルをすべて開く
  • folder/フォルダー内のデータファイルをすべて開く
  • 概要列ごとの NULL、個別値の数、範囲、分布
  • グラフ結果から棒グラフ、折れ線グラフ、散布図、円グラフ、地図を描く
  • Parquet をエクスポートCSV のデータを Parquet に変換
  • ducklocal query同じ SQL をターミナルから JSON 出力で実行

CSV はあなたのコンピューターから出ません

オンラインの CSV ツールはアップロードが必要です。DuckLocal は DuckDB を内蔵したデスクトップアプリで、ファイルをパスから読み取り、コピーも変更もせず、アカウントも必要としません。

集計はファイルのすべての行に対して実行されます。グリッドには結果の最大 100,000 行が表示され、エクスポートでは結果全体が書き出されます。

  • アップロードなし、DuckLocal のクラウドサービスもなし
  • インストールするデータベースサーバーなし
  • アカウントなし、テレメトリーなし
  • ソースファイルは変更されない
  • Apache-2.0 のオープンソース

コマンドラインから CSV をクエリする

同じバイナリはウィンドウなしでも動きます。ducklocal query --sql "SELECT count(*) FROM 'sales.csv'" は結果を JSON で出力するので、スクリプトや AI エージェントから使えます。

CSV と SQL の質問

CSV ファイルを先にデータベースへインポートする必要はありますか?
いいえ。DuckLocal はファイルの上にビューを作成し、DuckDB がその場で読み取ります。ファイルがコピー、変換、変更されることはなく、ビューを削除してもファイルはそのまま残ります。
複数の CSV ファイルを 1 つのクエリで結合できますか?
はい。開いたファイルはそれぞれ独立したビューになるので、2 つの CSV の間の JOIN は通常の SQL です。CSV を Parquet、JSON、Excel シート、DuckDB のテーブルと結合することもできます。
DuckLocal はどの SQL 方言を使いますか?
DuckDB SQL です。PostgreSQL に近く、ウィンドウ関数、PIVOT、read_csv によるファイルの直接読み取りといった分析向けの機能が加わっています。
列の型が誤って判定された場合はどうすればよいですか?
DuckDB はファイルのサンプルから型を推論します。列を別の扱いにしたいときは、read_csv(..., all_varchar = true) で読み取り、クエリ内で try_cast を使って変換します。
CSV ファイルを Parquet に変換できますか?
はい。ビューに対して SELECT * FROM を実行し、「Parquet をエクスポート」を選びます。エクスポートはクエリを再実行し、すべての行を書き出します。

自分の CSV で SQL を実行する

DuckLocal をダウンロードし、サンプルの CSV でチュートリアルを進めてください。ファイルからグラフまで、およそ 10 分です。