jq 一个强悍的json格式化查看工具

作者：娄超

在web 2.0时代json这种直观、灵活、高效数据格式基本已经成为一种标准格式，从各种web api，到配置文件，甚至现在连mysql都开始支持json作为数据类型。

但是在平时开发运维中往往因为格式问题或者输出数据太多，体验不是很爽，之前我就经常需要借助一些json自动语法检查、格式化、分层折叠的工具(如http://www.bejson.com/ )， 往往还是需要来回拷贝，还是觉得很麻烦。

所以，一直希望有个linux命令行的简单命令(python的json.tool模块只能格式化显示)，偶然发现了这个jq的小工具，感觉很强大,就分享一下。

不说废话了，直接例子说明吧

使用说明

1、格式化json数据

echo '{"kind": "Service", "apiVersion": "v1", "status": {"loadBalancer": true}}'|jq .
{
  "kind": "Service",
  "apiVersion": "v1",
  "status": {
    "loadBalancer": true
  }
}

只要3个字母搞定，其中jq是工具命令，后面参数是过滤选择参数，"." 表示直接输出完整的json数据。

Usage: jq [options] [file...]

2. 过滤出需要的字段信息

cat service.json
{
    "kind": "Service",
    "apiVersion": "v1",
    "metadata": {
        "name": "kubernetes",
        "namespace": "default",
    },
    "spec": {
        "ports": [
            {
                "protocol": "TCP",
                "port": 443,
                "targetPort": 443,
                "nodePort": 0
            }
        ],
.....很多数据
}
cat service.json|jq .metadata.name
"kubernetes"

3、过滤出某个数组对象

cat service.json|jq .spec.ports[0]  
{
  "protocol": "TCP",
  "port": 443,
  "targetPort": 443,
  "nodePort": 0
}

4、使用管道过滤并调整输出

cat service.json|jq  ".spec.ports[0]| {srcPort: .port, targetPort: .targetPort}"    
{
  "srcPort": 443,
  "targetPort": 443
}

如果数据的下标为不填，将输出所有数组的过滤值，如 cat service.json|jq ".spec.ports[]| {srcPort: .port, targetPort: .targetPort}"

5、 自定义输出数组

cat t.json
{
  "parents": [
    {
      "sha": "54b9c9bdb225af5d886466d72f47eafc51acb4f7",
      "url": "https://api.github.com/repos/stedolan/jq/commits/54b9c9bdb225af5d886466d72f47eafc51acb4f7",
      "html_url": "https://github.com/stedolan/jq/commit/54b9c9bdb225af5d886466d72f47eafc51acb4f7"
    },
    {
      "sha": "8b1b503609c161fea4b003a7179b3fbb2dd4345a",
      "url": "https://api.github.com/repos/stedolan/jq/commits/8b1b503609c161fea4b003a7179b3fbb2dd4345a",
      "html_url": "https://github.com/stedolan/jq/commit/8b1b503609c161fea4b003a7179b3fbb2dd4345a"
    }
  ]
}
cat t.json|jq ' { html_urls: [.parents[].html_url]}'
{
  "html_urls": [
    "https://github.com/stedolan/jq/commit/54b9c9bdb225af5d886466d72f47eafc51acb4f7",
    "https://github.com/stedolan/jq/commit/8b1b503609c161fea4b003a7179b3fbb2dd4345a"
  ]
}

6、支持条件查询

举个简单例子，只输出tcp协议端口信息

cat service.json|jq .spec.ports[0]  
{
  "protocol": "TCP",
  "port": 443,
  "targetPort": 443,
  "nodePort": 0
}
cat service.json |jq 'if .spec.ports[0].protocol = "tcp" then .spec.ports[0] else "not tcp" end'

注意jq 的语法有点奇怪， 必须 if else 同时存在，数字相等是用 "=="，字符串是"="

总之，jq 功能是很强大的，它是一个c语言写的小工具，包括很多正则匹配，更多高级使用方法，见 https://stedolan.github.io/jq/manual/

安装说明

Debian and Ubuntu 下

  sudo apt-get install jq

OS X 下

brew install jq

源码安装

git clone https://github.com/stedolan/jq.git
cd jq
autoreconf -i
./configure --disable-maintainer-mode
make
sudo make install

windows下也可以直接下载，但是没用过。 详细见https://stedolan.github.io/jq/download/

网易云大礼包：https://www.163yun.com/gift

本文来自网易实践者社区，经作者娄超授权发布