ฟีเจอร์ใหม่ใน PostgreSQL 19 ที่นักพัฒนา API ต้องรู้

PostgreSQL 19 เพิ่มความสามารถ ON CONFLICT DO SELECT สำหรับ endpoint แบบ get-or-create, ฟีเจอร์ WAIT FOR LSN สำหรับการรับประกันว่าอ่านข้อมูลล่าสุดจาก replica ได้, คำสั่ง REPACK (CONCURRENTLY), การส่งออก JSON จาก COPY และรายการการเปลี่ยนแปลงค่า default ต่างๆ ที่ควรตรวจสอบก่อนอัปเกรด

INEZA Felin-Michel

INEZA Felin-Michel

20 November 2026

ฟีเจอร์ใหม่ใน PostgreSQL 19 ที่นักพัฒนา API ต้องรู้

Apidog สำหรับองค์กร

การติดตั้งแบบ On-Premises

SSO & RBAC

รองรับมาตรฐาน SOC 2

สำรวจ Apidog Enterprise

ฟีเจอร์ใหม่ใน PostgreSQL 19 ที่สำคัญที่สุดสำหรับนักพัฒนา API: INSERT ... ON CONFLICT DO SELECT สำหรับสร้าง endpoint แบบ get-or-create ด้วยคำสั่งเดียว, WAIT FOR LSN สำหรับ read-your-writes บน replica, REPACK (CONCURRENTLY) สำหรับล้าง bloat แบบออนไลน์, เอาต์พุต JSON จาก COPY, เมธอดสตริงใหม่ใน jsonpath และการตรวจสอบ foreign key ที่เร็วขึ้นเมื่อ bulk insert

คู่มือนี้ครอบคลุมสิ่งที่เปลี่ยนแปลงใน handlers, replicas และแผนการอัปเกรดของคุณ ตัวอย่าง syntax ทุกตัวมาจาก PostgreSQL 19 release notes และหน้าเอกสารอ้างอิง

สรุปสิ่งใหม่ใน PostgreSQL 19 อย่างคร่าว ๆ

PostgreSQL 19 คือ major release ประจำปีของฐานข้อมูล open source ซึ่งประกาศโดย PostgreSQL Global Development Group เมื่อวันที่ 19 พฤศจิกายน 2026 มาพร้อมการ insert แบบ get-or-create, การรอบน replica สำหรับ read-your-writes, การ repack ตารางแบบออนไลน์, plan advice และ logical replication ของ sequences พร้อมทั้งเปลี่ยนค่า default หลายอย่างที่คุณควรตรวจสอบก่อนอัปเกรด

ฟีเจอร์ แทนที่อะไร รู้สึกได้ตรงไหน
ON CONFLICT DO SELECT Retry loop แบบ SELECT แล้วค่อย INSERT Endpoint POST แบบ idempotent และ endpoint สมัครสมาชิก
WAIT FOR LSN การ sticky routing ของ read ไปที่ primary Read replicas ที่อยู่หลัง API
REPACK (CONCURRENTLY) VACUUM FULL, CLUSTER, pg_repack ตารางที่ใช้งานหนักจน bloat โดยไม่ต้องหยุดให้บริการ
COPY ... (FORMAT json) การแปลง row เป็น JSON ใน app code Endpoint export และ bulk download
เมธอดสตริงของ jsonpath การ post-process JSONB ใน app code การกรองและ normalize คอลัมน์ JSON
pg_plan_advice + pg_stash_advice การเขียน query ใหม่เพื่อชี้นำ planner ปัญหา plan regression ใน production
Publications แบบ FOR ALL SEQUENCES การรีเซ็ต sequence ด้วยตนเองหลัง cutover การอัปเกรดแบบ blue-green ผ่าน logical replication

ประกาศอย่างเป็นทางการ ยังระบุถึงการ vacuum index แบบขนานและ async I/O workers ที่ปรับขนาดอัตโนมัติด้วย ซึ่งไม่ได้เปลี่ยน SQL ที่ API ของคุณส่ง จึงจะไม่พูดถึงในบทความนี้

ON CONFLICT DO SELECT: get-or-create ด้วยคำสั่งเดียว

