Hologres：Tipe data JSON dan JSONB

Operator

Tipe Operand Kanan

Deskripsi

Contoh

Hasil Eksekusi

->

int

Mendapatkan elemen array JSON dengan indeks dimulai dari nol. Bilangan bulat negatif menunjukkan bahwa elemen dihitung mundur dari akhir.

select '[{"a":"foo"},{"b":"bar"},{"c":"baz"}]'::json->2

{"c":"baz"}

->

text

Mendapatkan bidang objek JSON berdasarkan kunci.

select '{"a": {"b":"foo"}}'::json->'a'

{"b":"foo"}

->>

int

Mendapatkan elemen array JSON sebagai teks.

select '[1,2,3]'::json->>2

3

->>

text

Mendapatkan bidang objek JSON sebagai teks.

select '{"a":1,"b":2}'::json->>'b'

2

#>

text[]

Mendapatkan objek JSON dari jalur yang ditentukan.

select '{"a": {"b":{"c": "foo"}}}'::json#>'{a,b}'

{"c":"foo"}

#>>

text[]

Mendapatkan objek JSON sebagai teks dari jalur yang ditentukan.

select '{"a":[1,2,3],"b":[4,5,6]}'::json#>>'{a,2}'

3

Operator

Tipe Operand Kanan

Deskripsi

Contoh

Hasil Eksekusi

@>

jsonb

Menentukan apakah nilai JSON kiri berisi jalur JSON atau nilai kanan.

select '{"a":1, "b":2}'::jsonb @> '{"b":2}'::jsonb

true

<@

jsonb

Menentukan apakah jalur JSON atau nilai kiri terkandung dalam nilai JSON kanan.

select '{"b":2}'::jsonb <@ '{"a":1, "b":2}'::jsonb

true

?

text

Menentukan apakah string kunci atau elemen ada dalam nilai JSON.

select '{"a":1, "b":2}'::jsonb ? 'b'

true

?|

text[]

Menentukan apakah string kunci atau elemen dalam string array ada dalam nilai JSON.

select '{"a":1, "b":2, "c":3}'::jsonb ?| array['b', 'c']

true

?&

text[]

Menentukan apakah semua string array ada dalam nilai JSON.

select '["a", "b"]'::jsonb ?& array['a', 'b']

true

||

jsonb

Menggabungkan dua nilai JSONB menjadi nilai JSONB baru.

select '["a", "b"]'::jsonb || '["c", "d"]'::jsonb

["a", "b", "c", "d"]

-

text

Menghapus kunci atau nilai dari operand kiri. Kunci atau nilai dicocokkan berdasarkan nilai kunci.

select '{"a": "b"}'::jsonb - 'a'

{}

-

text[]

Menghapus beberapa kunci atau nilai dari operand kiri. Kunci atau nilai dicocokkan berdasarkan nilai kunci.

select '{"a": "b", "c": "d"}'::jsonb - '{a,c}'::text[]

{}

-

integer

Menghapus elemen array yang berada di posisi yang ditentukan. Bilangan bulat negatif menunjukkan bahwa elemen dihitung mundur dari akhir. Kesalahan dikembalikan jika data JSON tidak disimpan sebagai array.

select '["a", "b"]'::jsonb - 1

["a"]

#-

text[]

Menghapus elemen dengan jalur yang ditentukan. Untuk array JSON, bilangan bulat negatif menunjukkan bahwa elemen dihitung mundur dari akhir.

select '["a", {"b":1}]'::jsonb #- '{1,b}'

["a", {}]

Fungsi

Tipe Nilai Kembali

Deskripsi

Contoh

Hasil Eksekusi

json_array_length(json)

int

Mengembalikan jumlah elemen dalam array JSON paling luar.

select json_array_length('[1,2,3,{"f1":1,"f2":[5,6]},4]')

5

jsonb_array_length(jsonb)

json_object_keys(json)

setof text

Mengembalikan satu set kunci dalam objek JSON paling luar.

select json_object_keys('{"f1":"abc","f2":{"f3":"a", "f4":"b"}}')

json_object_keys
------------------
 f1
 f2

jsonb_object_keys(jsonb)

json_populate_record(base anyelement, from_json json)

