🟠 Laravel

คู่มือ Database Migration สำหรับมือใหม่: จัดการฐานข้อมูลอย่างมืออาชีพด้วยโค้ด

7 นาที 17 views บันทึกเป็น PDF
คู่มือ Database Migration สำหรับมือใหม่: จัดการฐานข้อมูลอย่างมืออาชีพด้วยโค้ด

เรียนรู้วิธีจัดการฐานข้อมูลด้วย Database Migration เปลี่ยนโครงสร้างตารางให้เป็นระบบด้วยฟังก์ชัน up/down พร้อมวิธีเชื่อมต่อ MySQL และ SQLite อย่างถูกต้อง

ทำความเข้าใจ Database Migration: ทำไมเราต้องจัดการฐานข้อมูลด้วยโค้ด?

ในการเขียนโปรแกรม Database Migration (การปรับปรุงโครงสร้างฐานข้อมูลด้วยชุดคำสั่ง) คือเครื่องมือสำคัญที่ช่วยให้เราจัดการกับ Database Schema (โครงสร้างหรือพิมพ์เขียวของฐานข้อมูล) ได้อย่างเป็นระบบ เปรียบเสมือนการจดบันทึกการเปลี่ยนแปลงของบ้านที่คุณสร้าง ถ้าคุณต้องการทุบผนังห้องหรือเพิ่มประตู คุณต้องมี "แบบแปลน" ที่บันทึกไว้ว่าคุณทำอะไรไปบ้าง เพื่อให้เพื่อนร่วมทีมหรือตัวคุณเองในอนาคตเข้าใจตรงกัน

หากเราไม่ใช้ Migration เรามักจะเผลอไปกดแก้ไขตารางในฐานข้อมูลโดยตรงผ่านโปรแกรมจัดการ ซึ่งจะทำให้เราจำไม่ได้ว่าเคยเพิ่มคอลัมน์อะไรไปบ้าง หรือถ้าต้องย้ายโปรเจกต์ไปรันบนเครื่องอื่น เราก็ต้องมานั่งสร้างตารางใหม่ด้วยมือทั้งหมด การทำ Migration จึงเป็นการเปลี่ยนสถานะของฐานข้อมูลให้กลายเป็น Version Control (ระบบควบคุมเวอร์ชัน) เหมือนกับที่เราใช้ Git เก็บประวัติโค้ดนั่นเอง

หัวใจสำคัญของ Migration คือฟังก์ชัน up() และ down() โดยที่ up() คือคำสั่งที่ใช้สร้างหรือเปลี่ยนแปลงโครงสร้าง (เช่น เพิ่มตาราง) ส่วน down() คือคำสั่ง "ย้อนกลับ" ที่ใช้ยกเลิกการเปลี่ยนแปลงนั้น (เช่น ลบตารางที่สร้างขึ้นมา) หากเกิดข้อผิดพลาดขึ้นระหว่างการอัปเดต คุณจะสามารถย้อนกลับไปจุดที่ปลอดภัยได้ทันที

การเชื่อมต่อฐานข้อมูล: MySQL vs SQLite

ก่อนจะเริ่มทำ Migration เราต้องเชื่อมต่อโปรเจกต์ของเราเข้ากับฐานข้อมูลก่อน โดย MySQL (ระบบฐานข้อมูลยอดนิยมสำหรับงานระดับองค์กร) และ SQLite (ฐานข้อมูลขนาดเล็กที่เก็บเป็นไฟล์เดียว) เป็นสองตัวเลือกที่มือใหม่ใช้บ่อยที่สุด การเชื่อมต่อจะผ่านสิ่งที่เรียกว่า Connection String (ชุดข้อความกำหนดเส้นทางเข้าสู่ฐานข้อมูล) ซึ่งบอกโปรแกรมว่าฐานข้อมูลอยู่ที่ไหนและใช้รหัสผ่านอะไร

สำหรับการฝึกฝน ผมแนะนำให้เริ่มจาก SQLite เพราะไม่ต้องติดตั้งเซิร์ฟเวอร์แยก เพียงแค่ระบุชื่อไฟล์ในโค้ดก็ใช้งานได้ทันที ส่วน MySQL จะเหมาะกับโปรเจกต์ที่ใหญ่ขึ้นและต้องการรองรับผู้ใช้งานจำนวนมากพร้อมกัน ซึ่งคุณจะต้องติดตั้ง MySQL Server ไว้ในเครื่องหรือใช้ Docker (เครื่องมือจำลองสภาพแวดล้อมเสมือน) เพื่อรันฐานข้อมูล