ทุก API ต้องมี endpoint ที่ต้องคืนค่า row ไม่ว่าจะมีอยู่แล้วหรือยัง: ลงทะเบียนอุปกรณ์, สร้างแท็ก, เริ่ม checkout แบบ idempotent ก่อนเวอร์ชัน 19 คุณต้องรัน SELECT แล้วตามด้วย INSERT (ซึ่งแพ้การแข่งขันเมื่อโหลดสูง) หรือเขียน ON CONFLICT DO UPDATE ปลอม ๆ เพื่อให้ RETURNING ทำงาน ซึ่งเขียน row เวอร์ชันใหม่โดยไม่จำเป็น

PostgreSQL 19 เพิ่ม conflict action แบบที่สี่ เอกสารอ้างอิง INSERT เรียกมันว่า "idempotent insert or get or create":

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

ถ้า did = 11 ยังว่าง row จะถูก insert และคืนค่ากลับมา ถ้าถูกใช้ไปแล้ว row ที่มีอยู่จะถูกคืนกลับมาโดยไม่มีอะไรถูกแก้ไข กฎสามข้อจากเอกสาร:

Flowchart of a POST /users request using INSERT ON CONFLICT (email) DO SELECT RETURNING: no conflict inserts and returns the row (201), a conflict returns the existing row unmodified (200)

โดยปกติ handler ของคุณจำเป็นต้องรู้ว่าเกิด branch ไหนขึ้น เพื่อจะตอบกลับเป็น 201 Created หรือ 200 OK เอกสารระบุว่าค่า old ใน RETURNING จะไม่เป็น NULL เมื่อเกิด conflict ขึ้น ดังนั้นคอลัมน์เดียวก็บอกได้:

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

ต้องล็อก row ที่มีอยู่ก่อนแตะตารางอื่นที่เกี่ยวข้อง? เพิ่ม locking clause: ON CONFLICT (did) DO SELECT FOR UPDATE RETURNING * คุณยังกรองด้วย WHERE ได้ เช่น DO SELECT WHERE d.dname != EXCLUDED.dname โดยจะมีเฉพาะ row ที่ผ่านเงื่อนไขเท่านั้นที่ถูกคืนค่า

สิทธิ์การเข้าถึง: DO SELECT ต้องการสิทธิ์ SELECT บนตาราง และรูปแบบ FOR UPDATE/FOR SHARE ยังต้องการสิทธิ์ UPDATE บนคอลัมน์อย่างน้อยหนึ่งคอลัมน์ด้วย

WAIT FOR LSN: read-your-writes บน replica

บั๊กคลาสสิกของ replica: ผู้ใช้บันทึกโปรไฟล์ แล้ว GET ครั้งถัดไปดันไปโดน replica แบบ async ที่ยังไม่ได้ replay การเปลี่ยนแปลง ทำให้ได้ข้อมูลเก่ากลับมา ทีมส่วนใหญ่จะ pin read ไปที่ primary หลังการเขียน ซึ่งเป็นการเปลือง replica

PostgreSQL 19 เพิ่ม คำสั่ง WAIT FOR หลังการเขียน ให้ดึงตำแหน่ง WAL ของ primary มา:

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

เก็บ LSN นั้นไว้ใน session ของผู้ใช้ (Simon Willison แนะนำให้ใช้ signed cookie ใน บทความของเขา) ใน request ถัดไป รันคำสั่งนี้บน replica ก่อนการอ่าน:

WAIT FOR LSN '0/0306EE20' WITH (TIMEOUT '100ms', NO_THROW);
SELECT * FROM movie WHERE genre = 'Drama';
Sequence diagram: API server commits an UPDATE on the primary, reads pg_current_wal_insert_lsn 0/0306EE20, stores it in the session, then on the next request sends WAIT FOR LSN to the read replica, gets success, and SELECTs the fresh row

รายละเอียดที่สำคัญสำหรับ API:

  1. โหมดต่าง ๆ. ค่า default MODE 'standby_replay' จะรอจนกว่าการเปลี่ยนแปลงถูก apply ซึ่งเป็นสิ่งที่ read-your-writes ต้องการ ส่วน standby_write, standby_flush และ primary_flush มีไว้สำหรับการตรวจสอบความคงทนของข้อมูล
  2. Timeout. ถ้าไม่ระบุ TIMEOUT หรือระบุ TIMEOUT '0' จะรอตลอดไป ควรตั้งค่าไว้เสมอใน request path
  3. NO_THROW. ถ้าไม่ระบุ เมื่อ timeout จะ raise error และ abort transaction ของคุณ ถ้าระบุ คุณจะได้สถานะเป็น success, timeout หรือ not in recovery และสามารถ fallback ไปที่ primary ได้
  4. ตำแหน่งการใช้งาน. WAIT ต้องเป็นคำสั่งระดับบนสุด ไม่ใช่อยู่ในฟังก์ชันหรือบล็อก DO ให้รันนอก transaction หรือเป็นคำสั่งแรกของ transaction ก่อนคำสั่งใด ๆ ที่ล็อกทรัพยากร มิฉะนั้นจะถูกปฏิเสธ

