Chuyển đổi JSON thành Sequelize (JavaScript)!

Nhập JSON và chuyển đổi nó thành Sequelize (JavaScript)! Hỗ trợ Sequelize sequelize.define, DataTypes, Node.js, Express.
JSON
Kết quả
 

Chuyển đổi JSON thành Sequelize (JavaScript)!

Chuyển các dòng JSON thành model Sequelize định nghĩa bằng sequelize.define(). Mỗi cột nhận một kiểu DataTypes và cờ allowNull, và file CommonJS có sẵn khóa chính id, tableName và timestamps: false.

Nó hợp với server Express chạy MySQL hoặc PostgreSQL khi bạn đã có dòng mẫu của một bảng (bảng tính export ra JSON, response của API bên ngoài) nhưng chưa có định nghĩa model.

Cách sử dụng

  1. Dán một dòng dưới dạng object hoặc nhiều dòng dưới dạng mảng. Nếu có cột trống ở một số dòng, hãy dán nhiều dòng để allowNull ra đúng.
  2. Nhập Tên model (mặc định MyModel); tên này được dùng cả trong define lẫn làm biến được export.
  3. Output giả định require('../db') trả về instance Sequelize của bạn. Hãy chỉnh đường dẫn đó cho khớp module kết nối, rồi lưu file trong models/.

Ví dụ

Đầu vào (JSON)
[
  { "email": "kim@example.com", "nickname": "kim", "age": 31, "marketing_opt_in": true, "joined_at": "2023-11-02" },
  { "email": "ana@example.com", "nickname": "ana", "age": null, "marketing_opt_in": false, "joined_at": "2024-01-15" }
]
Đầu ra (Sequelize (JavaScript))
const { Sequelize, DataTypes } = require('sequelize');
const sequelize = require('../db');

const Member = sequelize.define('Member', {
  id: {
    type: DataTypes.INTEGER,
    autoIncrement: true,
    primaryKey: true
  },
  email: {
    type: DataTypes.STRING,
    allowNull: false
  },
  nickname: {
    type: DataTypes.STRING,
    allowNull: false
  },
  age: {
    type: DataTypes.INTEGER,
    allowNull: true
  },
  marketingOptIn: {
    type: DataTypes.BOOLEAN,
    allowNull: false,
    field: 'marketing_opt_in'
  },
  joinedAt: {
    type: DataTypes.DATEONLY,
    allowNull: false,
    field: 'joined_at'
  }
}, {
  tableName: 'MEMBER',
  timestamps: false
});

module.exports = Member;

age của thành viên thứ hai là null, nên chỉ age nhận allowNull: true. joined_at chứa ngày không có giờ nên thành DataTypes.DATEONLY, và attribute joinedAt được gắn lại với cột thật bằng field: 'joined_at'.

Tính năng hỗ trợ

  • Kiểu cột: số nguyên → INTEGER (BIGINT khi vượt 2,147,483,647), số thập phân → DOUBLE, boolean → BOOLEAN, YYYY-MM-DD → DATEONLY, ngày giờ → DATE, object và mảng → JSON, chuỗi khác → STRING.
  • Chỉ số JSON thật mới thành cột số; "01234" trong dấu nháy vẫn là STRING.
  • Attribute là camelCase, và mỗi khi khác với key, field: 'marketing_opt_in' ánh xạ attribute về tên cột gốc.
  • Key id trong JSON thành khóa chính thay vì một cột thứ hai: số nguyên nhận autoIncrement, chuỗi như UUID thành khóa STRING thông thường. Nếu không có, một id INTEGER tự tăng được thêm vào.
  • Giá trị null hoặc thiếu ở bất kỳ dòng nào đặt allowNull: true; chúng không ảnh hưởng tới kiểu cột.
  • Model tên UserProfile nhận tableName: 'USER_PROFILE' và timestamps: false, nên không cần cột createdAt/updatedAt.

Trường hợp sử dụng

Gắn model vào bảng có sẵn

Export kết quả SELECT ... LIMIT 5 từ DB client ra JSON rồi dán vào để có code define đã phản ánh thứ tự cột, khả năng null và tên cột snake_case. Tiện khi cần ánh xạ một bảng mà không phải cài sequelize-auto.

Tạo bảng thử nghiệm bằng `sequelize.sync()`

Khi làm prototype, dựng model từ JSON mẫu, chạy sync() để tạo bảng trong SQLite hay MySQL cục bộ, rồi nạp seed data bằng bulkCreate.

Lưu ý và giới hạn

  • DataTypes.STRING mặc định là VARCHAR(255); hãy đổi văn bản dài sang DataTypes.TEXT.
  • Giá trị DATEONLY trả về dạng chuỗi '2023-11-02', không phải object Date.
  • DataTypes.JSON chạy trên MySQL, MariaDB, PostgreSQL và SQLite nhưng không chạy trên MSSQL; trên PostgreSQL, DataTypes.JSONB thường là lựa chọn tốt hơn.
  • tableName viết hoa (MEMBER). Trên môi trường phân biệt hoa/thường như PostgreSQL hay MySQL trên Linux, nó phải khớp chính xác với tên bảng thật.
  • Với tiền tệ, hãy thay DOUBLE bằng DataTypes.DECIMAL(12, 2) để tránh lỗi làm tròn số thực.

Câu hỏi thường gặp

Có lấy được kiểu Model.init() dựa trên class không?

Trang này chỉ tạo sequelize.define(). Object attribute giống hệt nhau ở cả hai kiểu, nên hãy khai báo class Member extends Model {} và truyền cùng object đó vào Member.init(attributes, { sequelize, tableName: 'MEMBER' }). Với TypeScript, hãy dùng trang JSON → Sequelize (TS).

Cột là allowNull: false nhưng chuỗi rỗng vẫn lọt vào.

allowNull chỉ chặn NULL của SQL. Để từ chối cả chuỗi rỗng, hãy thêm validate: { notEmpty: true } vào attribute.

Vì sao dùng field trên từng attribute thay vì underscored: true?

underscored chỉ chuyển camelCase sang snake_case, nên không ánh xạ được key như home-url hay cột vốn đã là camelCase. field tường minh giữ đúng key JSON làm tên cột bất kể nó theo kiểu nào.