CSV ファイルから結果まで
ファイルはその場所に置いたままです。DuckLocal がその場で読み取ります。
ファイルをドロップする
sales.csvはsalesというビューになります。タブ区切りの.tsvファイル、.txtファイル、gzip 圧縮した.csv.gzファイルも同じように扱えます。SQL を書く
スキーマのサイドバーに列と推論された型が表示され、自動補完もそれらを認識します。DuckDB の SQL 方言をまるごと使え、結合、ウィンドウ関数、CTE、
PIVOTがそのまま動きます。答えを残す
結果をグラフにする、列ごとの分布を見る、あるいは結果全体を CSV や Parquet にエクスポートできます。
CSV ファイルをテーブルのように結合する
orders.csv と customers.csv を一緒に開くと、それぞれが独立したビューになります。1 つの文で結合することも、CSV を Parquet ファイル、Excel シート、DuckDB データベースのテーブルと結合することもできます。
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 でキャストします。
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 をエクスポート」を選びます。エクスポートはクエリを再実行し、すべての行を書き出します。
関連ページ: ローカルデータ分析 · Parquet ビューアー · DuckDB GUI · SQL で Excel をクエリ · SQL で JSON をクエリ
自分の CSV で SQL を実行する
DuckLocal をダウンロードし、サンプルの CSV でチュートリアルを進めてください。ファイルからグラフまで、およそ 10 分です。