接続方法

Queriaのデータセットは DuckLake カタログとして公開されています。DuckDB v1.3以降がインストールされていれば、ブラウザ以外のツールからもデータにアクセスできます。

DuckDB CLIからの接続

DuckDB CLIを起動し、以下の3ステップで接続します。

-- 1. DuckLake拡張をインストール
INSTALL ducklake;
LOAD ducklake;

-- 2. カタログに接続（つくば市オープンデータの例）
ATTACH 'ducklake:https://data.queria.io/tsukuba/ducklake.duckdb' AS tsukuba (READ_ONLY);

-- 3. クエリを実行
SELECT * FROM tsukuba.main.mart_tsukuba_population LIMIT 10;

複数のデータセットを同時に接続することもできます。

ATTACH 'ducklake:https://data.queria.io/k_oxon/ducklake.duckdb' AS k_oxon (READ_ONLY);
ATTACH 'ducklake:https://data.queria.io/zipcode/ducklake.duckdb' AS zipcode (READ_ONLY);

Claude Codeからの接続

Claude Codeのbashツールで、DuckDB CLIコマンドをそのまま実行できます。接続後の具体的な分析の流れは「Claude Code で分析する」で紹介しています。

duckdb -c "
INSTALL ducklake;
LOAD ducklake;
ATTACH 'ducklake:https://data.queria.io/tsukuba/ducklake.duckdb' AS tsukuba (READ_ONLY);
SELECT area_name, year, month, total
FROM tsukuba.main.mart_tsukuba_population
WHERE area_name = 'つくば市'
ORDER BY year DESC, month DESC
LIMIT 5;
"

Pythonからの接続

duckdb パッケージを使った接続例です。

import duckdb

conn = duckdb.connect()
conn.execute("INSTALL ducklake; LOAD ducklake;")
conn.execute("""
    ATTACH 'ducklake:https://data.queria.io/tsukuba/ducklake.duckdb'
    AS tsukuba (READ_ONLY)
""")

df = conn.execute("""
    SELECT area_name, year, month, total
    FROM tsukuba.main.mart_tsukuba_population
    LIMIT 10
""").fetchdf()
print(df)

利用可能なデータセット

すべてのデータセットは共通のベースURL https://data.queria.io の下に配置されています。

alias	内容	パス
tsukuba	つくば市オープンデータ	/tsukuba/ducklake.duckdb
k_oxon	K-Oxon データ	/k_oxon/ducklake.duckdb
zipcode	郵便番号データ	/zipcode/ducklake.duckdb

接続時はベースURLとパスを結合して指定します。

ATTACH 'ducklake:https://data.queria.io/tsukuba/ducklake.duckdb' AS tsukuba (READ_ONLY);

各データセットに含まれるテーブルは、データセット一覧から確認できます。