jqコマンドでJSONを解析・加工する方法｜フィルタ・整形・抽出の実践例も

この記事のポイント

・jq . でJSONを整形して人間が読みやすい形に変換できる
・.フィールド名でネストしたキーも簡単に抽出できる
・.[index]や.[]で配列要素の取り出しや展開ができる
・select()で条件フィルタリングし、必要なデータだけ抽出できる

# RHEL 9 / Rocky Linux 9 / AlmaLinux 9
$ sudo dnf install -y jq

# バージョン確認
$ jq --version
jq-1.6

# Ubuntu 24.04 / Debian 12
$ sudo apt install -y jq

# バージョン確認
$ jq --version
jq-1.7.1

# 圧縮されたJSONを整形して表示する
$ echo '{"name":"web01","status":"running","cpu":45}' | jq .
{
  "name": "web01",
  "status": "running",
  "cpu": 45
}

# APIレスポンスを整形して表示する例
$ curl -s https://api.example.com/status | jq .

# name フィールドだけを取り出す
$ echo '{"name":"web01","status":"running","cpu":45}' | jq .name
"web01"

# ダブルクォートなしで文字列を出力したい場合は -r オプションを使う
$ echo '{"name":"web01","status":"running","cpu":45}' | jq -r .name
web01

# ネストしたJSONの例
$ cat server.json
{
  "name": "web01",
  "network": {
    "ip": "192.168.10.101",
    "port": 443
  }
}

# ネストした network.ip を取り出す
$ jq -r .network.ip server.json
192.168.10.101

# サーバーリストの配列を展開する
$ cat servers.json
[
  {"name":"web01","status":"running"},
  {"name":"web02","status":"stopped"},
  {"name":"db01","status":"running"}
]

# 配列の全要素を展開して表示する
$ jq .[] servers.json
{
  "name": "web01",
  "status": "running"
}
{
  "name": "web02",
  "status": "stopped"
}
{
  "name": "db01",
  "status": "running"
}

# 0番目（先頭）の要素を取り出す
$ jq '.[0]' servers.json
{
  "name": "web01",
  "status": "running"
}

# 最後の要素を取り出す
$ jq '.[-1]' servers.json
{
  "name": "db01",
  "status": "running"
}

# 全サーバーの name フィールドだけを取り出す
$ jq -r '.[].name' servers.json
web01
web02
db01

# name と status を組み合わせて表示する
$ jq -r '.[] | "\(.name): \(.status)"' servers.json
web01: running
web02: stopped
db01: running

# status が "running" のサーバーだけを取り出す
$ jq '.[] | select(.status == "running")' servers.json
{
  "name": "web01",
  "status": "running"
}
{
  "name": "db01",
  "status": "running"
}

# status が "running" のサーバーの name だけを取り出す
$ jq -r '.[] | select(.status == "running") | .name' servers.json
web01
db01

# name と status だけを含む新しいJSONを作る
$ jq '.[] | {server: .name, state: .status}' servers.json
{
  "server": "web01",
  "state": "running"
}
{
  "server": "web02",
  "state": "stopped"
}
{
  "server": "db01",
  "state": "running"
}

# 配列の要素数を表示する
$ jq 'length' servers.json
3

# running のサーバー数を数える
$ jq '[.[] | select(.status == "running")] | length' servers.json
2

#!/bin/bash
# APIからサーバー名を取得してシェル変数に格納する例
RESPONSE='{"name":"web01","status":"running","cpu":45}'
SERVER_NAME=$(echo "$RESPONSE" | jq -r .name)
CPU_USAGE=$(echo "$RESPONSE" | jq -r .cpu)

echo "サーバー名: $SERVER_NAME"
echo "CPU使用率: $CPU_USAGE%"

# 出力例
# サーバー名: web01
# CPU使用率: 45%

#!/bin/bash
# シェル変数を使ってJSONを生成する
HOSTNAME="web01"
STATUS="running"

JSON=$(jq -n --arg name "$HOSTNAME" --arg status "$STATUS" \
  '{name: $name, status: $status}')

echo "$JSON"
# 出力例
# {
#   "name": "web01",
#   "status": "running"
# }

# エラーになる例（キーにクォートがない）
$ echo '{name: "web01"}' | jq .
parse error (Invalid numeric literal at EOF at line 1, column 14)

# 正しい例（キーもダブルクォートで囲む）
$ echo '{"name": "web01"}' | jq .
{
  "name": "web01"
}

# フィールド名のスペルが違う場合は null が返る
$ echo '{"name":"web01"}' | jq .hostname
null

# まずは . で全体を確認してキー名を特定する
$ echo '{"name":"web01"}' | jq .
{
  "name": "web01"
}

# エラーになる例（配列にフィールド名でアクセス）
$ echo '[{"name":"web01"}]' | jq .name
null

# 正しい例（配列を展開してからフィールドにアクセス）
$ echo '[{"name":"web01"}]' | jq '.[0].name'
"web01"

# または配列展開を使う
$ echo '[{"name":"web01"}]' | jq -r '.[].name'
web01