REPACK (CONCURRENTLY) แทนที่ VACUUM FULL สำหรับตารางที่ใช้งานอยู่

ตารางที่อยู่หลัง endpoint ที่ใช้งานหนัก เช่น sessions หรือ webhook_deliveries จะ bloat เร็วมาก VACUUM FULL และ CLUSTER แก้ปัญหาได้แต่จะล็อกตาราง PostgreSQL 19 เพิ่มตัวเลือกแบบออนไลน์:

REPACK (CONCURRENTLY) webhook_deliveries;
REPACK (CONCURRENTLY, ANALYZE) orders USING INDEX orders_created_at_idx;

Release notes ระบุว่า REPACK (CONCURRENTLY) คืนพื้นที่และจัดเรียงตารางตาม index ได้โดยไม่ block การอ่านหรือเขียน VACUUM FULL และ CLUSTER ยังอยู่เพื่อความเข้ากันได้ ติดตามความคืบหน้าได้ใน view ใหม่ pg_stat_progress_repack และดูการตั้งค่า server ใหม่ max_repack_replication_slots เมื่อคุณปรับแต่ง cluster

เอาต์พุต JSON จาก COPY และเมธอดสตริงใหม่ใน jsonpath

Endpoint แบบ export มักสตรีม row ผ่าน app code แค่เพื่อแปลงเป็น JSON ตอนนี้ COPY TO ทำได้ในฐานข้อมูลเลย ตามเอกสารอ้างอิง COPY:

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

คำสั่งนี้จะพิมพ์ [, {"id":1}, ,{"id":2} และ ] แยกบรรทัดกัน ทำให้ผลลัพธ์เป็น JSON array ที่ถูกต้องหนึ่งชุด ถ้าไม่ใส่ FORCE_ARRAY คุณจะได้ JSON object หนึ่งตัวต่อบรรทัด ซึ่งเข้ากันได้กับ NDJSON SQL NULL จะกลายเป็น JSON null และรูปแบบ json ใช้ได้กับ COPY TO เท่านั้น

สำหรับคอลัมน์ JSONB jsonpath เพิ่มเมธอดสตริง: lower(), upper(), initcap(), ltrim(), rtrim(), btrim(), replace() และ split_part() เอกสารแสดงตัวอย่าง:

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

Release notes ระบุว่าเมธอดเหล่านี้เป็น immutable และช่วยให้คุณ normalize ฟิลด์ JSONB (trim, lowercase, split) ได้ใน query เอง โดยไม่ต้องทำใน handler

นอกจากนี้ json_array() เมื่อไม่มี row เลยจะคืนค่า [] แทน NULL แล้ว ซึ่งอาจทำให้ client ที่เช็คค่า null พังได้

การเปลี่ยนแปลงอื่น ๆ ใน PostgreSQL 19 ที่ทีม API ควรรู้

Breaking changes ที่ต้องตรวจสอบก่อนอัปเกรด

ส่วน migration ใน release notes ระบุการเปลี่ยนแปลงที่อาจกระทบ API โดยไม่มี query เดียวที่ fail ใน staging:

การเปลี่ยนแปลงใน PostgreSQL 19 สิ่งที่ต้องตรวจสอบ
max_locks_per_transaction default เปลี่ยนจาก 64 เป็น 128 และค่าที่ตั้งไว้แล้วต้องเพิ่มเป็นสองเท่า ค่า custom ใน config ของคุณหรือ parameter group ของ managed service
JIT ถูกปิดเป็นค่า default Endpoint analytics ที่พึ่งพา JIT สำหรับ query ที่รันนาน
TOAST compression default เปลี่ยนจาก pglz เป็น lz4 ไม่มีอะไรพัง แต่โปรไฟล์ storage และ CPU เปลี่ยน
standard_conforming_strings ถูกบังคับเป็น on Dump เก่าที่ทำตอนตั้งค่าเป็น off จะ restore ไม่ได้
การยืนยันตัวตนด้วยรหัสผ่าน MD5 จะ log เตือน; RADIUS ถูกถอดออก ย้าย app roles ไปใช้ SCRAM-SHA-256
json_array() บน zero rows คืนค่า [] Client ที่เช็คค่า null
READ ONLY ถูกส่งต่อไปยัง postgres_fdw Transaction แบบ read-only ที่เขียนผ่าน foreign table
log_lock_waits เปิดเป็นค่า default ปริมาณ log และ alert ที่รบกวน

