DEV Community

Cover image for Những tính năng mới của PostgreSQL 19 mà mọi lập trình viên API cần biết
Sebastian Petrus
Sebastian Petrus

Posted on Originally published at apidog.com

Những tính năng mới của PostgreSQL 19 mà mọi lập trình viên API cần biết

PostgreSQL 19: Những tính năng mới quan trọng nhất cho nhà phát triển API

Các tính năng mới của PostgreSQL 19 quan trọng nhất đối với nhà phát triển API: INSERT ... ON CONFLICT DO SELECT cho endpoint get-or-create chỉ với một câu lệnh, WAIT FOR LSN để đọc được chính dữ liệu mình ghi (read-your-writes) trên replica, REPACK (CONCURRENTLY) để dọn bloat trực tuyến, đầu ra JSON từ COPY, các phương thức chuỗi jsonpath mới, và kiểm tra khóa ngoại nhanh hơn khi chèn hàng loạt.

Thử Apidog ngay hôm nay

Bài hướng dẫn này bao gồm những gì thay đổi trong các handler, replica và kế hoạch nâng cấp của bạn. Mọi ví dụ cú pháp đều lấy từ ghi chú phát hành PostgreSQL 19 và các trang tài liệu tham khảo.

Tổng quan những gì mới trong PostgreSQL 19

PostgreSQL 19 là bản phát hành lớn thường niên của cơ sở dữ liệu mã nguồn mở, được PostgreSQL Global Development Group công bố vào ngày 19 tháng 11 năm 2026. Nó bổ sung tính năng chèn get-or-create, chờ replica cho read-your-writes, repack bảng trực tuyến, gợi ý kế hoạch thực thi và nhân bản logic cho sequence, đồng thời thay đổi một số giá trị mặc định mà bạn nên kiểm tra trước khi nâng cấp.

Tính năng Thay thế cho Nơi bạn cảm nhận được
ON CONFLICT DO SELECT Vòng lặp SELECT-then-INSERT có retry Endpoint POST idempotent và đăng ký người dùng
WAIT FOR LSN Định tuyến cứng (sticky routing) mọi thao tác đọc về primary Replica chỉ đọc phía sau một API
REPACK (CONCURRENTLY) VACUUM FULL, CLUSTER, pg_repack Bảng nóng bị bloat, không cần downtime
COPY ... (FORMAT json) Chuyển đổi hàng sang JSON trong mã ứng dụng Endpoint xuất dữ liệu và tải xuống hàng loạt
Các phương thức chuỗi jsonpath Hậu xử lý JSONB trong mã ứng dụng Lọc và chuẩn hóa cột JSON
pg_plan_advice + pg_stash_advice Viết lại truy vấn để điều hướng planner Regression kế hoạch thực thi trong môi trường production
Publication FOR ALL SEQUENCES Reset sequence thủ công sau khi chuyển đổi Nâng cấp blue-green qua nhân bản logic

Thông báo phát hành chính thức cũng liệt kê tính năng vacuum index song song và tự động mở rộng số worker async I/O. Những tính năng này không thay đổi SQL mà API của bạn gửi, nên bài viết sẽ bỏ qua.

ON CONFLICT DO SELECT: get-or-create chỉ với một câu lệnh

Mọi API đều có một endpoint bắt buộc phải trả về một hàng bất kể nó tồn tại hay không: đăng ký thiết bị, tạo thẻ (tag), bắt đầu một phiên thanh toán idempotent. Trước phiên bản 19, bạn chạy SELECT rồi INSERT (và mất race khi tải cao), hoặc viết một câu ON CONFLICT DO UPDATE giả chỉ để RETURNING kích hoạt, điều này vô ích khiến hàng được ghi một phiên bản mới.

PostgreSQL 19 bổ sung hành động xung đột thứ tư. Tài liệu tham khảo INSERT gọi nó là "chèn idempotent hoặc get or create":

INSERT INTO distributors (did, dname) VALUES (11, 'Global Electronics')
    ON CONFLICT (did) DO SELECT
    RETURNING *;
Enter fullscreen mode Exit fullscreen mode

Nếu did = 11 còn trống, hàng được chèn và trả về. Nếu đã có, hàng hiện có được trả về và không có gì bị thay đổi. Ba quy tắc từ tài liệu:

  • Mệnh đề RETURNING là bắt buộc khi dùng DO SELECT.
  • conflict_target là bắt buộc, giống như với DO UPDATE.
  • Ràng buộc exclusion không thể làm trọng tài; hãy dùng unique index hoặc ràng buộc unique kiểu NOT DEFERRABLE.

