---
title: クイックスタート
description: Queria CLI でデータセットを探し、SQL を実行し、結果をファイルに保存する
---

データセットを探してから、SQL の結果をファイルに保存するまでの流れです。次のコマンドは、`queria` の代わりに `uvx queria` と書いても同じように動きます。

## 1. データセットを探す

```bash
queria list
queria search 人口
```

## 2. テーブルと列を確認する

```bash
queria schema e_stat
queria columns e_stat a_pref_population
```

## 3. SQL を実行する

テーブルは `<dataset>.<schema>.<table>` と書きます。SQL に書いたデータセットは CLI が自動で ATTACH します。

```bash
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. 結果をファイルに保存する

```bash
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 ガイド](/cli): コマンドとオプション
- [AI エージェントで分析する](/agent-analysis): Claude Code などから CLI を使う
- [Python API](/reference/python-api): ノートブックやスクリプトから使う
