ブックから答えまで
ファイルをドラッグするか、メニューから開くだけです。クリックし続けるインポートウィザードはありません。
ブックを開く
最初のシートはファイル名のテーブルになります。
budget.xlsxならbudgetです。ほかのシートは{file}_{sheet}という名前になり、たとえばbudget_actualsです。空のシートはスキップされます。シートに SQL を書く
スキーマサイドバーに各シートの列と推定された型が表示され、補完にも使われます。JOIN、ウィンドウ関数、
PIVOTなど DuckDB SQL のすべてが使えます。結果を残す
グラフにする、各列の分布を見る、または結果全体を CSV(スプレッドシート向け)や Parquet(ほかのツール向け)に書き出せます。
シート、ブック、ファイルを結合
シートをまたぐ参照に VLOOKUP の数式を並べる代わりに、SQL なら JOIN ひとつです。2 つのブックの間でも、シートとほかのシステムから書き出した 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 を実行します。
$ 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 で CSV をクエリ · SQL で JSON をクエリ · ローカルデータ分析 · DuckDB GUI
自分のブックに SQL を実行しよう
DuckLocal をダウンロードして、スプレッドシートをドロップし、1 つのクエリでシートを結合しましょう。