# 最初の 10 分

> サンプル CSV を使った 10 分間の DuckLocal チュートリアル。SQL でクエリし、結果をグラフにして、エクスポートし、同じ問い合わせを CLI から実行します。

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

ガイドツアーです。小さな売上ファイルを開き、いくつかのクエリを実行し、答えをグラフにして、結果をエクスポートします。DuckLocal がインストールされていることを前提としています。まだの場合は[はじめに](getting-started.md)から始めてください。

## 1. サンプルファイルを取得する {#sample-file}

2 週間分の模擬注文データを 224 行にまとめた [sales.csv](https://ducklocal.app/docs/samples/sales.csv) をダウンロードしてください。ターミナルからダウンロードすることもできます:

```bash
curl -LO https://ducklocal.app/docs/samples/sales.csv
```

5 つの列があります:

| 列 | 型 | 例 |
| --- | --- | --- |
| `date` | DATE | `2026-09-01` |
| `channel` | VARCHAR | `Web`, `Mobile app`, `Store`, `Phone` |
| `region` | VARCHAR | `North`, `South`, `East`, `West` |
| `orders` | BIGINT | `72` |
| `revenue` | DOUBLE | `4181.04` |

これらの情報を DuckLocal に伝える必要はありません。DuckDB がヘッダーを読み取り、
型を自分で推測します。

## 2. 開く

`sales.csv` を DuckLocal のウィンドウにドラッグします（または **ファイルを開く…** を
クリックするか、[コマンドを追加](getting-started.md#add-command)していれば
`ducklocal sales.csv` を実行します）。

通知に **ビュー sales を作成しました。** と表示されます。サイドバーの
**ローカルファイル** に `sales` が 224 行として並ぶので、展開すると列とその型を
確認できます。

## 3. 行を確認する

サイドバーで `sales` の横の再生ボタンをクリックします。エディターに
`SELECT * … LIMIT 100` が入力されるので、**⌘↵** を押して実行します。

エディターの下のグリッドに行が表示されます。上のフィルターボックスも試してみてください。
`Store` と入力して Enter を押すと、それが含まれる行だけが残ります。フィルターは
すでに読み込まれた行に対して動作し、クエリを再実行することはありません。

## 4. 質問する

SQL を次に置き換えて **⌘↵** を押します:

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

| channel | revenue |
| --- | --- |
| Mobile app | 290549.76 |
| Web | 289544.8 |
| Store | 240067.6 |
| Phone | 82511.2 |

結果パネルを **結果** から **グラフ** に切り替えます。最初の列がテキストなので、
チャネルごとに棒グラフが表示され、大きさは最初の数値列で決まります。

::: tip 自動補完
入力中、エディターはまずサイドバーのテーブル名と列名を候補にし、そのあと DuckDB の
関数と SQL キーワードを提示します。`rev` と入力すると、最初の候補が `revenue` です。
:::

## 5. 推移をグラフにする

グラフはクエリが返す行をそのまま使って描画されるので、プロットしたい形に結果を
整えてください。チャネルごとに 1 列あれば、チャネルごとに 1 本の折れ線になります:

```sql
SELECT
  date,
  round(sum(revenue) FILTER (WHERE channel = 'Web'), 2)        AS web,
  round(sum(revenue) FILTER (WHERE channel = 'Mobile app'), 2) AS mobile,
  round(sum(revenue) FILTER (WHERE channel = 'Store'), 2)      AS store
FROM sales
GROUP BY date
ORDER BY date;
```

`FILTER (WHERE …)` は一致する行だけを集計します（DuckDB の構文）。

最初の列が日付の場合、**グラフ** は時系列のエリアチャートを描き、数値列ごとに
1 つの系列になります。[結果とグラフ](results-and-charts.md)にルールと制限が
まとまっています。

## 6. 答えをエクスポートする

**エクスポートは既存のファイルを確認なしで上書きします。** 推移を結果パネルに
表示したまま、**CSV にエクスポート** をクリックします。ダイアログは
`~/Desktop/export.csv` を提案します。必要ならパスを変更して確定してください。

エクスポートはクエリを再実行するので、ファイルにはグリッドに見えている部分だけでなく
結果全体が入ります。

## 7. 翌日にもう一度見つける

サイドバーの **履歴** タブを開いてください。実行したクエリは失敗したものも含めて
すべて残っています。項目をクリックすると、エディターの内容がそのクエリに置き換わります。

DuckLocal を終了してもう一度起動してください。`sales` は **ローカルファイル** に
残っています。開いたファイルはパスで記憶され、起動のたびに読み直されるので、
CSV を編集すれば次にクエリしたときに反映されます。

## 8. おまけ: 同じ質問をターミナルから

`ducklocal` コマンドを追加していれば、CLI はウィンドウを開かずに答えます。
スクリプトや AI エージェントに便利です:

```bash
ducklocal query --format md --sql "
  SELECT channel, round(sum(revenue), 2) AS revenue
  FROM 'sales.csv' GROUP BY channel ORDER BY revenue DESC"
```

`--format md` を省くと構造化 JSON になります。まずは [CLI ガイド](cli.md)と、
公式のエージェントスキル（AI コーディングアシスタントから呼び出せるスキル
パッケージ）から読み始めるとよいでしょう。

## 次へ

- 実際のデータで試す: HTTPS 経由で 350 万件のタクシー乗車データをクエリ — [例: NYC タクシーの乗車データ](example-nyc-taxi.md)
- 自分のファイルやフォルダーを DuckLocal に向ける — [データソース](data-sources.md)
- S3 互換ストレージのファイルをクエリする — [S3 と httpfs](s3.md)
- 保存したクエリでダッシュボードを作る — [ダッシュボード（.dash）](dashboards.md)