การอัปเกรดจาก major version ก่อนหน้ายังต้องใช้ pg_upgrade, การ dump และ restore ด้วย pg_dumpall หรือ logical replication วางแผนการย้ายไว้ตอนนี้เลยถ้าคุณยังใช้ PostgreSQL 14 อยู่: ตามนโยบายเวอร์ชัน release สุดท้ายของมันคือวันที่ 12 พฤศจิกายน 2026

ให้ coding agent ของคุณ regression test API หลังอัปเกรดด้วย Apidog CLI

การอัปเกรด Postgres ครั้งใหญ่มักไม่ได้ทำให้ SQL syntax พัง แต่ทำให้พฤติกรรมพัง: json_array() ที่คืนค่า [], ขีดจำกัด lock, plan ที่ช้าลง ให้จับปัญหาเหล่านี้โดยรัน test scenario ของ API ของคุณกับฐานข้อมูล PostgreSQL 19 ใน staging โดย assert ทั้ง HTTP response และ row ที่อยู่เบื้องหลัง ให้ coding agent ของคุณทำผ่าน 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

จากนั้นสั่ง agent ของคุณด้วย 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.

Agent จะอ่าน payload schema, ตรวจสอบความถูกต้อง, สร้าง test case แล้วรัน scenario ด้วยไฟล์ database connection ของคุณ เพื่อให้ database steps ยิงไปที่ cluster ใหม่:

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

Apidog รองรับ database operations สำหรับ PostgreSQL ในแผน Free คุณจึง query ตารางหลังแต่ละ request ได้ และ assert ว่า endpoint get-or-create เขียน row ลงไปเพียงหนึ่งแถวเท่านั้น เอกสารมีคู่มือเกี่ยวกับdatabase queries ใน API tests และการรัน scenario ด้วย database connections ผ่าน CLI ใส่คำสั่ง apidog run ... -r junit เดิมลงในCI pipeline ของคุณ แล้ว minor release ทุกครั้งถัดไปจะได้รับการตรวจสอบแบบเดียวกัน ถ้าคุณอยากให้ agent query Postgres โดยตรง ดูที่คู่มือ PostgreSQL MCP server

คำถามที่พบบ่อย

PostgreSQL 19 ปล่อยเมื่อไหร่? 19 พฤศจิกายน 2026 โปรเจกต์ PostgreSQL รองรับ major version แต่ละตัวนาน 5 ปี เวอร์ชัน 19 จึงได้รับการแก้ไขจนถึงวันที่ 19 พฤศจิกายน 2031

ON CONFLICT DO SELECT เหมือน upsert หรือไม่? ไม่ DO UPDATE จะแก้ไข row ที่มีอยู่ ส่วน DO SELECT จะคืนค่ามาโดยไม่แตะต้อง ใช้สำหรับ get-or-create และ POST แบบ idempotent ต้องมี RETURNING และ conflict target

WAIT FOR LSN ใช้บน primary ได้ไหม? โหมด default standby_replay ใช้ได้เฉพาะบน standby ระหว่าง recovery เท่านั้น บน primary คุณจะได้ error หรือได้ not in recovery ถ้าใช้ NO_THROW ใช้ MODE 'primary_flush' ถ้าต้องรอบน primary ตัวมันเอง

อัปเกรดจาก PostgreSQL 18 เป็น 19 แบบ in-place ได้ไหม? ได้ ด้วย pg_upgrade คุณยังเลือก dump แล้ว restore หรือใช้ logical replication ซึ่งตอนนี้ replicate sequences ได้ด้วย FOR ALL SEQUENCES แต่ควรทบทวนตาราง breaking changes ด้านบนก่อน

PostgreSQL 19 แทนที่ pg_repack ได้ไหม? ในกรณีส่วนใหญ่ ได้ REPACK (CONCURRENTLY) คืนพื้นที่จาก bloat และจัดเรียงตารางตาม index โดยไม่ block การอ่านหรือเขียน และมาพร้อมกับ core เลย

ฝึกการออกแบบ API แบบ Design-first ใน Apidog

ค้นพบวิธีที่ง่ายขึ้นในการสร้างและใช้ API