将 JSON 转换为 Sequelize(JavaScript)方案!

输入 JSON 并将其转换为 Sequelize(JavaScript)方案!支持 Sequelize sequelize.define, DataTypes, Node.js, Express。
JSON
结果
 

将 JSON 转换为 Sequelize(JavaScript)方案!

把 JSON 行数据转换成用 sequelize.define() 定义的 Sequelize 模型。每一列都会得到 DataTypes 类型和 allowNull 标志,生成的 CommonJS 文件包含 id 主键、tableName 和 timestamps: false。

适合运行在 MySQL 或 PostgreSQL 上的 Express 服务器:手头有某张表的示例行(导出为 JSON 的电子表格、外部 API 的响应),却还没有模型定义。

使用方法

  1. 以对象形式粘贴一行,或以数组形式粘贴多行。如果某些列在部分行中为空,请粘贴多行,这样 allowNull 才会正确。
  2. 输入 模型名(默认 MyModel);它既用于 define,也用作导出的变量名。
  3. 输出假定 require('../db') 返回你的 Sequelize 实例。请把这个路径改成你的连接模块,然后把文件保存到 models/ 下。

示例

输入 (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" }
]
输出 (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 是 null,所以只有 age 得到 allowNull: true。joined_at 存放的是不带时间的日期,因此变成 DataTypes.DATEONLY,属性 joinedAt 通过 field: 'joined_at' 与真实的列对应。

支持的功能

  • 列类型:整数 → INTEGER(超过 2,147,483,647 用 BIGINT),小数 → DOUBLE,布尔值 → BOOLEAN,YYYY-MM-DD → DATEONLY,日期时间 → DATE,对象和数组 → JSON,其他字符串 → STRING。
  • 只有真正的 JSON 数字才会成为数值列;带引号的 "01234" 仍是 STRING。
  • 属性名为 camelCase,只要与 key 不同,就用 field: 'marketing_opt_in' 把属性映射到原来的列名。
  • JSON 中的 id key 会成为主键,而不是多出一列:整数会加上 autoIncrement,UUID 等字符串成为普通的 STRING 主键。如果没有这个 key,则会添加一个自增的 INTEGER id。
  • 任意一行中的 null 或缺失值会设置 allowNull: true,但不影响列类型。
  • 名为 UserProfile 的模型会得到 tableName: 'USER_PROFILE' 和 timestamps: false,因此不会期望存在 createdAt/updatedAt 列。

使用场景

为现有表编写模型

在数据库客户端中把 SELECT ... LIMIT 5 的结果导出为 JSON 并粘贴进来,就能得到已经体现列顺序、可空性和 snake_case 列名的 define 代码。只需映射一张表时,不必安装 sequelize-auto。

用 `sequelize.sync()` 创建测试表

做原型时,根据示例 JSON 生成模型,运行 sync() 在本地 SQLite 或 MySQL 中建表,再用 bulkCreate 载入种子数据。

注意事项与限制

  • DataTypes.STRING 默认是 VARCHAR(255);长文本请改为 DataTypes.TEXT。
  • DATEONLY 的值以 '2023-11-02' 这样的字符串返回,而不是 Date 对象。
  • DataTypes.JSON 可用于 MySQL、MariaDB、PostgreSQL 和 SQLite,但不支持 MSSQL;在 PostgreSQL 上通常 DataTypes.JSONB 是更好的选择。
  • tableName 是大写的(MEMBER)。在 PostgreSQL 或 Linux 上的 MySQL 等区分大小写的环境中,它必须与真实表名完全一致。
  • 金额请把 DOUBLE 换成 DataTypes.DECIMAL(12, 2),以避免浮点舍入误差。

常见问题

能得到基于类的 Model.init() 写法吗?

本页只生成 sequelize.define()。两种写法的属性对象完全相同,所以声明 class Member extends Model {},再把同一个对象传给 Member.init(attributes, { sequelize, tableName: 'MEMBER' }) 即可。TypeScript 请使用 JSON → Sequelize (TS) 页面。

列是 allowNull: false,但空字符串还是能存进去。

allowNull 只阻止 SQL 的 NULL。要同时拒绝空字符串,请在属性上加上 validate: { notEmpty: true }。

为什么在每个属性上写 field,而不是用 underscored: true?

underscored 只会把 camelCase 转成 snake_case,无法映射 home-url 这样的 key 或本来就是 camelCase 的列。显式的 field 无论风格如何,都能把 JSON key 原样作为列名。