จุดที่มือใหม่มักพลาดคือการลืมเก็บรหัสผ่านฐานข้อมูลไว้ในไฟล์ Environment Variable (ไฟล์เก็บค่าตั้งค่าสำคัญที่ห้ามอัปโหลดขึ้น Git) ทำให้ข้อมูลความปลอดภัยรั่วไหล คุณควรสร้างไฟล์ชื่อ .env เพื่อเก็บข้อมูลการเชื่อมต่อแทนการเขียนรหัสผ่านลงไปในโค้ดโดยตรง

// ตัวอย่างการเชื่อมต่อด้วย SQLite ใน Node.js
const sqlite3 = require('sqlite3').verbose();
const db = new sqlite3.Database('./my-database.db'); // สร้างไฟล์ฐานข้อมูลในโปรเจกต์

// ตรวจสอบการเชื่อมต่อ
db.serialize(() => {
  console.log("เชื่อมต่อฐานข้อมูลสำเร็จ!");
});

การเขียน Migration File: ก้าวแรกสู่การจัดการโครงสร้างข้อมูล

การสร้างไฟล์ Migration มักมาพร้อมกับคำสั่งจากเครื่องมือที่คุณใช้ เช่น Knex.js หรือ Prisma คำสั่งเหล่านี้จะสร้างไฟล์ที่มีชื่อและเวลา (Timestamp) กำกับไว้เพื่อให้เรียงลำดับการทำงานได้ถูกต้อง ภายในไฟล์จะมีโครงสร้างหลักคือฟังก์ชัน up และ down ที่เราต้องเขียนคำสั่ง SQL ลงไป

นี่คือตัวอย่างการเขียน Migration เพื่อสร้างตารางผู้ใช้งาน โดยใช้ฟังก์ชัน up ในการสร้าง และ down ในการลบตารางทิ้งเมื่อต้องการย้อนกลับ

// โครงสร้าง Migration แบบง่าย
exports.up = function(knex) {
  return knex.schema.createTable('users', (table) => {
    table.increments('id'); // สร้างคอลัมน์ id อัตโนมัติ
    table.string('username'); // เพิ่มคอลัมน์ชื่อผู้ใช้
  });
};

exports.down = function(knex) {
  return knex.schema.dropTable('users'); // ลบตารางทิ้งเมื่อสั่งย้อนกลับ
};

ข้อควรระวัง: ห้ามแก้ไขไฟล์ Migration ที่ถูกสั่ง Migrate (ประมวลผลคำสั่งในฐานข้อมูล) ไปแล้วเด็ดขาด หากคุณเปลี่ยนใจอยากเปลี่ยนชื่อคอลัมน์ ให้สร้างไฟล์ Migration ใหม่ขึ้นมาจัดการแทน เพื่อป้องกันข้อมูลในฐานข้อมูลเดิมเสียหาย

การสั่ง Migrate และการตรวจสอบผลลัพธ์

เมื่อเขียนคำสั่งในไฟล์เสร็จแล้ว ขั้นตอนต่อมาคือการสั่ง Migrate เพื่อบอกให้โปรแกรมนำโครงสร้างที่เราเขียนไว้ไปสร้างจริงในฐานข้อมูล เครื่องมือเหล่านี้จะเก็บประวัติว่าไฟล์ไหนถูกรันไปแล้วบ้างในตารางพิเศษที่ชื่อว่า migrations ทำให้มันไม่รันไฟล์เดิมซ้ำให้เกิดข้อผิดพลาด