Sơ đồ luồng của một yêu cầu POST /users sử dụng INSERT ON CONFLICT (email) DO SELECT RETURNING: không xung đột thì chèn và trả về hàng (201), có xung đột thì trả về hàng hiện có không thay đổi (200)

Handler của bạn thường cần biết nhánh nào đã chạy, để có thể trả về 201 Created hoặc 200 OK. Tài liệu ghi chú rằng các giá trị RETURNING cũ là non-NULL khi hàng bị xung đột, nên chỉ cần một cột là đủ để biết:

INSERT INTO users (email, name) VALUES ($1, $2)
    ON CONFLICT (email) DO SELECT
    RETURNING *, (old.id IS NULL) AS created;
Enter fullscreen mode Exit fullscreen mode

Cần khóa hàng hiện có trước khi chạm vào các bảng liên quan? Thêm mệnh đề khóa: ON CONFLICT (did) DO SELECT FOR UPDATE RETURNING *. Bạn cũng có thể lọc với WHERE, ví dụ DO SELECT WHERE d.dname != EXCLUDED.dname, và chỉ những hàng thỏa điều kiện mới được trả về.

Về quyền hạn: DO SELECT cần quyền SELECT trên bảng, và dạng FOR UPDATE/FOR SHARE còn cần quyền UPDATE trên ít nhất một cột.

WAIT FOR LSN: read-your-writes trên replica

Lỗi kinh điển với replica: người dùng lưu hồ sơ của họ, yêu cầu GET tiếp theo trúng một replica bất đồng bộ chưa replay thay đổi, và dữ liệu cũ được trả về. Hầu hết các nhóm phải ghim các thao tác đọc về primary sau khi ghi, điều này làm lãng phí replica.

PostgreSQL 19 bổ sung lệnh WAIT FOR. Sau khi ghi, lấy vị trí WAL của primary:

UPDATE movie SET genre = 'Dramatic' WHERE genre = 'Drama';
SELECT pg_current_wal_insert_lsn();   -- returns 0/0306EE20
Enter fullscreen mode Exit fullscreen mode

Lưu LSN đó vào phiên của người dùng (Simon Willison đề xuất dùng cookie có chữ ký trong bài viết của ông). Ở yêu cầu tiếp theo, chạy lệnh này trên replica trước khi đọc:

WAIT FOR LSN '0/0306EE20' WITH (TIMEOUT '100ms', NO_THROW);
SELECT * FROM movie WHERE genre = 'Drama';
Enter fullscreen mode Exit fullscreen mode

Sơ đồ trình tự: máy chủ API commit một UPDATE trên primary, đọc pg_current_wal_insert_lsn 0/0306EE20, lưu vào phiên, rồi ở yêu cầu tiếp theo gửi WAIT FOR LSN tới replica đọc, nhận thành công, và SELECT hàng mới

Những chi tiết quan trọng trong ngữ cảnh API:

  1. Các chế độ. Mặc định MODE 'standby_replay' chờ đến khi thay đổi được áp dụng, đúng như read-your-writes cần. standby_write, standby_flush và primary_flush tồn tại cho các kiểm tra độ bền dữ liệu.
  2. Timeout. Không có TIMEOUT, hoặc TIMEOUT '0', nó sẽ chờ vĩnh viễn. Luôn đặt timeout trong đường xử lý yêu cầu.
  3. NO_THROW. Không có nó, timeout sẽ gây lỗi và hủy giao dịch của bạn. Có nó, bạn nhận được trạng thái success, timeout hoặc not in recovery, và có thể quay về primary.
  4. Vị trí đặt lệnh. WAIT phải là lệnh cấp cao nhất, không nằm trong hàm hay khối DO. Chạy nó ngoài giao dịch hoặc là câu lệnh đầu tiên, trước bất kỳ thao tác nào chiếm khóa, nếu không nó sẽ bị từ chối.

REPACK (CONCURRENTLY) thay thế VACUUM FULL cho bảng đang hoạt động

Các bảng phía sau những endpoint bận rộn, như sessions hay webhook_deliveries, bị bloat nhanh chóng. VACUUM FULL và CLUSTER giải quyết được nhưng lại khóa bảng. PostgreSQL 19 bổ sung tùy chọn trực tuyến:

REPACK (CONCURRENTLY) webhook_deliveries;
REPACK (CONCURRENTLY, ANALYZE) orders USING INDEX orders_created_at_idx;
Enter fullscreen mode Exit fullscreen mode

