Mission map: เปลี่ยนที่เก็บข้อมูล แต่ไม่เปลี่ยนหน้าที่ของ Backend

ก่อนเริ่ม: วันนี้เรากำลังแก้อะไร

Books API เดิมอ่านและเขียนไฟล์ JSON ได้ แต่เมื่อหลาย Request เขียนพร้อมกัน ไฟล์อาจทับกันได้ วันนี้จึงเปลี่ยน เฉพาะที่เก็บข้อมูล เป็น PostgreSQL ส่วน URL, Request และ JSON Response ยังทำงานแบบเดิม

flowchart LR
  A["Postman / Browser\nGET /books/7"] --> B["Express route\nรับ request"]
  B --> C["PostgreSQL\nค้นหา row"]
  C --> D["Express route\nแปลงเป็น JSON"]
  D --> E["Postman / Browser\n200 + book"]

อ่านภาพนี้ให้เป็น

จุด	ข้อมูลที่เข้า	สิ่งที่ทำ	ข้อมูลที่ออก
Client	`GET /books/7`	ขอหนังสือ id 7	HTTP Request
Express route	`req.params.id` = `7`	สร้าง SQL และส่งค่าผ่าน `pg`	SQL + values
PostgreSQL	`SELECT ... WHERE id = $1`	ค้นหา row ใน table	`rows`
Express route	`result.rows[0]`	ส่งเป็น JSON	HTTP Response

คำศัพท์ที่ต้องใช้จริง

books table
┌────┬──────────────────┬────────────────┐
│ id │ title            │ author         │
├────┼──────────────────┼────────────────┤
│  7 │ The Little Prince│ Antoine...     │  ← row หนึ่งแถว
└────┴──────────────────┴────────────────┘
  ↑       ↑                   ↑
column  column              column

Database = กล่องใหญ่ที่เก็บหลาย table เช่น books_db
Table = ตารางหนึ่งเรื่อง เช่น books
Row = ข้อมูลหนึ่งชิ้น เช่นหนังสือหนึ่งเล่ม
Column = คุณสมบัติของข้อมูล เช่น title
Primary key = id ที่ไม่ซ้ำ เพื่อระบุ row ให้ชัด

ลองตอบก่อนเขียนโค้ด

สำหรับ GET /books/7 ให้ชี้ตามลูกศรแล้วตอบ:

Express รับเลข 7 จากตรงไหน? — req.params.id
PostgreSQL ส่งอะไรกลับ? — array ที่ชื่อ rows
ผู้ใช้รู้หรือไม่ว่าเราเปลี่ยนจาก JSON file เป็น PostgreSQL? — ไม่รู้ เพราะยังได้รับ JSON Response แบบเดิม

จำก่อนเปลี่ยนบท