---
title: シェルパイプラインに組み込む
description: Queria CLI の出力を jq に渡し、cron や CI から定期的にデータを取得する
---

Queria CLI は標準出力の形式を `--format` で選べるので、出力をパイプでほかのコマンドに渡せます。cron や CI から実行して、データの取得を自動にすることもできます。

## jq と組み合わせる

`--format jsonl` は 1 行に 1 レコードの JSON を出すので、jq で 1 行ずつ処理できます。

```bash
queria sql "
  SELECT DISTINCT area_name, value AS population
  FROM e_stat.ssds.a_pref_population
  WHERE item_name = 'A1101_総人口' AND year = 2024
" --format jsonl | jq -r 'select(.population > 5000000) | .area_name'
```

全部の行を 1 つの配列で受け取るときは `--format json` を使います。

```bash
queria list --format json | jq '.[].datasource'
```

## Markdown をドキュメントに貼る

`--format markdown` の出力は Markdown の表なので、README や記事、PR の説明に貼れます。

```bash
queria sql "..." --format markdown >> report.md
```

## cron で定期的に保存する

ファイル名に日付を入れて `--out` で保存すると、実行するたびにその日の結果がファイルとして残ります。

```bash
#!/usr/bin/env bash
set -euo pipefail
queria sql "
  SELECT area_name, value AS population
  FROM e_stat.ssds.a_pref_population
  WHERE item_name = 'A1101_総人口' AND year = 2024
" --out "snapshots/pop_$(date +%F).parquet"
```

```text
0 6 * * 1 /home/you/bin/weekly-snapshot.sh
```

:::note
cron から実行するときは、PATH にほとんど何も入っていません。`uv tool install queria` で入れた `queria` をフルパスで書くか、スクリプトの最初で PATH を設定してください。
:::

## CI から使う

API トークンは環境変数 `QUERIA_TOKEN` で渡します（`--token` を付けるとそちらを使います）。トークンなしで読むと[レートリミット](/limits)に当たることがあるので、定期的に実行するときはトークンを設定してください。GitHub Actions では次のように書きます。

```yaml
env:
  QUERIA_TOKEN: ${{ secrets.QUERIA_TOKEN }}
```

トークンの発行と管理は[認証](/authentication)を見てください。

## 注意すること

- 大きな結果は標準出力に出さず、`--out` でファイルに保存してください（形式は拡張子で決まります）
- 手元のファイルとの突き合わせは「[手元のデータと突き合わせる](/recipes/local-data)」を見てください