Ghi chú phát hành cho biết REPACK (CONCURRENTLY) thu hồi không gian và có thể sắp xếp lại bảng theo một index mà không chặn đọc hay ghi. VACUUM FULL và CLUSTER vẫn còn để tương thích. Theo dõi tiến trình qua view mới pg_stat_progress_repack, và chú ý cài đặt máy chủ mới max_repack_replication_slots khi tinh chỉnh cluster.

Đầu ra JSON từ COPY và các phương thức chuỗi jsonpath mới

Các endpoint xuất dữ liệu thường đẩy các hàng qua mã ứng dụng chỉ để chuyển chúng thành JSON. COPY TO giờ có thể làm việc này ngay trong cơ sở dữ liệu, theo tài liệu tham khảo COPY:

COPY (SELECT * FROM (VALUES(1),(2)) val(id)) TO STDOUT (FORMAT JSON, FORCE_ARRAY);
Enter fullscreen mode Exit fullscreen mode

Lệnh này in [, {"id":1}, ,{"id":2} và ] trên các dòng riêng biệt, nên đầu ra là một mảng JSON hợp lệ. Không có FORCE_ARRAY, bạn nhận một đối tượng JSON mỗi dòng, thân thiện với định dạng NDJSON. SQL NULL trở thành JSON null, và định dạng json chỉ hoạt động với COPY TO.

Cho các cột JSONB, jsonpath bổ sung các phương thức chuỗi: lower(), upper(), initcap(), ltrim(), rtrim(), btrim(), replace() và split_part(). Tài liệu minh họa:

jsonb_path_query('"TOM"', '$.lower()')                  -- "tom"
jsonb_path_query('" hello "', '$.btrim()')              -- "hello"
jsonb_path_query('"abc,def,ghi,jkl"', '$.split_part(",", 3)')  -- "ghi"
Enter fullscreen mode Exit fullscreen mode

Ghi chú phát hành đánh dấu chúng là immutable, và chúng cho phép bạn chuẩn hóa một trường JSONB (trim, viết thường, tách) ngay trong truy vấn thay vì trong handler.

Ngoài ra, json_array() trên không hàng nào giờ trả về [] thay vì NULL, điều này có thể làm hỏng client kiểm tra giá trị null.

Những thay đổi khác của PostgreSQL 19 nhóm API nên biết

  • Kiểm tra khóa ngoại nhanh hơn. Thông báo cho biết chúng giúp chèn hàng loạt gần như nhanh gấp 2 lần trong kiểm thử. Hữu ích cho các endpoint nhập dữ liệu ghi các hàng con.
  • Gợi ý kế hoạch thực thi. Extension pg_plan_advice ghim các lựa chọn của planner, và pg_stash_advice áp dụng gợi ý đó theo query ID, nên bạn có thể sửa một truy vấn bị regression mà không cần deploy lại.
  • UUID và mã hóa. Bạn có thể ép kiểu giữa bytea và uuid, và encode()/decode() hỗ trợ base64url, định dạng an toàn cho URL dùng cho ID trong đường dẫn và token.
  • Nhân bản logic cho việc nâng cấp. CREATE PUBLICATION all_sequences FOR ALL SEQUENCES; đồng bộ các sequence, và FOR ALL TABLES EXCEPT (TABLE users, departments) loại trừ các bảng. Điều này lấp khoảng trống "ID trùng nhau sau khi chuyển đổi" trong di trú blue-green.

Các thay đổi gây đứt gãy cần kiểm tra trước khi nâng cấp

Phần di trú trong ghi chú phát hành liệt kê những thay đổi có thể ảnh hưởng đến API mà không có một truy vấn nào thất bại trên staging:

Thay đổi trong PostgreSQL 19 Cần kiểm tra gì
Mặc định max_locks_per_transaction từ 64 lên 128, và các cài đặt hiện có phải được nhân đôi Giá trị tùy chỉnh trong cấu hình của bạn hoặc parameter group của dịch vụ được quản lý
JIT bị tắt theo mặc định Các endpoint phân tích từng dựa vào JIT cho các truy vấn dài
Nén TOAST mặc định từ pglz sang lz4 Không có gì gãy, nhưng dung lượng lưu trữ và tải CPU thay đổi
standard_conforming_strings bị ép thành on Các bản dump cũ tạo khi nó off sẽ không khôi phục được
Xác thực mật khẩu MD5 ghi log cảnh báo; RADIUS bị loại bỏ Chuyển các role ứng dụng sang SCRAM-SHA-256
json_array() trên không hàng nào trả về [] Các client kiểm tra giá trị null
READ ONLY được truyền xuống postgres_fdw Giao dịch chỉ đọc đã ghi dữ liệu qua một bảng ngoại (foreign table)
log_lock_waits bật theo mặc định Lượng log và nhiễu cảnh báo