คำสั่งที่ใช้บ่อยคือ migrate:latest สำหรับการอัปเดตฐานข้อมูลให้เป็นเวอร์ชันล่าสุด และ migrate:rollback สำหรับการย้อนกลับการเปลี่ยนแปลงล่าสุด หากคุณรันคำสั่งแล้วพบข้อความ Error ให้เช็คที่ Syntax (ไวยากรณ์หรือรูปแบบคำสั่ง) ของ SQL หรือเช็คว่าไฟล์เชื่อมต่อฐานข้อมูลถูกต้องหรือไม่

  1. รันคำสั่งสร้างไฟล์ Migration: npx knex migrate:make create_users
  2. เขียนโค้ด up และ down ตามตัวอย่างข้างต้น
  3. สั่ง Migrate เพื่อนำไปใช้: npx knex migrate:latest
  4. ตรวจสอบในเครื่องมือจัดการฐานข้อมูล (เช่น TablePlus) ว่ามีตาราง users ปรากฏขึ้นมาแล้วหรือไม่

สรุป: เปลี่ยนจากมือสมัครเล่นเป็นโปรมืออาชีพด้วย Migration

การเข้าใจเรื่อง Migration จะช่วยให้คุณทำงานร่วมกับทีมได้อย่างมืออาชีพ เพราะทุกคนในทีมจะใช้โครงสร้างฐานข้อมูลชุดเดียวกันเสมอ หากเพื่อนในทีมเพิ่มตารางใหม่ คุณเพียงแค่สั่ง migrate:latest ในเครื่องคุณ โครงสร้างฐานข้อมูลของคุณก็จะอัปเดตตามทันทีโดยไม่ต้องไปไล่สร้างตารางเองให้เสียเวลา

ตัวอย่างการนำไปใช้จริง: สมมติว่าคุณกำลังทำโปรเจกต์แอปพลิเคชันจัดการรายการสิ่งที่ต้องทำ (To-Do List) เมื่อคุณต้องการเพิ่มฟีเจอร์ "วันครบกำหนด" ให้กับรายการ คุณไม่ต้องไปลบฐานข้อมูลทิ้งแล้วสร้างใหม่ แต่ให้คุณสร้างไฟล์ Migration ใหม่ที่มีคำสั่งเพิ่มคอลัมน์ due_date ลงไปในตารางเดิม วิธีนี้จะช่วยให้ข้อมูลเดิมของคุณยังคงอยู่ครบถ้วนและโปรเจกต์ของคุณก็เติบโตไปพร้อมกับฟีเจอร์ใหม่ ๆ ได้อย่างราบรื่น วินัยในการจัดการ Migration ตั้งแต่วันแรกคือสิ่งที่แยกโปรแกรมเมอร์มืออาชีพออกจากมือสมัครเล่นครับ

แชร์บทความ

Facebook X LINE

บทความที่เกี่ยวข้อง

คู่มือ Laravel Optimization และการเตรียมโปรเจกต์ขึ้น Production สำหรับมือใหม่
Laravel

คู่มือ Laravel Optimization และการเตรียมโปรเจกต์ขึ้น Production สำหรับมือใหม่

เรียนรู้วิธีทำ Laravel Optimization, การ Cache Config และ Route เพื่อเพิ่มความเร็วเว็บไซต์ พร้อมขั้นตอนการเตรียมโปรเจกต์และ Deploy ขึ้นเซิร์ฟเวอร์อย่างมืออาชีพ

1 month ago 8 นาที
26 views
สอนสร้างเว็บด้วย Laravel 13: Workshop ทำระบบ CRUD ตั้งแต่เริ่มต้นจนใช้งานได้จริง
Laravel

สอนสร้างเว็บด้วย Laravel 13: Workshop ทำระบบ CRUD ตั้งแต่เริ่มต้นจนใช้งานได้จริง

เรียนรู้การพัฒนาเว็บแอปพลิเคชันด้วย Laravel 13 ตั้งแต่การออกแบบฐานข้อมูล Migration ไปจนถึงการจัดการ Logic ด้วย MVC สำหรับมือใหม่ที่อยากเป็นโปรแกรมเมอร์มืออาชีพ

1 month ago 10 นาที
21 views
คู่มือการใช้งาน Session, Flash Messages และ Notifications ใน Laravel สำหรับมือใหม่
Laravel

คู่มือการใช้งาน Session, Flash Messages และ Notifications ใน Laravel สำหรับมือใหม่

เรียนรู้การจัดการ Session ใน Laravel ตั้งแต่พื้นฐานการเก็บข้อมูลชั่วคราว การทำ Flash Messages แจ้งเตือนผู้ใช้ ไปจนถึงการใช้ระบบ Notifications แบบมืออาชีพ

1 month ago 10 นาที
26 views