初探 sequelize，在 Node.js 快速建立 Migration、Seeder（ MySQL）
最近在尋找 Node.js 裡面方便操作 Migration、Seeder 的套件，逛著逛著發現 sequelize 在 GitHub 上擁有超高人氣；抱著踩雷的心態來嘗試，於是便寫了這篇 sequelize 的筆記，希望可以幫助到第一次使用 sequelize 的朋友們。
- 我能學到什麼 🤔：sequelize 基礎使用方式。
- 我能學會嗎 🤔：筆者從零開始建立專案，並附上詳細的指令與說明，相信大家都能學得開心。
- 文章目標 🤩：建立一個有使用者（user）、訂單（order）、購買貨物（item）的資料庫，設計 Table 彼此的關連性，透過 Query 確認資料。
大綱一、初始化專案二、透過 Config 建立 DB三、用 Migration 建立 Table四、用 Seeder 建立假資料(Dummy Data)五、簡易 Query
大家也可以直接 Clone 筆者 GitHub 上的專案來了解喔。（如果順便按個 Star更好😀）
ㄧ、初始化專案
STEP 1：建立專案資料夾
mkdir sequelize-demo && cd sequelize-demo
npm initSTEP 2：安裝 sequelize
npm install -g sequelize-cli
npm install --save sequelizeSTEP 3：安裝你想使用的 DB（本篇文章以 MySQL 為範例）
npm install --save mysql2 #本篇文章
npm install --save pg pg-hstore # Postgres
npm install --save mariadb
npm install --save sqlite3
npm install --save tedious # Microsoft SQL Server二、透過 Config 建立 DB
STEP 1：用指令初始化相關設定檔
sequelize initSTEP 2：調整 sequelize 的 config/config.json 檔
預設使用的環境都是development，記得調整成自己的 DB 登入參數
"development": {
"username": "root",
"password": "baobaoverycute",
"database": "sequelize_demo",
"host": "127.0.0.1",
"dialect": "mysql"
},STEP 3：依照剛剛設定的 config/config.json 來建立 DB
sequelize db:create
如果想要移除該 DB，可透過指令：
sequelize db:drop
三、用 Migration 建立 Table
STEP 1：新增所需 Tables & 基礎欄位
根據文章目標，我們需要建立 3 個 Tables：使用者（user）、訂單（order）、購買貨物（item）
sequelize model:generate --name user --attributes name:string,mail:string
sequelize model:generate --name order --attributes user_id:integer,total_price:integer
sequelize model:generate --name item --attributes order_id:integer,price:integer如果沒有填寫「attributes」的參數會無法建立 Table。
STEP 2：前往 migrations 的資料夾，設計 Table 間的關聯性
調整 order Table，建立 user_id 與 user 的關聯性（一個 user 會對應到多筆 order）
user_id: {
type: Sequelize.INTEGER,
references: {
model: 'users',
key: 'id'
},
},調整 item Table，建立 order_id 與 item 的關聯性（一個 order 會對應到多筆 item）
oder_id: {
type: Sequelize.INTEGER,
references: {
model: 'orders',
key: 'id'
},
},STEP 3：修改完成之後，就可以下指令建立剛剛設定的 Table 啦～
sequelize db:migrate
下圖是用 MySQLWorkbench 產生的 ER Diagram
如果想要回溯 migration 可用如下指令：
- 退一個版本：
sequelize db:migrate:undo - 退到初始狀態：
sequelize db:migrate:undo:all - 退到指定版本：
sequelize db:migrate:undo:all --to XXXXXXXXXXXXXX-create-user.js
四、用 Seeder 建立假資料(Dummy Data)
目標：建立 100 個使用者（user），每個使用者有 10 筆訂單（order），每筆訂單下面有 10 個貨物（item）。
STEP 1：先建立 Seeder 檔案
sequelize seed:generate --name demo-user
sequelize seed:generate --name demo-order
sequelize seed:generate --name demo-item
STEP 2：建立各自 Seeder 資料產生的邏輯，下面以 order 舉例：
STEP 3：執行 Seeder
執行單個 Seeder
sequelize db:seed --seed my_seeder_file.js執行全部 Seeder
sequelize db:seed:all
STEP 4：前往 DB ，確認資料是否有正確寫入：
建立 100 個使用者（users）。
建立 100 個使用者（users），每個使用者有 10 筆訂單（orders），共 1000 筆資料。
建立 100 個使用者（users），每個使用者有 10 筆訂單（orders），每筆訂單下面有 10 個貨物（items），共 10000 筆資料。
取消執行的 Seeder 可用如下指令：
- 取消最近的 Seeder：
sequelize db:seed:undo - 取消指定的 Seeder：
sequelize db:seed:undo --seed my_seeder_file.js - 取消全部 Seeder：
sequelize db:seed:undo:all
五、簡易 Query
STEP 1：在專案資料夾下建立一個 row-queries-exmaple.js 的檔案。
STEP 2：將如下程式複製貼上，這是一個簡單 Raw Queries；會找出 price 低於 50 的 5 筆購買貨物，以及對應的使用者。
STEP 3：在終端機輸入：node row-queries-exmaple.js
下圖即可看到看到搜尋結果、程式執行時間。
如果你想要知道 Table Join 時，選擇文字欄位（VARCHAR）與數值欄位（INTEGER）在效能（performance）上的差異，可以參考這篇文章。
▶︎ 如果這篇文章有幫助到你1. 可以點擊下方「Follow」來追蹤我～
2. 可以對文章拍手讓我知道 👏🏻你們的追蹤與鼓勵是我繼續寫作的動力 🙏🏼▶︎ 如果你對工程師的職涯感到迷茫1. 也許我在iT邦幫忙發表的系列文可以給你不一樣的觀點 💡
2. 也歡迎您到書局選購支持，透過豐富的案例來重新檢視自己的職涯