anyelement

Mengembangkan objek dalam parameter from_json menjadi baris dengan kolom yang sesuai dengan tipe rekaman yang didefinisikan oleh parameter base.

begin;
create table 
myrowtype( a text, b text, c text);commit;
select * from json_populate_record(null::myrowtype, '{"a": 1, "b": ["2", "a b"], "c": {"d": 4, "e": "a b c"}}')

 a |   b       |      c
---+-----------+-------------
 1 | ["2", "a b"] | {"d": 4, "e": "a b c"}

jsonb_populate_record(base anyelement, from_json jsonb)

json_populate_recordset(base anyelement, from_json json)

setof anyelement

Mengembangkan array paling luar dari objek dalam parameter from_json menjadi satu set baris dengan kolom yang sesuai dengan tipe rekaman yang didefinisikan oleh parameter base.

begin;
create table 
myrowtype(a text,b text);
commit;
select * from json_populate_recordset(null::myrowtype, '[{"a":1,"b":2},{"a":3,"b":4}]')

 a | b
---+---
 1 | 2
 3 | 4

jsonb_populate_recordset(base anyelement, from_json jsonb)

json_array_elements(json)

setof json

Mengembangkan array JSON menjadi satu set nilai JSON.

select * from json_array_elements('[1,true, [2,false]]')

   value
-----------
 1
 true
 [2,false]

jsonb_array_elements(jsonb)

setof jsonb

json_array_elements_text(json)

setof text

Mengembangkan array JSON menjadi satu set nilai teks.

select * from json_array_elements_text('["foo", "bar"]')

 value
-----------
 foo
 bar

jsonb_array_elements_text(jsonb)

json_typeof(json)

text

Mengembalikan tipe data dari nilai JSON paling luar sebagai string teks. Tipe data yang mungkin termasuk OBJECT, ARRAY, STRING, NUMBER, BOOLEAN, dan NULL.

select json_typeof('-123.4')

number

jsonb_typeof(jsonb)

json_strip_nulls(from_json json)

json

Mengembalikan objek dalam parameter from_json. Bidang objek yang memiliki nilai null dihilangkan. Nilai null lainnya dipertahankan.

select json_strip_nulls('[{"f1":1,"f2":null},2,null,3]')

[{"f1":1},2,null,3]

jsonb_strip_nulls(from_json jsonb)

jsonb

jsonb_set(target jsonb, path text[], new_value jsonb[,create_missing boolean])

jsonb

Mengembalikan objek dalam parameter target. Node yang ditentukan oleh parameter path diganti dengan nilai dari parameter new_value. Jika nilai parameter create_missing adalah true dan item yang ditentukan oleh parameter path tidak ada, nilai dari parameter new_value dimasukkan. Nilai default dari parameter create_missing adalah true. Sesuai dengan persyaratan operator berbasis jalur, bilangan bulat negatif dalam nilai parameter path menunjukkan bahwa elemen dihitung mundur dari akhir array JSON.

select jsonb_set('[{"f1":1,"f2":null},2,null,3]', '{0,f1}','[2,3,4]', false);

[{"f1":[2,3,4],"f2":null},2,null,3]

select jsonb_set('[{"f1":1,"f2":null},2]', '{0,f3}','[2,3,4]')

[{"f1": 1, "f2": null, "f3": [2, 3, 4]}, 2]

jsonb_insert(target jsonb, path text[], new_value jsonb, [insert_after boolean])

jsonb

Mengembalikan objek dalam parameter target dengan nilai dari parameter new_value disisipkan. Node yang ditentukan oleh parameter path dapat berada dalam array JSONB. Dalam hal ini, jika nilai parameter insert_after adalah false, yang merupakan nilai default, nilai dari parameter new_value disisipkan sebelum nilai dari parameter target. Sebaliknya, nilai dari parameter new_value disisipkan setelah nilai dari parameter target. Node yang ditentukan oleh parameter path dapat berada dalam objek JSONB. Dalam hal ini, nilai dari parameter new_value hanya disisipkan jika nilai dari parameter target tidak ada. Sesuai dengan persyaratan operator berbasis jalur, bilangan bulat negatif dalam nilai parameter path menunjukkan bahwa elemen dihitung mundur dari akhir array JSON.

