ฟีเจอร์ใหม่ใน 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 ที่มีอยู่จะถูกคืนกลับมาโดยไม่มีอะไรถูกแก้ไข กฎสามข้อจากเอกสาร:
- ต้องมี
RETURNINGเมื่อใช้DO SELECT - ต้องระบุ
conflict_targetเช่นเดียวกับDO UPDATE - Exclusion constraint ใช้เป็น arbiter ไม่ได้ ต้องใช้ unique index หรือ unique constraint แบบ
NOT DEFERRABLE
โดยปกติ 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'; รายละเอียดที่สำคัญสำหรับ API:
- โหมดต่าง ๆ. ค่า default
MODE 'standby_replay'จะรอจนกว่าการเปลี่ยนแปลงถูก apply ซึ่งเป็นสิ่งที่ read-your-writes ต้องการ ส่วนstandby_write,standby_flushและprimary_flushมีไว้สำหรับการตรวจสอบความคงทนของข้อมูล - Timeout. ถ้าไม่ระบุ
TIMEOUTหรือระบุTIMEOUT '0'จะรอตลอดไป ควรตั้งค่าไว้เสมอใน request path -
NO_THROW. ถ้าไม่ระบุ เมื่อ timeout จะ raise error และ abort transaction ของคุณ ถ้าระบุ คุณจะได้สถานะเป็นsuccess,timeoutหรือnot in recoveryและสามารถ fallback ไปที่ primary ได้ - ตำแหน่งการใช้งาน.
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 ควรรู้
- การตรวจสอบ foreign key เร็วขึ้น. ประกาศระบุว่า bulk insert เร็วขึ้นเกือบ 2 เท่าในการทดสอบ มีประโยชน์กับ endpoint import ที่เขียน child rows
- Plan advice. ส่วนขยาย
pg_plan_adviceล็อกการเลือกของ planner และpg_stash_adviceใช้คำแนะนำนั้นตาม query ID ทำให้แก้ query ที่ regress ได้โดยไม่ต้อง redeploy - UUID และ encoding. คุณ cast ระหว่าง
byteaกับuuidได้ และencode()/decode()รองรับbase64urlซึ่งเป็นรูปแบบที่ปลอดภัยกับ URL สำหรับ ID ใน path และ token - Logical replication สำหรับการอัปเกรด.
CREATE PUBLICATION all_sequences FOR ALL SEQUENCES;ซิงค์ sequences และFOR ALL TABLES EXCEPT (TABLE users, departments)ยกเว้นตารางได้ ซึ่งปิดช่องว่าง "ID ชนกันหลัง cutover" ใน migration แบบ blue-green
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 เลย

