---
title: CSV ファイルを SQL でクエリ、データベースの準備は不要 | DuckLocal
description: "CSV ファイルをデータベースにインポートせずに SQL を実行できます。DuckLocal は DuckDB で CSV をその場で読み取り、結合、集計、グラフ作成、Parquet へのエクスポートまで行えます。無料でローカルに動作します。"
image: https://ducklocal.app/og-image.jpg
language: ja
---

# CSV ファイルを SQL でクエリ

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

## 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 エディター](https://ducklocal.app/docs/ja/sql-editor) · [結果とグラフ](https://ducklocal.app/docs/ja/results-and-charts)

```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 ファイルを一度に読む](https://ducklocal.app/docs/ja/data-sources)

```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.gz`: gzip 圧縮したファイルもデータとして開ける
- `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 エージェントから使えます。

**AI エージェントと一緒に作業していますか？** 出力が範囲内の JSON に収まるヘッドレス CLI なら、エージェントはまずスキーマを確認し、そのあとでクエリを実行できます。 [AI エージェント向けの SQL を見る](https://ducklocal.app/ja/use-cases/ai-agent-sql/)

## 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 をエクスポート」を選びます。エクスポートはクエリを再実行し、すべての行を書き出します。

## リンク

- [DuckLocal をダウンロード](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [10 分チュートリアルを試す](https://ducklocal.app/docs/ja/tutorial)
- [チュートリアルを開く](https://ducklocal.app/docs/ja/tutorial)
- [ローカルデータ分析](https://ducklocal.app/ja/use-cases/local-data-analysis/)
- [Parquet ビューアー](https://ducklocal.app/ja/use-cases/parquet-viewer/)
- [DuckDB GUI](https://ducklocal.app/ja/use-cases/duckdb-gui/)

Source: https://ducklocal.app/ja/use-cases/query-csv-with-sql/
