Herramientas y scripts de IA
Database Schema Handbook: diccionario de datos y ERD a partir de tu esquema
Para equipos que heredan o entregan una base de datos: un script analiza tus archivos de esquema o tus migraciones, y tu agente redacta un diccionario de datos, un ERD, una guía de relaciones y hallazgos con líneas de origen, para que los revises. Diccionario de datos y diagrama de relaciones a partir de los archivos de tu base de datos.
Qué recibes: 1 archivo · 109.22 KB · ZIP
Ver opciones de compraDescripción del producto
Descripción
Para desarrolladores, agencias y equipos que heredan una base de datos, entregan una o tienen que explicar una a un compañero nuevo o a un cliente.
Dale a tu agente los archivos de esquema de la propia base de datos. El agente redacta un manual del esquema, para que lo revises: un diccionario de datos, un diagrama, las relaciones en palabras y una lista de hallazgos.
Lee un schema.sql, un archivo pg_dump --schema-only, un volcado de MySQL, un esquema de SQLite o una carpeta de migraciones SQL aplicadas en orden. Nada se conecta a una base de datos.
Los significados que el agente infiere se marcan como inferidos y siguen sin verificar hasta que tu equipo los confirme. Las vistas, funciones y disparadores se listan, no se describen.
Qué escribe el agente en cada ejecución
data-dictionary.mdydata-dictionary.csv: cada tabla y columna con su tipo, si admite nulos, valor por defecto y claves, un significado en lenguaje claro y la base de ese significado: comentario del esquema, restricción, inferido del nombre, indicado por ti o desconocido.erd.mmd: un diagrama Mermaid para pegar en una wiki o en un README.relationships.md: cada clave externa en palabras con su línea de origen, relaciones de muchos a muchos y ejemplos de joins para las tablas más conectadas.findings.md: observaciones objetivas, cada una con el nombre de la tabla o columna y la cita de archivo y línea. Ejemplos: tablas sin clave primaria, claves externas sin índice de apoyo, tipos que no coinciden a través de una clave externa, columnas de dinero guardadas como coma flotante, columnas de fecha y hora sin zona horaria, índices duplicados.handbook.html: una página autónoma con el diagrama dibujado dentro, todas las tablas, las relaciones, los hallazgos y las preguntas abiertas. Se imprime tal cual.
Lo lee un script, lo explica el agente
Un script incluido analiza el DDL de PostgreSQL, MySQL y SQLite, aplica en orden las sentencias ALTER y las migraciones, y registra el archivo y la línea de cada tabla, columna, clave e índice. Después el agente escribe qué significa cada tabla y columna. Un comando check rechaza un diccionario con una tabla o columna ausente, un tipo desactualizado o un significado en blanco.
Solo tu esquema
La skill indica al agente que marque cada significado inferido y que escriba lo que no puede saber como una pregunta [NEEDS: ...] para tu equipo, en lugar de rellenarlo.
Honestidad sobre sus límites
Documenta la estructura tal como está declarada en los archivos. El número de filas, la calidad de los datos, el uso de los índices y lo que hace la aplicación en ejecución no están en esos archivos, así que no están en el manual. Los significados inferidos de los nombres son borradores por confirmar. Las vistas, funciones, procedimientos, disparadores y restricciones de exclusión se listan con sus líneas y no se describen. El analizador es tolerante, no completo: no se probaron archivos de SQL Server ni de Oracle. Los hallazgos basados en nombres son heurísticas y cada uno puede ser una decisión deliberada. La lectura de modelos ORM (Prisma, Django, Rails) la hace el agente con una plantilla y no se ejecutó como caso de prueba. La página HTML y su diagrama se comprobaron como marcado, no se vieron en un navegador; en un esquema grande el diagrama es alto y las líneas pueden cruzarse.
Árabe
Si lo pides, el manual se escribe en árabe con una página de derecha a izquierda; los nombres de tablas y columnas se mantienen de izquierda a derecha.
En la descarga: SKILL.md, los scripts de Python de biblioteca estándar, referencias (lectura de esquemas, redacción de significados, guía de hallazgos, notas sobre el árabe), plantillas y un ejemplo resuelto que puedes leer antes de comprar: una base de datos PostgreSQL de reservas de una clínica con 15 tablas, 116 columnas y 19 claves externas, que da 35 observaciones y 33 preguntas abiertas.
Probado en dos casos (un volcado de PostgreSQL en inglés; una tienda MySQL creada con 8 migraciones, en árabe). Los scripts tienen 52 pruebas unitarias.
Versión breve
Para desarrolladores, agencias y equipos que reciben una base de datos, la entregan o necesitan explicarla a un compañero nuevo o a un cliente.
Dale a tu agente los archivos del esquema de la base de datos (schema.sql, un archivo de volcado o una carpeta de archivos de migración). Te redacta un borrador del manual para que lo revises: diccionario de datos, diagrama de relaciones, explicación de las relaciones y una lista de observaciones. No se conecta a la base de datos en absoluto.
Qué escribe el agente
- El archivo
data-dictionary: cada tabla y columna con su tipo, claves y significado, y la fuente de ese significado. - El archivo
erd.mmd: un diagrama de relaciones en formato Mermaid. - El archivo
relationships.md: cada relación explicada con palabras, con ejemplos de joins. - El archivo
findings.md: observaciones objetivas, cada una con el nombre del archivo y el número de línea. - El archivo
handbook.html: una sola página lista para imprimir.
Sus límites
Documenta únicamente la estructura tal como está escrita en los archivos, así que no ve los datos en sí ni lo que hace la aplicación. Los significados inferidos de los nombres son borradores que necesitan tu confirmación, y lo que no se sabe se escribe como pregunta para tu equipo. Admite PostgreSQL, MySQL y SQLite. El manual puede pedirse en árabe; se probó en un caso de prueba.
Preguntas
¿Se conecta a mi base de datos?
No. Lee los archivos de esquema de tu disco y nada más.
¿Qué bases de datos lee?
Archivos de esquema de PostgreSQL, MySQL y SQLite, o una carpeta de migraciones SQL aplicadas en orden. No se probaron SQL Server ni Oracle.
Solo tengo migraciones, no un archivo de esquema.
Indícale la carpeta. El script aplica las migraciones en orden, incluidos los cambios de nombre y las columnas eliminadas, y guarda un historial breve.
¿Cómo sabe qué significa una columna?
A partir de los comentarios del esquema, las restricciones y los nombres, o de lo que tú le indiques. Cada significado se marca con su base, y lo que sigue sin saberse se escribe como pregunta.
¿Me dirá que mi esquema está mal?
Lista observaciones con sus líneas de origen para que tu equipo las revise. Cada una puede ser una decisión deliberada.
¿Puede estar el manual en árabe?
Sí, con una página de derecha a izquierda y los identificadores de izquierda a derecha. Se probó en un caso de prueba.
Qué recibes
1 archivo · 109.22 KB
- schema-handbook-1.0.0.zipZIP · 109.22 KB
Herramientas y scripts de IA
Database Schema Handbook: diccionario de datos y ERD a partir de tu esquema
Para equipos que heredan o entregan una base de datos: un script analiza tus archivos de esquema o tus migraciones, y tu agente redacta un diccionario de datos, un ERD, una guía de relaciones y hallazgos con líneas de origen, para que los revises. Diccionario de datos y diagrama de relaciones a partir de los archivos de tu base de datos.
Getly abrió los archivos subidos y no encontró nada que impida abrirlos. No es un análisis antivirus ni una valoración de calidad.
Etiquetas
Preguntas frecuentes
¿Tengo acceso al instante?
Sí. Es un producto digital: puedes descargarlo justo después del pago, directamente desde tu biblioteca.
¿Puedo usarlo en proyectos comerciales?
Sí. Se permite el uso comercial: úsalo en tu propio negocio y en cosas que vendas. No puedes revender ni redistribuir el archivo en sí.
¿Cuál es vuestra política de reembolso?
Puedes pedir un reembolso dentro de 30 días. Si algo no va bien, solicítalo desde tu pedido y el equipo de Getly lo revisa.
¿Qué formatos y tamaños de archivo recibiré?
Descargarás 1 archivo - ZIP - 109.22 KB en total.
¿Recibo actualizaciones gratis?
Sí: cuando el vendedor publica una versión nueva, puedes volver a descargar los archivos más recientes desde tu biblioteca sin coste extra. Mira el registro de cambios para ver las últimas actualizaciones.
Precio
$7.00



