json

文本形式的 JSON 数据

当前查看 PostgreSQL 18。

中文定义与说明

文本形式的 JSON 数据

同版本中文手册节选

JSON 数据类型用于存储 JSON（JavaScript Object Notation）数据，如 RFC 7159 所定义。这类数据也可以存储为 text，但 JSON 数据类型的优势在于会强制每个存储值都符合 JSON 规则。此外，对于存储在这些数据类型中的数据，还提供了各种 JSON 专用的函数和操作符；见第 9.16 节。

PostgreSQL 提供两种用于存储 JSON 数据的类型：json 和 jsonb。为了为这些数据类型实现高效的查询机制，PostgreSQL 还提供了 jsonpath 数据类型，其说明见第 8.14.7 节。

json 和 jsonb 数据类型接收的输入值集合几乎完全相同。主要的实际区别在于效率。json 数据类型存储输入文本的精确副本，因此处理函数在每次执行时都必须重新解析；而 jsonb 数据则以分解后的二进制格式存储，由于增加了转换开销，输入时会稍慢一些，但处理起来会显著更快，因为不需要重新解析。jsonb 还支持索引，这可能是一个显著优势。

由于 json 类型存储的是输入文本的精确副本，因此它会保留词元之间在语义上无关紧要的空白，以及 JSON 对象内部键的顺序。此外，如果值中的某个 JSON 对象包含同一个键多次，所有键/值对都会被保留下来（处理函数会将最后一个值视为生效值）。相比之下，jsonb 不保留空白，不保留对象键的顺序，也不保留重复的对象键。如果输入中指定了重复的键，则只保留最后一个值。

查看完整中文手册与上下文。

PG10–20 核心源码清单。类型转换与操作符类列出源码显式声明的关系；缺少记录不能排除通过其他机制进行转换或使用索引。

定义

文本形式的 JSON 数据

json

目录名称: pg_catalog.json
类型 OID: 114
类型种类: 基础类型
声明长度: 变长（varlena）
存储策略: 扩展
输入函数: json_in
输出函数: json_out

系统目录属性

此构建的源码初始化值。字段含义参见 pg_type 。包含头文件默认值；依赖构建的常量保留符号形式，不作为服务器运行时实测。

oid: 114
descr: JSON stored as text
typacl: _null_
typlen: -1
typelem: 0
typname: json
typsend: json_send
typtype: b
typalign: i
typarray: 0
typbyval: f
typdelim: ','
typinput: json_in
typmodin: -
typndims: 0
typowner: POSTGRES
typrelid: 0
typmodout: -
typoutput: json_out
typtypmod: -1
typanalyze: -
typdefault: _null_
typnotnull: f
typreceive: json_recv
typstorage: x
typbasetype: 0
typcategory: U
typcollation: 0
typisdefined: t
typnamespace: pg_catalog
typsubscript: -
typdefaultbin: _null_
array_type_oid: 199
typispreferred: f
array_type_name: _json

类型转换 2

与此类型相关的显式 pg_cast 记录。PostgreSQL 还支持 pg_cast 之外的类型转换，缺少记录不能证明转换不可能。

源类型	目标类型	转换上下文	转换方式	函数
`json`	`jsonb`	`赋值`	`输入／输出`	`0`
`jsonb`	`json`	`赋值`	`输入／输出`	`0`

运算符重载 6

每种操作数签名均为独立重载。实现函数和返回类型来自同一源码构建。

运算符	左操作数	右操作数	返回类型	含义	实现函数
`->`	`json`	`text`	`json`	获取 JSON 对象字段。	`json_object_field`
`->>`	`json`	`text`	`text`	获取 JSON 对象字段并返回文本。	`json_object_field_text`
`->`	`json`	`int4`	`json`	获取 JSON 数组元素。	`json_array_element`
`->>`	`json`	`int4`	`text`	获取 JSON 数组元素并返回文本。	`json_array_element_text`
`#>`	`json`	`_text`	`json`	按路径元素获取 JSON 值。	`json_extract_path`
`#>>`	`json`	`_text`	`text`	按路径元素获取 JSON 值并返回文本。	`json_extract_path_text`

版本比较

PostgreSQL 17 → 18。属性比较不包含构建标识和说明正文；原始目录字段与源描述保留原文。

这两个样本的系统目录和结构化属性没有变化。

文档与源码

构建: 18.6 · https://ftp.postgresql.org/pub/source/v18.6/postgresql-18.6.tar.bz2
指纹: 555610c24d53e4316da5b7d3fc25c279d96856d5e0e23ee308c328c5fa881d9f

快速链接

json

中文定义与说明

同版本中文手册节选

定义

系统目录属性

类型转换 2

运算符重载 6

版本比较

文档与源码

相关条目