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

PublicadoHerramientaConversor de SQL DDL a JSON Schema

Contenido
  1. 1. Así se asignan los tipos SQL a los tipos de JSON Schema
  2. 2. Así se interpreta en la práctica una sentencia DDL
  3. 3. Puntos que suelen dar problemas
  4. En resumen
  5. Preguntas frecuentes

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 NULL y PRIMARY KEY entran automáticamente en el array required; UNIQUE no entra. ③ La longitud de VARCHAR (maxLength) y las listas ENUM no 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, como VARCHAR(50), maxLength no 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.

  1. Quitar comentarios: elimina primero los comentarios de bloque /* ... */ y los comentarios de línea --.
  2. 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.
  3. 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).
  4. Distinguir el tipo de línea: si una línea empieza por PRIMARY KEY, CONSTRAINT, FOREIGN KEY, UNIQUE, CHECK o INDEX, considérala una restricción de tabla y no una columna; de todas ellas, solo la forma PRIMARY KEY(columna1, columna2) se refleja en el array required. El resto de restricciones no se reflejan en el esquema.
  5. 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 valor y COMMENT 'descripción' para reflejarlos, respectivamente, en el registro como obligatorio, en el campo default y en el campo description.

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.

Conversor de SQL DDL a JSON Schema

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ónComportamiento real
Longitud especificada, como VARCHAR(50)El tipo se convierte en string, pero maxLength no se añade automáticamente.
Restricción UNIQUEA 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 valorSalvo 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, DATE y TIMESTAMP/DATETIME reciben valores de format distintos.
  • El array required se llena automáticamente solo con las columnas NOT NULL y PRIMARY KEY; no incluye UNIQUE.
  • La longitud de VARCHAR (maxLength) y las listas ENUM no se convierten automáticamente, así que, si las necesitas, añádelas a mano después de recibir el resultado de la conversión.
Conversor de SQL DDL a JSON Schema

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

Artículos relacionados

  1. Formateador de SQL: reglas para ordenar consultasCómo convierte una consulta de una línea en cláusulas separadas: solo cambian mayúsculas, espacios y saltos de línea, nunca el resultado.
  2. Binding de parámetros SQL: cómo se sustituyen los valoresAprende cómo se sustituyen los placeholders ?, :id y @name por sus valores: números sin comillas y texto entre comillas simples.
  3. Escapar cadenas de texto en JSON y JS: qué cambia y cómoTabla con los símbolos que sustituyen a barras invertidas, comillas, saltos de línea y tabulaciones en JSON y JS, el sentido inverso y los errores más comunes.
  4. Quitar etiquetas HTML: deja solo el texto planoCómo quitar las etiquetas HTML de un texto copiado y dejar solo el cuerpo: con una regex en tu editor o con la herramienta, y qué cambia cada opción.
  5. Conversor de superíndices y subíndices: x² y H₂O para copiarAprende a escribir x² y H₂O con caracteres Unicode reales que se mantienen al pegarlos en mensajes, redes o documentos, y por qué algunos no cambian.
  6. Coordenadas de ruta SVG: leer el atributo d y pasarlo a JSONAprende a leer las letras y números del atributo d (M, L, C, Z), a distinguir mayúsculas de minúsculas y a extraer las coordenadas en JSON, puntos o CSV.

Herramientas relacionadas