コンテンツへスキップ

最初の 10 分 ​

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

1. サンプルファイルを取得する ​

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

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

5 つの列があります:

列型例
dateDATE2026-09-01
channelVARCHARWeb, Mobile app, Store, Phone
regionVARCHARNorth, South, East, West
ordersBIGINT72
revenueDOUBLE4181.04

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

2. 開く ​

sales.csv を DuckLocal のウィンドウにドラッグします(または ファイルを開く… を クリックするか、コマンドを追加していれば 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;
channelrevenue
Mobile app290549.76
Web289544.8
Store240067.6
Phone82511.2

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

自動補完

入力中、エディターはまずサイドバーのテーブル名と列名を候補にし、そのあと 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 つの系列になります。結果とグラフにルールと制限が まとまっています。

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 ガイドと、 公式のエージェントスキル(AI コーディングアシスタントから呼び出せるスキル パッケージ)から読み始めるとよいでしょう。

次へ ​

Apache-2.0 ライセンスで公開されています。