JSON转表格工具：json-table使用手册

JSON转表格工具：json-table使用手册

项目地址:https://gitcode.com/gh_mirrors/js/json-table

1. 项目介绍

json-table 是一个强大的命令行工具，专为解决在shell环境中高效处理嵌套JSON数据而设计。它能够读取标准输入流中的UTF-8编码JSON数据，并将其转换成制表符分隔值（TSV）或逗号分隔值（CSV），从而便于利用shell的各种实用程序进行进一步的数据分析和处理。该工具配备了简单的堆栈式编程语言来提取JSON输入中的特定值，无需引入复杂的脚本语言，使操作变得简洁高效。

特性亮点：

• 自给自足：静态链接，无运行时依赖。
• 性能优异：对大型JSON文件处理友好，内存占用低。
• 准确性：严格遵循JSON规范的解析器。
• 易于集成：无缝衔接shell命令链。

2. 项目快速启动

安装指南

Linux安装

sudo bash -c "cd /usr/local && wget -O - https://github.com/micha/json-table/raw/master/jt.tar.gz | tar xzvf -"

macOS安装

通过Homebrew，执行：

brew install json-table

源码编译（适合所有平台）

git clone https://github.com/micha/json-table.git
cd json-table
make && make test && sudo make install

使用示例

将JSON转换为TSV，提取账户和金额信息：

echo '[{"account":123,"amount":100},{"account":789,"amount":200}]' | jt '[ account % ] amount %'

输出：

123	100
789	200

3. 应用案例和最佳实践

数据聚合

假设你有一个日志文件充满JSON格式的账户交易记录，可以通过jt先提取出账户和金额，再使用awk和sort计算特定账户的总金额。

jt '[ account % ] amount %' < log.json |
awk -F'\t' '$1 == "特定账号" {sum += $2} END {print "总金额:", sum}'

处理复杂JSON结构

对于包含多层嵌套的JSON，例如云服务的实例状态数据，你可以精确地提出所需字段进行分析。

jt 'asgs [ name % ] instances [ id % ] [ az % ] [ state % ]' < aws_data.json |
awk -F'\t' '{if ($4 == "InService") print}' # 只显示“服务中”的实例信息

4. 典型生态项目

虽然json-table本身是独立的，但其在处理JSON数据时，可以与众多shell工具生态相结合，如awk, sed, sort, jq等，形成强大数据分析流程。比如，结合jq进行更复杂的JSON预处理，或者使用pandas等Python库进一步数据分析，当涉及到JSON到数据库表格的转换时，MySQL的JSON_TABLE()函数也是一个生态内的关联点，尽管不在json-table项目之内，却展示了如何在数据库层面完成类似转换。

json-table项目以其轻量级和专注于JSON到表格数据转换的能力，在shell脚本自动化处理领域中占据了一席之地，简化了复杂JSON数据的分析和处理流程，尤其适用于日常的数据清洗和监控任务。

json-table Transform nested JSON data into tabular data in the shell. 项目地址: https://gitcode.com/gh_mirrors/js/json-table