¡Convierte JSON a esquema de Sequelize (JavaScript)!

¡Introduce JSON y conviértelo a esquema de Sequelize (JavaScript)! Compatible con Sequelize sequelize.define, DataTypes, Node.js, Express.
JSON
Resultado
 

¡Convierte JSON a esquema de Sequelize (JavaScript)!

Convierte filas JSON en un modelo de Sequelize definido con sequelize.define(). Cada columna recibe un tipo DataTypes y un flag allowNull, y el archivo CommonJS incluye la clave primaria id, tableName y timestamps: false.

Encaja en un servidor Express sobre MySQL o PostgreSQL cuando tienes filas de ejemplo de una tabla (una hoja de cálculo exportada a JSON, la respuesta de una API externa) pero todavía no hay definición de modelo.

Cómo usar

  1. Pega una fila como objeto o varias filas como array. Si algunas columnas están vacías en algunas filas, pega varias filas para que allowNull salga bien.
  2. Escribe el Nombre del modelo (por defecto MyModel); se usa tanto en define como en la variable exportada.
  3. La salida supone que require('../db') devuelve tu instancia de Sequelize. Ajusta esa ruta a tu módulo de conexión y guarda el archivo en models/.

Ejemplo

Entrada (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" }
]
Salida (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;

El age del segundo miembro es null, así que solo age recibe allowNull: true. joined_at contiene fechas sin hora, así que pasa a DataTypes.DATEONLY, y el atributo joinedAt se vincula a la columna real con field: 'joined_at'.

Funciones compatibles

  • Tipos de columna: enteros → INTEGER (BIGINT a partir de 2,147,483,647), decimales → DOUBLE, booleanos → BOOLEAN, YYYY-MM-DD → DATEONLY, fechas con hora → DATE, objetos y arrays → JSON, otras cadenas → STRING.
  • Solo los números JSON reales pasan a columnas numéricas; un "01234" entre comillas se queda como STRING.
  • Los atributos van en camelCase y, siempre que eso difiere de la clave, field: 'marketing_opt_in' mapea el atributo al nombre de columna original.
  • Una clave id en tu JSON pasa a ser la clave primaria en lugar de una segunda columna: los enteros reciben autoIncrement, y las cadenas como los UUID pasan a una clave STRING simple. Sin ella, se añade un id INTEGER autoincremental.
  • Los valores null o ausentes en cualquier fila activan allowNull: true; no influyen en el tipo de columna.
  • Un modelo llamado UserProfile recibe tableName: 'USER_PROFILE' y timestamps: false, así que no se esperan columnas createdAt/updatedAt.

Casos de uso

Asociar un modelo a una tabla existente

Exporta como JSON el resultado de SELECT ... LIMIT 5 desde tu cliente de base de datos y pégalo para obtener código define con el orden de columnas, la nulabilidad y los nombres de columna snake_case ya reflejados. Práctico para mapear una sola tabla sin instalar sequelize-auto.

Crear tablas de prueba con `sequelize.sync()`

Durante el prototipado, construye un modelo a partir de un JSON de ejemplo, ejecuta sync() para crear la tabla en SQLite o MySQL local y luego carga datos semilla con bulkCreate.

Notas y limitaciones

  • DataTypes.STRING equivale por defecto a VARCHAR(255); cambia los textos largos a DataTypes.TEXT.
  • Los valores DATEONLY vuelven como cadenas '2023-11-02', no como objetos Date.
  • DataTypes.JSON funciona en MySQL, MariaDB, PostgreSQL y SQLite, pero no en MSSQL; en PostgreSQL suele ser mejor opción DataTypes.JSONB.
  • tableName va en mayúsculas (MEMBER). En configuraciones que distinguen mayúsculas, como PostgreSQL o MySQL en Linux, debe coincidir exactamente con el nombre real de la tabla.
  • Para dinero, sustituye DOUBLE por DataTypes.DECIMAL(12, 2) para evitar el redondeo de coma flotante.

Preguntas frecuentes

¿Puedo obtener el estilo basado en clases con Model.init()?

Esta página solo genera sequelize.define(). El objeto de atributos es idéntico en ambos estilos, así que declara class Member extends Model {} y pasa el mismo objeto a Member.init(attributes, { sequelize, tableName: 'MEMBER' }). Para TypeScript, usa la página JSON → Sequelize (TS).

La columna es allowNull: false, pero aun así entran cadenas vacías.

allowNull solo bloquea el NULL de SQL. Para rechazar también las cadenas vacías, añade validate: { notEmpty: true } al atributo.

¿Por qué field en cada atributo en lugar de underscored: true?

underscored solo convierte camelCase a snake_case, así que no puede mapear claves como home-url ni columnas que ya están en camelCase. Un field explícito mantiene la clave JSON exacta como nombre de columna, sea cual sea su estilo.