华为云用户手册

数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:jsonb_strip_nulls(jsonb)

jsonb_strip_nulls(jsonb) 描述：所有具有空值的对象字段均被省略。其他空值保持不变。返回类型：jsonb 示例： 1 2 3 4 5 SELECT jsonb_strip_nulls('[{"f1":1,"f2":null},2,null,3]'); jsonb_strip_nulls ------------------------- [{"f1": 1}, 2, null, 3] (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:jsonb_array_elements(array-jsonb)

jsonb_array_elements(array-jsonb) 描述：拆分数组，每一个元素返回一行。返回类型：jsonb 示例： 1 2 3 4 5 6 7 8 SELECT jsonb_array_elements('[1,true,[1,[2,3]],null]'); jsonb_array_elements ---------------------- 1 true [1, [2, 3]] null (4 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:jsonb_object_agg

jsonb_object_agg 描述：将键/值对聚集成一个JSON对象。返回类型：jsonb 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 SELECT * FROM json_tbl_3; a | b | c ---+-----+---- 1 | aaa | 10 1 | bbb | 20 2 | ccc | 30 2 | ddd | 40 (4 rows) SELECT a, jsonb_object_agg(b, c) FROM json_tbl_3 GROUP BY a ORDER BY a; a | jsonb_object_agg ---+------------------------ 1 | {"aaa": 10, "bbb": 20} 2 | {"ccc": 30, "ddd": 40} (2 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:jsonb_object(text[])

jsonb_object(text[]) 描述：从一个文本数组构造一个object-jsonb。这是个重载函数，当入参为一个文本数组的时候，其数组长度必须为偶数，成员被当做交替出现的键/值对。返回类型：jsonb 示例： 1 2 3 4 5 SELECT jsonb_object('{a,1,b,2,3,NULL,"d e f","a b c"}'); jsonb_object --------------------------------------------------- {"3": null, "a": "1", "b": "2", "d e f": "a b c"} (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:jsonb_agg

jsonb_agg 描述：将jsonb对象聚合成jsonb数组。返回类型：jsonb 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 SELECT * FROM json_tbl_2; a | b ---+----- 1 | aaa 1 | bbb 2 | ccc 2 | ddd (4 rows) SELECT a, jsonb_agg(b) FROM json_tbl_2 GROUP BY a ORDER BY a; a | jsonb_agg ---+---------------- 1 | ["aaa", "bbb"] 2 | ["ccc", "ddd"] (2 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:jsonb_extract((jsonb, VARIADIC text[])

jsonb_extract((jsonb, VARIADIC text[]) 描述：输入任意的object-jsonb类型、array-jsonb类型，返回$2所指路径的值。该函数仅9.1.0及以上集群版本支持。返回类型：SETOF jsonb 示例： 1 2 3 4 5 6 7 8 9 10 11 12 SELECT jsonb_extract('{"f2":{"f3":1},"f4":[{"f5":99},{"f6":"stringy"}]}','f2','f3'); jsonb_extract --------------- 1 (1 row) SELECT jsonb_extract('{"f2":{"f3":1},"f4":[{"f5":99},{"f5":"stringy"}]}', 'f4','f5'); jsonb_extract --------------- 99 "stringy" (2 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:jsonb_extract_text((jsonb, VARIADIC text[])

jsonb_extract_text((jsonb, VARIADIC text[]) 描述：输入任意的object-jsonb类型、array-jsonb类型，返回$2所指路径的值。该函数仅9.1.0及以上集群版本支持。返回类型：SETOF text 示例： 1 2 3 4 5 6 7 8 9 10 11 12 SELECT jsonb_extract_text('{"f2":{"f3":1},"f4":[{"f5":99},{"f6":"stringy"}]}','f2','f3'); jsonb_extract_text -------------------- 1 (1 row) SELECT jsonb_extract_text('{"f2":{"f3":1},"f4":[{"f5":99},{"f5":"stringy"}]}', 'f4','f5'); jsonb_extract_text -------------------- 99 stringy (2 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:jsonb_object(text[], text[])

jsonb_object(text[], text[]) 描述：两个文本数组的时候，第一个数组认为是键，第二个认为是值，两个数组长度必须相等。键不可为null。返回类型：jsonb 示例： 1 2 3 4 5 SELECT jsonb_object('{a,b,"a b c"}', '{a,1,1}'); jsonb_object ------------------------------------ {"a": "a", "b": "1", "a b c": "1"} (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_strip_nulls(json)

json_strip_nulls(json) 描述：所有具有空值的对象字段被忽略，其他值保持不变。返回类型：json 示例： 1 2 3 4 5 SELECT json_strip_nulls('[{"f1":1,"f2":null},2,null,3]'); json_strip_nulls --------------------- [{"f1":1},2,null,3] (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_array_elements(array-json)

json_array_elements(array-json) 描述：拆分数组，每一个元素返回一行。返回类型：json 示例： 1 2 3 4 5 6 7 8 SELECT json_array_elements('[1,true,[1,[2,3]],null]'); json_array_elements --------------------- 1 true [1,[2,3]] null (4 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_populate_recordset(anyelement, array-json [, bool])

json_populate_recordset(anyelement, array-json [, bool]) 描述：参考函数json_populate_record、jsonb_populate_record，对$2数组的每一个元素进行上述参数函数的操作，因此这也要求$2数组的每个元素都是object-json类型。返回类型：setof anyelement 示例： 1 2 3 4 5 6 7 CREATE TYPE jpop AS (a text, b INT, c timestamp); SELECT * FROM json_populate_recordset(null::jpop, '[{"a":1,"b":2},{"a":3,"b":4}]'); a | b | c ---+---+--- 1 | 2 | 3 | 4 | (2 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_object_keys(object-json)

json_object_keys(object-json) 描述：返回对象中顶层的所有键。返回类型：text 示例： 1 2 3 4 5 6 7 SELECT json_object_keys('{"f1":"abc","f2":{"f3":"a", "f4":"b"}, "f1":"abcd"}'); json_object_keys ------------------ f1 f2 f1 (3 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_each_text(object-json)

json_each_text(object-json) 描述：将对象的每个键值对拆分转换成一行两列。返回类型：setof(key text, value text) 示例： 1 2 3 4 5 6 7 SELECT * FROM json_each_text('{"f1":[1,2,3],"f2":{"f3":1},"f4":null}'); key | value -----+---------- f1 | [1,2,3] f2 | {"f3":1} f4 | (3 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_to_record(object-json)

json_to_record(object-json) 描述：正如所有返回record的函数一样，调用者必须用一个AS子句显式地定义记录的结构。会将object-json的键值对进行拆分重组，把键当做列名，去匹配填充AS显示指定的记录的结构。返回类型：record 示例： 1 2 3 4 5 SELECT * FROM json_to_record('{"a":1,"b":"foo","c":"bar"}'::json) as x(a int, b text, d text); a | b | d ---+-----+--- 1 | foo | (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_array_elements_text(array-json)

json_array_elements_text(array-json) 描述：拆分数组，每一个元素返回一行。返回类型：text 示例： 1 2 3 4 5 6 7 8 SELECT * FROM json_array_elements_text('[1,true,[1,[2,3]],null]'); value ----------- 1 true [1,[2,3]] (4 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_each(object-json)

json_each(object-json) 描述：将对象的每个键值对拆分转换成一行两列。返回类型：setof(key text, value json) 示例： 1 2 3 4 5 6 7 SELECT * FROM json_each('{"f1":[1,2,3],"f2":{"f3":1},"f4":null}'); key | value -----+---------- f1 | [1,2,3] f2 | {"f3":1} f4 | null (3 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_to_recordset(array-json)

json_to_recordset(array-json) 描述：参考函数json_to_record，对数组内个每个元素，执行上述函数的操作，因此这要求数组内的每个元素都得是object-json。返回类型：setof record 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 SELECT * FROM json_to_recordset('[{"a":1,"b":{"d":"foo"},"c":true},{"a":2,"c":false,"b":{"d":"bar"}}]') AS x(a INT, b json, c BOOLEAN); a | b | c ---+-------------+--- 1 | {"d":"foo"} | t 2 | {"d":"bar"} | f (2 rows) SELECT * FROM json_to_recordset('[{"a":1,"b":"foo","d":false},{"a":2,"b":"bar","c":true}]') AS x(a INT, b text, c BOOLEAN); a | b | c ---+-----+--- 1 | foo | 2 | bar | t (2 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_populate_record(anyelement, object-json [, bool])

json_populate_record(anyelement, object-json [, bool]) 描述：$1必须是一个复合类型的参数。将会把object-json里的每个对键值进行拆分，以键当做列名，与$1中的列名进行匹配查找，并填充到$1的格式中。 JSON/JSONB函数中入参为复合类型时，可以使用CREATE TYPE或CREATE TABLE定义复合类型，例如： 1 2 CREATE TYPE jpop AS (a text, b INT, c timestamp); CREATE TABLE jpop2(a text, b INT, c timestamp); 返回类型：anyelement 示例： 1 2 3 4 5 6 CREATE TYPE jpop AS (a text, b INT, c timestamp); SELECT * FROM json_populate_record(null::jpop,'{"a":"blurfl","x":43.2}'); a | b | c --------+---+--- blurfl | | (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:to_json(anyelement)

to_json(anyelement) 描述：把参数转换为json。返回类型：json 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 SELECT to_json('Fred said "Hi."'::text); to_json --------------------- "Fred said \"Hi.\"" (1 row) ——将列存表json_tbl_2转换为json postgres=# SELECT * FROM json_tbl_2; a | b ---+----- 1 | aaa 1 | bbb 2 | ccc 2 | ddd (4 rows) postgres=# SELECT to_json(t.*) FROM json_tbl_2 t; to_json ------------------- {"a":1,"b":"bbb"} {"a":2,"b":"ddd"} {"a":1,"b":"aaa"} {"a":2,"b":"ccc"} (4 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:row_to_json(record [, pretty_bool])

row_to_json(record [, pretty_bool]) 描述：返回JSON类型的行。如果pretty_bool设置为true，将在第一级元素之间添加换行符。返回类型：json 示例： 1 2 3 4 5 SELECT row_to_json(row(1,'foo')); row_to_json --------------------- {"f1":1,"f2":"foo"} (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:array_to_json(anyarray [, pretty_bool])

array_to_json(anyarray [, pretty_bool]) 描述：返回JSON类型的数组。一个多维数组成为一个JSON数组的数组。如果pretty_bool设置为true，将在一维元素之间添加换行符。返回类型：json 示例： 1 2 3 4 5 SELECT array_to_json('{{1,5},{99,100}}'::int[]); array_to_json ------------------ [[1,5],[99,100]] (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_agg(any)

json_agg(any) 描述：将值聚集为json数组。返回类型：array-json 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 SELECT * FROM classes; name | score -----+------- A | 2 A | 3 D | 5 D | (4 rows) SELECT name, json_agg(score) score FROM classes group by name order by name; name | score -----+----------------- A | [2, 3] D | [5, null] | [null] (3 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_object_agg(any, any)

json_object_agg(any, any) 描述：将值聚集为json对象。返回类型：json 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 SELECT * FROM classes; name | score -----+------- A | 2 A | 3 D | 5 D | (4 rows) SELECT json_object_agg(name, score) FROM classes group by name order by name; json_object_agg ------------------------- { "A" : 2, "A" : 3 } { "D" : 5, "D" : null } (2 rows)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_build_object(VARIADIC "any")

json_build_object(VARIADIC "any") 描述：从可变参数列表中构建JSON对象。参数列表由交替的键和值组成。其入参必须为偶数个，两两一组组成键值对。注意键不可为null。返回类型：json 示例： 1 2 3 4 5 SELECT json_build_object('foo',1,'bar',2); json_build_object ------------------------ {"foo" : 1, "bar" : 2} (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-JSON/JSONB函数:json_object(text[])、json_object(text[], text[])

json_object(text[])、json_object(text[], text[]) 描述：从文本数组中构建JSON对象。这是个重载函数，当入参为一个文本数组的时候，其数组长度必须为偶数，成员被当做交替出现的键/值对。两个文本数组的时候，第一个数组被视为键，第二个被视为值，两个数组长度必须相等。键不可为null。返回类型：json 示例： 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 SELECT json_object('{a, 1, b, "def", c, 3.5}'); json_object --------------------------------------- {"a" : "1", "b" : "def", "c" : "3.5"} (1 row) SELECT json_object('{{a, 1},{b, "def"},{c, 3.5}}'); json_object --------------------------------------- {"a" : "1", "b" : "def", "c" : "3.5"} (1 row) SELECT json_object('{a,b,"a b c"}', '{a,1,1}'); json_object --------------------------------------- {"a" : "a", "b" : "1", "a b c" : "1"} (1 row)

数据仓库服务 GAUSSDB(DWS) JSON/JSONB函数和操作符
数据仓库服务 GAUSSDB(DWS)-产生XML内容:XMLSERIALIZE ( { DOCUMENT | CONTENT } value AS type

XMLSERIALIZE ( { DOCUMENT | CONTENT } value AS type 描述：从XML类型的值生成一个字符串。返回值类型：type，可以是character，character varying或text（或其别名）示例： 1 2 3 4 5 SELECT xmlserialize(content 'good' AS CHAR(10)); xmlserialize -------------- good (1 row)

数据仓库服务 GAUSSDB(DWS) XML函数
数据仓库服务 GAUSSDB(DWS)-残留文件管理函数应用:使用步骤

使用步骤调用pgxc_get_residualfiles()函数，获取存在残留文件的数据库名称。分别进入确认有残留文件的数据库，调用pgxc_verify_residualfiles()函数，对当前数据库中记录的残留文件进行验证。调用pgxc_rm_residualfiles()函数，删除所有已经验证过的残留文件。 pgxc类残留文件管理函数只对CN和当前主DN进行操作，不会验证和清理备DN上的残留文件。所以主DN完成清理后，应在备DN上及时执行残留文件清理操作或对备机进行build，防止主备切换后由于增量build导致备机残留文件被重新复制回主DN，导致未成功清理的假象。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-残留文件管理函数应用:使用示例

使用示例以当前两个用户自建的数据库db1、db2为例：在CN上获取集群的所有残留文件记录： 1 db1=# SELECT * FROM pgxc_get_residualfiles() order by 4, 6; -- order by不是必须的当前集群中： dn_6001_6002 节点（当前的主节点实例）的db1和db2数据库中都存在残留文件记录。残留文件在residualfile列展示。 filepath列为记录残留文件的记录文件，保存在实例数据目录下pg_residualfiles目录中。调用pgxc_verify_residualfiles()函数对db1库进行验证： 1 db1=# SELECT * FROM pgxc_verify_residualfiles(); 因为verify类函数都是database级别，所以当前在db1库中调用verify函数时，只对属于db1的残留文件进行验证。可以再次调用get函数查看是否验证完成： 1 db1=# SELECT * FROM pgxc_get_residualfiles() order by 4, 6; 如上图所示，已确认db1数据库中的残留文件都已经验证，db2数据库中的残留文件都未进行验证。调用 pgxc_rm_residualfiles()函数删除残留文件。 1 db1=# SELECT * FROM pgxc_rm_residualfiles(); 再次调用pgxc_get_residualfiles()函数检查删除后的结果。结果显示db1数据库中的残留文件已经被删除（isdeleted标记为t），db2中的残留文件都未被删除。同时可以看到查询出9条结果，与之前查询出的结果相比，缺少一条以9438结尾的残留文件记录文件。这是因为以9438结尾的残留文件记录文件中只有一条残留文件记录，这条记录在步骤3中被删除，当记录文件中的所有残留文件都被删除后，记录文件本身也会被删除，并备份到pg_residualfiles/backup目录中：如果需要删除db2数据库中的文件，需要在db2中调用verify函数后再调用rm函数。进入db2数据库，并调用验证函数：此时可以查询验证的结果：调用删除函数：再查询删除的结果：此时因为 8342 结尾的记录文件中残留文件已经全部删除，所以整个记录文件也被删除并备份到backup目录下，所以查询到0条记录。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-删除残留文件函数:pg_rm_residualfiles()

pg_rm_residualfiles() 描述：用于删除当前实例中所有的残留文件列表中的文件。该函数为实例级函数，与当前所在的数据库无关，可以在任意实例上运行。参数类型：无返回值类型：record 函数返回字段如下：表2 pg_rm_residualfiles()返回字段名称类型描述 result bool 是否已经完成删除。 filepath text 残留文件记录路径。 notes text 注释。示例： 1 2 3 4 5 SELECT * FROM pg_rm_residualfiles(); result | filepath | notes --------+---------------------------+------- t | pgrf_20200908160211441546 | (1 row) 残留文件只有在调用pg_verify_residualfiles()进行验证后才能被真正删除。删除动作不区分数据库，指定文件中所有已经验证的文件都会被删除。如果指定文件中记录的所有文件都已经被删除，指定文件会被移除并备份到$PGDATA/pg_residualfile/backup目录下。

数据仓库服务 GAUSSDB(DWS)
数据仓库服务 GAUSSDB(DWS)-删除残留文件函数:pg_rm_residualfiles(filepath)

pg_rm_residualfiles(filepath) 描述：用于删除当前实例中指定残留文件列表中的文件。该函数为实例级函数，与当前所在的数据库无关，可以在任意实例上运行。参数类型：text 返回值类型：record 函数返回字段如下：表1 pg_rm_residualfiles(filepath)返回字段名称类型描述 result bool 是否已经完成删除。示例： 1 2 3 4 5 SELECT * FROM pg_rm_residualfiles('pgrf_20200908160211441599'); result -------- t (1 row) 残留文件只有在调用pg_verify_residualfiles()进行verify后才能被真正删除。删除动作不区分数据库，指定文件中所有已经verify的文件都会被删除。如果指定文件中记录的所有文件都已经被删除，指定文件会被移除并备份到$PGDATA/pg_residualfile/backup目录下。

数据仓库服务 GAUSSDB(DWS)

共100000条

undefined

意见反馈

0/200

提交取消

提交成功！非常感谢您的反馈，我们会继续努力做到更好反馈提交失败！请稍后重试！

华为云用户手册

7*24

备案

专业服务

退订

建议反馈

售前咨询热线