Nâng cấp từ bất kỳ phiên bản lớn trước đó vẫn cần pg_upgrade, hoặc dump và khôi phục bằng pg_dumpall, hoặc nhân bản logic. Hãy lên kế hoạch chuyển đổi ngay nếu bạn đang dùng PostgreSQL 14: theo chính sách phiên bản, bản phát hành cuối cùng của nó là ngày 12 tháng 11 năm 2026.

Để agent lập trình của bạn regression-test API sau khi nâng cấp với Apidog CLI

Một lần nâng cấp Postgres lớn hiếm khi làm gãy cú pháp SQL. Nó làm gãy hành vi: một json_array() trả về [], một giới hạn khóa, một kế hoạch thực thi chậm hơn. Hãy phát hiện điều đó bằng cách chạy các kịch bản kiểm thử API của bạn trên một cơ sở dữ liệu staging PostgreSQL 19, xác nhận cả phản hồi HTTP lẫn các hàng dữ liệu phía sau. Để agent lập trình của bạn làm điều đó với Apidog CLI.

npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com   # pick your agent when prompted
Enter fullscreen mode Exit fullscreen mode

Sau đó đưa cho agent của bạn một prompt:

In Apidog project <projectId>, add a test case for POST /users that sends the same
email twice and asserts the first call returns 201 and the second returns 200 with the
same id. Then run test scenario <scenarioId> against the pg19-staging environment with
database assertions, and summarize every failure next to the PostgreSQL 19 change
that could explain it.
Enter fullscreen mode Exit fullscreen mode

Agent sẽ đọc schema payload, xác thực nó, tạo test case, rồi chạy kịch bản với tệp kết nối cơ sở dữ liệu của bạn để các bước database truy cập vào cluster mới:

apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run -t <scenarioId> --project <projectId> -e <envId> \
  --database-connection ./database-connections.json -r cli,junit
Enter fullscreen mode Exit fullscreen mode

Các thao tác cơ sở dữ liệu của Apidog hỗ trợ PostgreSQL trên gói Free, nên bạn có thể truy vấn bảng sau mỗi yêu cầu và xác nhận endpoint get-or-create đã ghi đúng một hàng. Tài liệu hướng dẫn chi tiết về truy vấn cơ sở dữ liệu trong kiểm thử API và chạy kịch bản với kết nối cơ sở dữ liệu từ CLI. Đặt cùng lệnh apidog run ... -r junit vào pipeline CI của bạn và mọi bản phát hành minor sau đó đều được kiểm tra tương tự. Nếu bạn muốn để agent truy vấn Postgres trực tiếp, xem hướng dẫn PostgreSQL MCP server.

Câu hỏi thường gặp

PostgreSQL 19 được phát hành khi nào? Ngày 19 tháng 11 năm 2026. Dự án PostgreSQL hỗ trợ mỗi phiên bản lớn trong 5 năm, nên phiên bản 19 nhận các bản vá cho đến ngày 19 tháng 11 năm 2031.

ON CONFLICT DO SELECT có giống upsert không? Không. DO UPDATE thay đổi hàng hiện có; DO SELECT trả về nó nguyên vẹn. Dùng nó cho get-or-create và POST idempotent. Nó yêu cầu mệnh đề RETURNING và một conflict target.

WAIT FOR LSN có hoạt động trên primary không? Chế độ mặc định standby_replay chỉ hoạt động trên standby đang trong quá trình recovery. Trên primary bạn nhận lỗi, hoặc not in recovery với NO_THROW. Dùng MODE 'primary_flush' nếu bạn cần chờ ngay trên primary.

Có thể nâng cấp tại chỗ từ PostgreSQL 18 lên 19 không? Có, với pg_upgrade. Bạn cũng có thể dump và khôi phục hoặc dùng nhân bản logic, giờ đây nhân bản được sequence với FOR ALL SEQUENCES. Hãy xem lại bảng các thay đổi gây đứt gãy ở trên trước tiên.

PostgreSQL 19 có thay thế pg_repack không? Với hầu hết trường hợp, có. REPACK (CONCURRENTLY) thu hồi bloat và sắp xếp lại bảng theo index mà không chặn đọc hay ghi, và nó đi kèm sẵn trong core.

Top comments (0)