クイックスタート
Queria CLI でデータセットを探し、SQL を実行し、結果をファイルに保存する
データセットを探してから、SQL の結果をファイルに保存するまでの流れです。次のコマンドは、queria の代わりに uvx queria と書いても同じように動きます。
1. データセットを探す
queria list
queria search 人口
2. テーブルと列を確認する
queria schema e_stat
queria columns e_stat a_pref_population
3. SQL を実行する
テーブルは <dataset>.<schema>.<table> と書きます。SQL に書いたデータセットは CLI が自動で ATTACH します。
queria sql "
SELECT date, holiday_name
FROM calendar.calendar.day
WHERE is_holiday AND date BETWEEN DATE '2026-01-01' AND DATE '2026-12-31'
ORDER BY date
"
SQL は DuckDB で実行するので、DuckDB の SQL がそのまま使えます。データセットをまたぐ JOIN も書けます。
4. 結果をファイルに保存する
queria sql "SELECT * FROM zipcode.main.mart_zipcode" --out zipcodes.parquet
queria sql "SELECT * FROM zipcode.main.mart_zipcode" --out zipcodes.csv
標準出力の形式は --format table|csv|json|jsonl|markdown で選べます(デフォルトは table)。
次に読むページ
- CLI ガイド: コマンドとオプション
- AI エージェントで分析する: Claude Code などから CLI を使う
- Python API: ノートブックやスクリプトから使う
