Cómo convertir el resultado de una consulta SQL o un CSV a JSON (y a un array de PHP para seeders)

· lectura de 5 minutos

Cómo convertir el resultado de una consulta SQL o un CSV a JSON (y a un array de PHP para seeders)

Una situación típica: ejecutas una consulta en la consola de MySQL, obtienes una tabla bonita con unas cuantas filas y quieres usar justo esas filas en otro sitio: como datos de prueba en un seeder de Laravel, como fixture JSON para un frontend o como cuerpo de una llamada a una API. Volver a escribirlas a mano es lento y propenso a errores. Estas son las formas más rápidas de convertir el resultado.

La forma más rápida: pegar la tabla y convertirla

Nuestro convertidor de tabla a JSON gratuito entiende lo que copies de los sitios habituales:

  1. Copia el resultado: la tabla con bordes del cliente mysql, la salida de psql, un archivo CSV o celdas de Excel / Google Sheets.
  2. Pégalo en la herramienta. El formato se detecta automáticamente (puedes cambiarlo).
  3. Elige la salida: JSON – array de objetos, JSON – array de arrays, Array de PHP u Objeto de JavaScript.
  4. Deja activado Convertir números, booleanos y null si quieres 1 en lugar de "1" y NULL como null.
  5. Copia o descarga el resultado.

Por ejemplo, esta salida de MySQL:

+----+------------+------------------+
| id | name       | email            |
+----+------------+------------------+
|  1 | José Pérez | jose@example.com |
|  2 | Ana García | NULL             |
+----+------------+------------------+
2 rows in set (0.00 sec)

se convierte en este array de PHP, listo para pegar en un seeder:

DB::table('users')->insert([
    [
        'id' => 1,
        'name' => 'José Pérez',
        'email' => 'jose@example.com',
    ],
    [
        'id' => 2,
        'name' => 'Ana García',
        'email' => null,
    ],
]);

La línea del prompt y el pie «2 rows in set» se ignoran automáticamente. La conversión se hace en tu navegador, así que los datos de producción nunca salen de tu equipo.

Que la base de datos genere el JSON directamente

Si puedes cambiar la consulta, MySQL (5.7.22 y posteriores) y PostgreSQL pueden devolver JSON por sí mismos.

MySQL:

SELECT JSON_ARRAYAGG(JSON_OBJECT('id', id, 'name', name, 'email', email))
FROM users;

PostgreSQL:

SELECT json_agg(u) FROM (SELECT id, name, email FROM users) AS u;

Las dos devuelven un único valor con el array completo. En la consola, el resultado puede ser muy largo y quedar cortado o partido; ejecútalo con mysql -N -B -e "…" o psql -At -c "…" para obtener el valor en bruto sin los bordes de la tabla.

Obtener una salida limpia separada por tabulaciones desde la consola

Cuando necesitas los datos como tabla y no como JSON, pide al cliente una salida fácil de procesar:

  • mysql -B -e "SELECT id, name FROM users" mydb muestra valores separados por tabulaciones con una fila de cabecera (-N quita la cabecera).
  • psql --csv -c "SELECT id, name FROM users" mydb muestra CSV (psql 12+).

Las dos salidas también se pueden pegar en el convertidor: el texto separado por tabulaciones se detecta como TSV. Ten en cuenta que mysql -B muestra NULL para los valores nulos y escapa las tabulaciones y los saltos de línea dentro de los valores como \t y \n.

En Laravel: deja que lo haga Eloquent

Si los datos ya están en la base de datos de tu aplicación, no necesitas copiar nada:

// JSON
User::select('id', 'name', 'email')->get()->toJson(JSON_PRETTY_PRINT);

// Código de array PHP para un seeder (ejecútalo en php artisan tinker)
var_export(DB::table('users')->select('id', 'name')->get()->map(fn ($row) => (array) $row)->all());

var_export genera la sintaxis antigua array (...) con claves numéricas. Funciona, pero la sintaxis corta [ ] del convertidor se lee mejor en un seeder.

De CSV a JSON con Python

Para archivos CSV grandes (cientos de megabytes), un script es mejor opción. Esta línea lee un CSV con fila de cabecera y muestra JSON:

python3 -c "import csv, json, sys; print(json.dumps(list(csv.DictReader(sys.stdin)), indent=2, ensure_ascii=False))" < datos.csv > datos.json

Ten en cuenta que todos los valores se quedan como cadenas: csv no adivina los tipos.

De Excel y Google Sheets a JSON

Selecciona el rango con la fila de cabecera y cópialo (Ctrl+C / Cmd+C). El portapapeles contiene texto separado por tabulaciones, así que puede ir directamente al convertidor. Si tu Excel guarda los archivos CSV con punto y coma (lo habitual con la configuración regional de España y de muchos países latinoamericanos), el convertidor también lo detecta.

Errores habituales

  • Ceros a la izquierda. Los códigos postales, los números de teléfono y los códigos de producto como 007 deben quedarse como cadenas. El convertidor mantiene como texto los valores con ceros a la izquierda; las hojas de cálculo a menudo los eliminan sin avisar, así que revisa el origen.
  • Comas decimales. 1,5 no es un número JSON válido. Si necesitas números, convierte antes las comas decimales en puntos.
  • IDs muy grandes. JavaScript (y, por tanto, JSON en la mayoría de las herramientas) no puede representar con exactitud enteros mayores que 9 007 199 254 740 991. Esos valores se mantienen como cadenas.
  • Vacío frente a NULL. MySQL muestra NULL explícitamente; psql muestra una celda vacía. El convertidor transforma NULL en null, pero mantiene las celdas vacías como cadenas vacías, porque no puede saber cuál querías.
  • Barras verticales dentro de los valores. En las tablas SQL con bordes, un carácter | dentro de un valor no se distingue de un borde de columna. Para esos datos, usa la salida separada por tabulaciones.

Preguntas frecuentes

¿Cómo convierto un resultado SQL a JSON sin escribir código?

Copia la tabla de resultados de tu cliente SQL y pégala en el convertidor de tabla a JSON. Reconoce las tablas con bordes de MySQL, la salida de psql, las tablas de Markdown y la salida vertical \G.

¿Cómo creo un seeder de Laravel a partir de datos existentes?

Copia el resultado de la consulta, elige Array de PHP en el convertidor y envuelve la salida en DB::table('tu_tabla')->insert(...) dentro del método run() del seeder.

¿Es seguro pegar datos de producción en un convertidor online?

Con nuestro convertidor, sí: la conversión se hace localmente en tu navegador y no se envía nada a ningún servidor. Aun así, evita guardar datos personales reales en seeders que acaben en tu repositorio.

¿Cómo compruebo qué ha cambiado entre dos exportaciones?

Convierte las dos al mismo formato y compáralas con la herramienta para comparar textos, que resalta las líneas añadidas, eliminadas y modificadas.