---
title: DuckLocal — 手元のファイルを SQL で扱う DuckDB デスクトップアプリ
description: CSV、Parquet、JSON、Excel ファイルを DuckDB SQL でローカルにクエリ。サーバーもアップロードもアカウントもテレメトリーも不要です。
image: https://ducklocal.app/og-image.jpg?v=2
language: ja
---

# DuckLocal

CSV、Parquet、JSON、Excel ファイルを、お使いのパソコン上のその場所のまま DuckDB でクエリできます。サーバーもアップロードもアカウントも不要です。

DuckLocal は Mac、Windows、Linux 向けの無料のオープンソースデスクトップアプリで、Apache-2.0 でライセンスされています。

## エージェントはターミナルに、データは DuckLocal に

エージェントが `.dash` ファイルを書きます。DuckLocal で確認し、グラフの上でそのままコメントできます。

- `ducklocal schema` はすべてのファイル、テーブル、列を一覧します。`--stats` を付けると列ごとの正確な統計も出ます。
- `ducklocal query` は SQL 文を 1 つ受け取り、上限付きの JSON を返します。結果が打ち切られた場合はその旨が示されます。
- `ducklocal open` はクエリやダッシュボードを開いているウィンドウに送ります。`--state` で表示中の内容を読み戻せます。
- `ducklocal check` は `.dash` ファイルを表示前に検証します。ダッシュボードはコードのように差分を取りコミットできます。
- `ducklocal comments` では、コメントしたグラフをエージェントが編集し、返信してスレッドを解決できます。
- `ducklocal presence` は、どのグラフをエージェントが読んでいるか、編集しているかをウィンドウに表示します。

```bash
ducklocal schema ./data/
ducklocal query --sql "SELECT count(*) FROM 'sales.csv'"
```

エージェントとの接続は 3 つの手順です:

1. DuckLocal で **コマンドラインと AI…** を開き、**コマンドをインストール** をクリックして `ducklocal` を PATH に入れます。
2. **Claude Code に追加** をクリックして公式スキルをインストールします。Codex や Cursor では **説明をコピー** をクリックして貼り付けてください。
3. ターミナルでエージェントにタスクを渡し、結果を DuckLocal で確認してコメントします。

ホームページのデモは、チュートリアルの 224 行の `sales.csv` サンプルから計算されています。ウェブサイトは AI リクエストを送信せず、コメントを投稿してもエージェントが自動で起動することはありません。

[AI エージェントのための SQL](https://ducklocal.app/ja/use-cases/ai-agent-sql/)、[CLI リファレンス](https://ducklocal.app/docs/ja/cli)、[ダッシュボードガイド](https://ducklocal.app/docs/ja/dashboards) をお読みください。

## ファイルから答えまで

1. **ファイルをドロップ。** CSV、表計算ファイル、フォルダごとドラッグするだけ。インポートの手順はありません。
2. **そのままテーブルになります。** `sales.csv` はテーブル `sales` になり、列はサイドバーに並びます。ファイルがコピーされたり変更されたりすることはありません。
3. **SQL で聞く。** ⌘↵ で答えが出ます。グラフにするか、CSV や Parquet として保存できます。

```sql
SELECT channel, round(sum(revenue), 2) AS revenue
FROM sales
GROUP BY channel
ORDER BY revenue DESC;
```

DuckLocal は CSV、TSV、Parquet、JSON、NDJSON、Excel と OpenDocument の表計算ファイル、DuckDB データベース、フォルダ全体、S3 ストレージを、すべてその場所のまま開きます。

## 最初の答えのあとに

- クエリをプロファイルして、どのステップに時間がかかったかを見られます。
- 結果の各列について、NULL、重複を除いた値、範囲を確認できます。
- DuckDB や SQLite のデータベースをさらにアタッチし、拡張機能はサイドバーで管理できます。
- Mac では Finder から Parquet や DuckDB ファイルを開いたり、Quick Look でプレビューしたりできます。

## データはあなたのものです

- ファイルはその場所で読まれ、コピーもアップロードもされません。
- アカウントもテレメトリーもクラウドサービスもありません。
- 自分でオンにしない限り、何も外部に送信されません。
- Apache-2.0 のオープンソースなので、すべての行を読むことができます。

## よくある質問

### DuckLocal とは何ですか？

パソコン上のデータファイルを SQL でクエリするための、無料のオープンソースデスクトップアプリです。DuckDB がアプリ内で動くので、ドロップしたファイルはそのままクエリできるテーブルになります。

### DuckLocal はデータをアップロードしますか？

いいえ。ファイルはその場所で読まれ、コピー、アップロード、変更は行われません。アカウントもテレメトリーもありません。

### どのファイル形式を開けますか？

CSV、TSV、Parquet、JSON、NDJSON、Excel と OpenDocument の表計算ファイル、DuckDB データベース、フォルダ全体、Amazon S3 または S3 互換ストレージのファイルです。

### どのシステムで動きますか？

Apple シリコンの macOS 12 以降、64 ビットの Windows 10 以降、glibc 2.35 以降の x86_64 Linux です。

### データはどれくらい大きくても大丈夫ですか？

DuckDB はファイルをアプリに読み込まずに直接クエリします。結果グリッドには最大 100,000 行が表示され、エクスポートでは結果全体が書き出されます。

### Claude Code や Codex のような AI エージェントから使えますか？

はい。ducklocal コマンドはターミナルから SQL を実行して JSON を出力します。公式スキルは、クエリの前にスキーマを確認するようエージェントに教えます。

## リンク

- [DuckLocal をダウンロード](https://github.com/JetSquirrel/DuckLocal/releases/latest)
- [はじめに](https://ducklocal.app/docs/ja/getting-started)
- [10 分チュートリアル](https://ducklocal.app/docs/ja/tutorial)
- [ローカルデータ分析](https://ducklocal.app/ja/use-cases/local-data-analysis/)
- [DuckDB GUI](https://ducklocal.app/ja/use-cases/duckdb-gui/)
- [Parquet ビューア](https://ducklocal.app/ja/use-cases/parquet-viewer/)
- [SQL で CSV をクエリ](https://ducklocal.app/ja/use-cases/query-csv-with-sql/)
- [SQL で Excel をクエリ](https://ducklocal.app/ja/use-cases/query-excel-with-sql/)
- [SQL で JSON をクエリ](https://ducklocal.app/ja/use-cases/query-json-with-sql/)
- [SQL ダッシュボード](https://ducklocal.app/ja/use-cases/sql-dashboards/)
- [DuckLocal と DBeaver](https://ducklocal.app/ja/compare/ducklocal-vs-dbeaver/)
- [ブログ](https://ducklocal.app/ja/blog/)
- [ドキュメント](https://ducklocal.app/docs/ja/)
- [ソースコード](https://github.com/JetSquirrel/DuckLocal)
- [English](https://ducklocal.app/)
- [中文](https://ducklocal.app/zh/)

Source: https://ducklocal.app/ja/
