最初の 10 分
ガイドツアーです。小さな売上ファイルを開き、いくつかのクエリを実行し、答えをグラフにして、結果をエクスポートします。DuckLocal がインストールされていることを前提としています。まだの場合ははじめにから始めてください。
1. サンプルファイルを取得する
2 週間分の模擬注文データを 224 行にまとめた sales.csv をダウンロードしてください。ターミナルからダウンロードすることもできます:
curl -LO https://ducklocal.app/docs/samples/sales.csv5 つの列があります:
| 列 | 型 | 例 |
|---|---|---|
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 のウィンドウにドラッグします(または ファイルを開く… を クリックするか、コマンドを追加していれば ducklocal sales.csv を実行します)。
通知に ビュー sales を作成しました。 と表示されます。サイドバーの ローカルファイル に sales が 224 行として並ぶので、展開すると列とその型を 確認できます。
3. 行を確認する
サイドバーで sales の横の再生ボタンをクリックします。エディターに SELECT * … LIMIT 100 が入力されるので、⌘↵ を押して実行します。
エディターの下のグリッドに行が表示されます。上のフィルターボックスも試してみてください。 Store と入力して Enter を押すと、それが含まれる行だけが残ります。フィルターは すでに読み込まれた行に対して動作し、クエリを再実行することはありません。
4. 質問する
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 |
結果パネルを 結果 から グラフ に切り替えます。最初の列がテキストなので、 チャネルごとに棒グラフが表示され、大きさは最初の数値列で決まります。
自動補完
入力中、エディターはまずサイドバーのテーブル名と列名を候補にし、そのあと DuckDB の 関数と SQL キーワードを提示します。rev と入力すると、最初の候補が revenue です。
5. 推移をグラフにする
グラフはクエリが返す行をそのまま使って描画されるので、プロットしたい形に結果を 整えてください。チャネルごとに 1 列あれば、チャネルごとに 1 本の折れ線になります:
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 つの系列になります。結果とグラフにルールと制限が まとまっています。
6. 答えをエクスポートする
エクスポートは既存のファイルを確認なしで上書きします。 推移を結果パネルに 表示したまま、CSV にエクスポート をクリックします。ダイアログは ~/Desktop/export.csv を提案します。必要ならパスを変更して確定してください。
エクスポートはクエリを再実行するので、ファイルにはグリッドに見えている部分だけでなく 結果全体が入ります。
7. 翌日にもう一度見つける
サイドバーの 履歴 タブを開いてください。実行したクエリは失敗したものも含めて すべて残っています。項目をクリックすると、エディターの内容がそのクエリに置き換わります。
DuckLocal を終了してもう一度起動してください。sales は ローカルファイル に 残っています。開いたファイルはパスで記憶され、起動のたびに読み直されるので、 CSV を編集すれば次にクエリしたときに反映されます。
8. おまけ: 同じ質問をターミナルから
ducklocal コマンドを追加していれば、CLI はウィンドウを開かずに答えます。 スクリプトや AI エージェントに便利です:
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 ガイドと、 公式のエージェントスキル(AI コーディングアシスタントから呼び出せるスキル パッケージ)から読み始めるとよいでしょう。
次へ
- 実際のデータで試す: HTTPS 経由で 350 万件のタクシー乗車データをクエリ — 例: NYC タクシーの乗車データ
- 自分のファイルやフォルダーを DuckLocal に向ける — データソース
- S3 互換ストレージのファイルをクエリする — S3 と httpfs
- 保存したクエリでダッシュボードを作る — ダッシュボード(.dash)
