Conversión de SQL DDL a JSON Schema: reglas y mapeo de tipos

Contenido
La sintaxis CREATE TABLE de las bases de datos relacionales (RDB) y el JSON Schema (JSON Schema Draft-07), muy habitual en API y bases de datos documentales, se expresan de forma distinta. Por eso, cuando trasladas columna por columna a ojo, es fácil pasar por alto los tipos o el tratamiento de los valores obligatorios. Si recopilas como reglas qué tipo de SQL se convierte en qué tipo de JSON y cómo se gestionan NOT NULL y UNIQUE, puedes reducir este tipo de errores.
Resumen ① Los tipos SQL se agrupan en varias familias —enteros, números reales, booleanos, fechas, JSON, etc.— y se asignan a un tipo de JSON Schema. ② Solo las columnas
NOT NULLyPRIMARY KEYentran automáticamente en el arrayrequired;UNIQUEno entra. ③ La longitud deVARCHAR(maxLength) y las listasENUMno se convierten automáticamente, así que hay que añadirlas a mano.
1. Así se asignan los tipos SQL a los tipos de JSON Schema
Los tipos de datos que aparecen en SQL DDL se convierten en la propiedad type de JSON Schema Draft-07 según estos criterios.
- Enteros:
INT,INTEGER,TINYINT,SMALLINT,MEDIUMINT,BIGINT,SERIAL,BIGSERIAL→{ "type": "integer" } - Números reales:
DECIMAL,NUMERIC,FLOAT,DOUBLE,REAL→{ "type": "number" } - Booleanos:
BOOLEAN,BOOL→{ "type": "boolean" } - Fechas:
DATE→{ "type": "string", "format": "date" }/TIMESTAMP,DATETIME→{ "type": "string", "format": "date-time" } - Familia JSON:
JSON,JSONB→{ "type": "object" } - Otras cadenas de texto:
VARCHAR,CHAR,TEXT, etc. se tratan todos como{ "type": "string" }. Aunque lleven una longitud, comoVARCHAR(50),maxLengthno se añade automáticamente.
La obligatoriedad se gestiona aparte del tipo. Solo las columnas con NOT NULL y las designadas como PRIMARY KEY se registran automáticamente en el array required de nivel superior. La restricción UNIQUE solo impide que se dupliquen valores, pero no obliga a que el valor exista, por lo que no entra automáticamente en el array required. Si activas la opción «Establecer el tipo de las columnas opcionales como unión con null», el tipo de las columnas que no están en required pasa a ser una unión con null, como ["string", "null"].
2. Así se interpreta en la práctica una sentencia DDL
Si lees una sentencia SQL CREATE TABLE en este orden, puedes obtener el mismo resultado a mano.
- Quitar comentarios: elimina primero los comentarios de bloque
/* ... */y los comentarios de línea--. - Separar el nombre de la tabla del cuerpo: en la forma
CREATE TABLE [IF NOT EXISTS] nombre_tabla ( ... ), separa el nombre de la tabla del contenido entre paréntesis. - Dividir las líneas de columnas: divide el contenido entre paréntesis por comas, pero ignora las comas que estén dentro de paréntesis, como en
DECIMAL(10,2)(para ello, cuenta la profundidad de apertura y cierre de los paréntesis). - Distinguir el tipo de línea: si una línea empieza por
PRIMARY KEY,CONSTRAINT,FOREIGN KEY,UNIQUE,CHECKoINDEX, considérala una restricción de tabla y no una columna; de todas ellas, solo la formaPRIMARY KEY(columna1, columna2)se refleja en el arrayrequired. El resto de restricciones no se reflejan en el esquema. - Analizar las líneas de columnas: en el resto de líneas, lee la primera palabra separada por espacios como nombre de columna y la segunda como tipo. Después busca en toda la línea
NOT NULL,DEFAULT valoryCOMMENT 'descripción'para reflejarlos, respectivamente, en el registro como obligatorio, en el campodefaulty en el campodescription.
Compruébalo con nuestra herramienta gratuita, el Conversor de SQL DDL a JSON Schema. En lugar de repetir estas reglas a mano por cada columna, pega tu SQL DDL y genera al instante un JSON Schema con esas mismas reglas.
Pega tus sentencias SQL CREATE TABLE DDL del motor relacional que uses y genera automáticamente el código fuente del objeto de validación JSON Schema estándar más reciente.

3. Puntos que suelen dar problemas
| Situación | Comportamiento real |
|---|---|
Longitud especificada, como VARCHAR(50) | El tipo se convierte en string, pero maxLength no se añade automáticamente. |
Restricción UNIQUE | A diferencia de PRIMARY KEY, no entra automáticamente en el array required. |
ENUM('a','b') | No lee la lista para crear un array enum; solo se convierte al tipo string. |
COMMENT 'descripción' | Se refleja automáticamente en el campo description. |
DEFAULT valor | Salvo NULL y los valores del estilo CURRENT_TIMESTAMP, se refleja en el campo default. |
En resumen
- Los tipos enteros, de números reales, booleanos y de la familia JSON se asignan directamente con solo el nombre del tipo.
- En las fechas,
DATEyTIMESTAMP/DATETIMEreciben valores deformatdistintos. - El array
requiredse llena automáticamente solo con las columnasNOT NULLyPRIMARY KEY; no incluyeUNIQUE. - La longitud de
VARCHAR(maxLength) y las listasENUMno se convierten automáticamente, así que, si las necesitas, añádelas a mano después de recibir el resultado de la conversión.
Pega tus sentencias SQL CREATE TABLE DDL del motor relacional que uses y genera automáticamente el código fuente del objeto de validación JSON Schema estándar más reciente.
Preguntas frecuentes
¿La longitud de VARCHAR se convierte automáticamente en maxLength en JSON Schema?
No. El conversor actual solo asigna el tipo y no incluye restricciones de longitud. Si la necesitas, añade "maxLength": 50 directamente en el campo correspondiente del JSON convertido.
¿Las columnas con restricción UNIQUE también entran automáticamente en el array required?
No. En el array required solo entran las columnas NOT NULL y PRIMARY KEY. UNIQUE es una restricción que impide los duplicados, no una que obligue a que el valor exista, así que no se trata por separado. Si quieres que sea obligatoria, tendrás que añadirla manualmente al array required después de la conversión.
¿Cómo se trata el tipo ENUM?
La versión actual no lee automáticamente la lista ENUM para crear un array enum; solo convierte al tipo de cadena (string). Si quieres limitar los valores posibles, añade "enum": ["active", "inactive"] directamente en el JSON convertido.
Este artículo está adaptado de nuestro original en coreano. Leer el original en coreano