内容

json_populate_recordset()

将 JSON 对象数组扩展为行集的函数

json_populate_recordset() 是一个系统函数，用于将 JSON 对象的顶层数组扩展为行集。

json_populate_recordset() 在 PostgreSQL 9.3 中添加。

用法

json_populate_recordset ( base anyelement, from_json json ) → setof anyelement

base 参数必须是复合类型，其列名对应于 JSON 字段。

变更历史

示例

json_populate_recordset() 的基本用法示例

postgres=# CREATE TYPE foobar AS (id INT, val TEXT);
CREATE TYPE

postgres=# SELECT * FROM json_populate_recordset(NULL::foobar,  '[{"id":1,"val":"foo"}, {"id":2,"val":"bar"}]');
 id | val 
----+-----
  1 | foo
  2 | bar
(2 rows)

如果提供的 JSON 对象不包含与预期列名匹配的字段，则会发出 NULL 值

postgres=# SELECT id IS NULL, id, val IS NULL, val
             FROM json_populate_recordset(NULL::foobar,  '[{"a":1,"val":"foo"}, {"id":2,"b":"bar"}]');
 ?column? | id | ?column? | val 
----------+----+----------+-----
 t        |    | f        | foo
 f        |  2 | t        | 
(2 rows)

如果 JSON 对象包含无法转换为预期列数据类型的值，则会引发 ERROR

postgres=# SELECT * FROM json_populate_recordset(NULL::foobar,  '[{"id":"baz","val":"foo"}, {"id":2,"val":"bar"}]');
ERROR:  invalid input syntax for type integer: "baz"

分类

JSON，系统函数

参见

jsonb_populate_recordset()，json_populate_record()，json_to_recordset()

反馈

提交任何关于 "json_populate_recordset()" 的评论、建议或更正 在此处。