select jsonb_insert('{"a": [0,1,2]}', '{a, 1}', '"new_value"')

{"a": [0, "new_value", 1, 2]}

select jsonb_insert('{"a": [0,1,2]}', '{a, 1}', '"new_value"', true)

{"a": [0, 1, "new_value", 2]}

jsonb_pretty(from_json jsonb)

text

Mengembalikan objek dalam parameter from_json sebagai teks JSON yang berindentasi.

select jsonb_pretty('[{"f1":1,"f2":null},2,null,3]')

[
    {
        "f1": 1,
        "f2": null
    },
    2,
    null,
    3
]

jsonb_agg

jsonb

Mengumpulkan nilai, termasuk nilai null, ke dalam array JSON.

DROP TABLE IF EXISTS t;

CREATE TABLE t (
    k int PRIMARY KEY,
    class int NOT NULL,
    v text NOT NULL
);

INSERT INTO t (k, class, v)
SELECT
    (1 + s.v),
    CASE (s.v) < 3
    WHEN TRUE THEN
        1
    ELSE
        2
    END,
    chr(97 + s.v)
FROM
    generate_series(0, 5) AS s (v);

SELECT
    class,
    jsonb_agg(v ORDER BY v DESC) FILTER (WHERE v <> 'b') AS "jsonb_agg",
    jsonb_object_agg(v, k ORDER BY v DESC) FILTER (WHERE v <> 'e') AS "jsonb_object_agg(v, k)"
FROM
    t
GROUP BY
    class;

 class |    jsonb_agg    |  jsonb_object_agg(v, k)
-------+-----------------+--------------------------
     1 | ["c", "a"]      | {"a": 1, "b": 2, "c": 3}
     2 | ["f", "e", "d"] | {"d": 4, "f": 6}

jsonb_object_agg

jsonb

Mengumpulkan pasangan kunci-nilai ke dalam objek JSON. Nilai dapat kosong, tetapi kunci tidak boleh kosong.

DROP TABLE IF EXISTS t;

CREATE TABLE t (
    k int PRIMARY KEY,
    class int NOT NULL,
    v text NOT NULL
);

INSERT INTO t (k, class, v)
SELECT
    (1 + s.v),
    CASE (s.v) < 3
    WHEN TRUE THEN
        1
    ELSE
        2
    END,
    chr(97 + s.v)
FROM
    generate_series(0, 5) AS s (v);

SELECT
    class,
    jsonb_agg(v ORDER BY v DESC) FILTER (WHERE v <> 'b') AS "jsonb_agg",
    jsonb_object_agg(v, k ORDER BY v DESC) FILTER (WHERE v <> 'e') AS "jsonb_object_agg(v, k)"
FROM
    t
GROUP BY
    class;

 class |    jsonb_agg    |  jsonb_object_agg(v, k)
-------+-----------------+--------------------------
     1 | ["c", "a"]      | {"a": 1, "b": 2, "c": 3}
     2 | ["f", "e", "d"] | {"d": 4, "f": 6}

is_valid_json

BOOLEAN

Memvalidasi string JSON. Nilai Boolean true (t) dikembalikan jika string input adalah string JSON yang valid. Jika tidak, nilai Boolean false (f) dikembalikan.

DROP TABLE IF EXISTS test_json;

CREATE TABLE test_json (
    id int,
    json_strings text
);

INSERT INTO test_json
    VALUES (1, '{"a":2}'), (2, '{"a":{"b":{"c":1}}}'), (3, '{"a": [1,2,"b"]}');

INSERT INTO test_json
    VALUES (4, '{{}}'), (5, '{1:"a"}'), (6, '[1,2,3]');

SELECT
    id,
    json_strings,
    is_valid_json (json_strings)
FROM
    test_json
ORDER BY
    id;

id | json_strings        | is_valid_json
---+---------------------+--------------
 0 | {"a":2}             | true
 2 | {"a":{"b":{"c":1}}} | true
 4 | {"a": [1,2,"b"]}    | true
 6 | {{}}                | false
 8 | {1:"a"}             | false
10 | [1,2,3]             | true