Γρήγορη αναφορά

Οδηγός PostgreSQL JSON & JSONB

Γρήγορος οδηγός για JSON και JSONB στην PostgreSQL: τελεστές εξαγωγής, έλεγχος ύπαρξης, τροποποιήσεις διαδρομής και συναρτήσεις συνάθροισης.

· Δημοσιεύτηκε

Η PostgreSQL παρέχει εγγενή υποστήριξη δεδομένων JSON μέσω των τύπων json (αποθηκεύει το κείμενο αυτούσιο) και jsonb (δυαδική μορφή που υποστηρίζει ευρετήρια GIN και γρήγορη αναζήτηση).

Τελεστές εξαγωγής

Το μονό βέλος (->, #>) επιστρέφει json/jsonb. Το διπλό βέλος (->>, #>>) επιστρέφει text.

SELECT * FROM users WHERE data->>'name' = 'John';
SELECT data->>'name' AS name FROM users;
Τελεστής Αριστερός τύπος Δεξιός τύπος Περιγραφή Τύπος επιστροφής
-> jsonb int Λήψη στοιχείου πίνακα με δείκτη από το 0 jsonb
-> jsonb text Λήψη πεδίου αντικειμένου με κλειδί jsonb
#> jsonb text[] Λήψη τιμής στην καθορισμένη διαδρομή jsonb
->> jsonb int Λήψη στοιχείου πίνακα ως κείμενο text
->> jsonb text Λήψη πεδίου αντικειμένου ως κείμενο text
#>> jsonb text[] Λήψη τιμής στη διαδρομή ως κείμενο text

Παραδείγματα ερωτημάτων διαδρομής

-- Extract nested data.address.city as text
SELECT data#>>'{address,city}' FROM customers;

-- Extract second element in items array
SELECT order_info->'items'->>1 FROM orders;

Λογικοί τελεστές και τελεστές εγκλεισμού (μόνο jsonb)

-- Check if JSON object contains a specific top-level key
SELECT * FROM users WHERE data ? 'email';

-- Check if JSON contains all keys in array
SELECT * FROM users WHERE data ?& array['name', 'email'];

-- Check if JSON contains any key in array
SELECT * FROM users WHERE data ?| array['mobile', 'email'];

-- Containment: Left contains Right
SELECT * FROM users WHERE data @> '{"role": "admin"}'::jsonb;

-- Contained by: Left is contained within Right
SELECT * FROM users WHERE data <@ '{"role": "admin", "active": true}'::jsonb;

Τροποποίηση και ενημέρωση δεδομένων JSONB

Συνένωση & Διαγραφή κλειδιών

-- Append or update key in jsonb object
UPDATE users SET data = data || '{"active": true}'::jsonb WHERE id = 1;

-- Delete key from object
UPDATE users SET data = data - 'temporary_token' WHERE id = 1;

-- Delete element from array by index
UPDATE users SET tags = tags - 1 WHERE id = 1;

-- Delete nested path
UPDATE users SET data = data #- '{profile,avatar}' WHERE id = 1;

Συνάρτηση jsonb_set

-- Syntax: jsonb_set(target, path, new_value, create_missing)
UPDATE users
SET data = jsonb_set(data, '{contact,phone}', '"555-0199"', true)
WHERE id = 1;

Συναρτήσεις συνάθροισης & κατασκευής

-- Convert rows to JSON array
SELECT json_agg(u) FROM (SELECT id, name FROM users) u;

-- Build JSON object from key-value pairs
SELECT json_build_object('id', id, 'username', name) FROM users;

-- Expand JSON object to table rows
SELECT * FROM json_each('{"a": 1, "b": 2}');
-- Returns columns: key (text), value (json)

Αναφορές

Σχετικά θέματα