Excel ファイルを SQL でクエリ

DuckLocal でブックを開くと、シートがそれぞれテーブルになります。シート同士、CSV や Parquet ファイル、DuckDB データベースと結合して、ピボットテーブルでは出せない答えを得られます。Excel のインストールもデータベースサーバーも不要で、何もアップロードされません。

macOS、Windows、Linux 向けの無料オープンソース。ブックは読み取るだけで、変更されることはありません。

ブックから答えまで

ファイルをドラッグするか、メニューから開くだけです。クリックし続けるインポートウィザードはありません。

  1. ブックを開く

    最初のシートはファイル名のテーブルになります。budget.xlsx なら budget です。ほかのシートは {file}_{sheet} という名前になり、たとえば budget_actuals です。空のシートはスキップされます。

  2. シートに SQL を書く

    スキーマサイドバーに各シートの列と推定された型が表示され、補完にも使われます。JOIN、ウィンドウ関数、PIVOT など DuckDB SQL のすべてが使えます。

  3. 結果を残す

    グラフにする、各列の分布を見る、または結果全体を CSV(スプレッドシート向け)や Parquet(ほかのツール向け)に書き出せます。

シート、ブック、ファイルを結合

シートをまたぐ参照に VLOOKUP の数式を並べる代わりに、SQL なら JOIN ひとつです。2 つのブックの間でも、シートとほかのシステムから書き出した CSV の間でも同じです。

SQL エディタ · SQL で CSV をクエリ

-- budget.xlsx: first sheet → budget,
-- sheet "actuals" → budget_actuals
SELECT b.department,
       b.planned,
       sum(a.amount)             AS spent,
       b.planned - sum(a.amount) AS remaining
FROM budget b
JOIN budget_actuals a USING (department)
GROUP BY b.department, b.planned
ORDER BY remaining;

シートがテーブルになるしくみ

1 行目がヘッダーです。各列には、その列のすべてのセルを表せるもっとも狭い型が付きます。整数は BIGINT、整数と小数の混在は DOUBLE、日付は TIMESTAMP、真偽値は BOOLEAN です。それ以外が混在する列は VARCHAR のまま残るので何も失われず、SQL で TRY_CAST できます。

ブックの読み込みの詳細

  • 空のセルは NULL に
  • 空のヘッダーセルは column_1、column_2… に
  • 重複したヘッダーには接尾辞:amount、amount_2
  • 数式は計算結果の値として取り込み
  • ブックファイルには一切書き込まない

残しておけるコピー

その場で読み込まれる CSV や Parquet と違い、シートはブックを開いたときにテーブルへコピーされます。Excel でファイルを変更したら、もう一度開くとテーブルが置き換わります。

テーブルを残しておくには、先に .duckdb データベースを開いてからブックを開きます。シートはそのデータベースに保存され、次に開いたときもそのまま使え、どの DuckDB クライアントからも読めます。

コマンドラインでブックを扱う

ducklocal schema はブックとそのシートを一覧表示し、--stats は最初のシートを分析します。列ごとの NULL、異なる値の数、範囲、中央値がわかります。AI エージェントは SQL を書く前に、スプレッドシートの中身を把握できます。

スクリプトやエージェントからシートをクエリするには、上の方法でアプリからデータベースに保存し、そのファイルに対して ducklocal query --database を実行します。

CLI ガイドを読む · AI エージェントのための SQL

Terminal
$ ducklocal schema budget.xlsx
$ ducklocal schema budget.xlsx --stats
$ ducklocal query --database budget.duckdb \
  --sql "SELECT department, sum(amount)
         FROM budget_actuals
         GROUP BY department"

Excel と SQL についての質問

DuckLocal はどのスプレッドシート形式をクエリできますか?
Excel の .xlsx、.xls、.xlsb ブックと、OpenDocument の .ods スプレッドシートです。空でないシートはそれぞれ独立したテーブルとして取り込まれます。
DuckLocal はブックを変更しますか?
いいえ。ファイルを読み取り、各シートをテーブルにコピーするだけで、ブック自体には書き込みません。あとで Excel で編集した場合は、もう一度開けば変更が反映されます。
数式は取り込まれますか?
取り込まれるのは値です。DuckLocal はスプレッドシートアプリがファイルに保存した計算結果を読み、背後の数式は読みません。合計の列は数値として入ります。
結果をスプレッドシートに書き戻せますか?
どの結果も CSV(Excel をはじめどのスプレッドシートアプリでも開けます)か、ほかのデータツール向けの Parquet に書き出せます。DuckLocal は .xlsx ファイルを書き出しません。
DuckLocal は Excel の代わりになりますか?
分析なら、なります。シートやファイルをまたぐ結合、集計、そしてワークシートの 1,048,576 行の上限を超えるデータを扱えます。ただしスプレッドシートエディタではないので、セルに入力したり数式を書いたりはしません。

自分のブックに SQL を実行しよう

DuckLocal をダウンロードして、スプレッドシートをドロップし、1 つのクエリでシートを結合しましょう。