Descripciones
funcionalEdita descripciones de tablas, vistas y columnas y escríbelas de vuelta al servidor como DDL de comentarios.
Las tablas, vistas y columnas pueden llevar una descripción, el comentario que la propia base de datos guarda junto al objeto. SQLly lee esas descripciones en todos los sitios donde muestra el esquema (la columna Comentario del inventario de objetos, la exportación de documentación del esquema, el contexto de IA), y puedes escribirlas desde dos lugares sin tener que escribir a mano la sintaxis de comentarios del motor.
Dónde editar
- Editar estructura - una Descripción El campo de la tabla se encuentra bajo la lista de columnas, y cada fila de columna tiene su propio cuadro de descripción. Las ediciones de la descripción aparecen en la lista de cambios como Establecer descripción. En la mayoría de los motores se generan como script después de los cambios estructurales; el comentario pertenece a la columna, así que renombrarla o cambiarle el tipo no requiere una instrucción adicional. En MySQL y MariaDB, donde cambiar una columna vuelve a declarar toda su definición, una columna que se renombra, a la que se cambia el tipo o el valor predeterminado, o que se añade, lleva su descripción dentro de esa misma cláusula, así que conserva (o adquiere) su comentario y el cambio estructural no se deshace.
- Propiedades del objeto - la General la página de una tabla o vista muestra su descripción, una vez leída, en un campo editable. Si la cambias, la página se marca como modificada; Revisar cambios muestra la instrucción exacta antes de ejecutar nada.
Borrar el texto elimina la descripción. Ambas vistas siguen las reglas de revisión habituales: Editar estructura manda el script a una pestaña del editor y Propiedades del objeto solo se ejecuta desde su hoja de revisión.
Si las descripciones actuales no se pueden leer (un problema de permisos, por ejemplo), ambas vistas ocultan el campo de descripción y muestran el motivo en su lugar. Nunca se genera un script de edición a partir de un valor supuesto, porque en SQL Server el procedimiento correcto depende de si ya existe una descripción.
Qué ejecuta SQLly en cada motor
| Motor | Descripción de tabla / vista | Descripción de columna |
|---|---|---|
| SQL Server / Azure SQL | La MS_Description propiedad extendida: sp_addextendedproperty cuando no existe ninguna, sp_updateextendedproperty cuando existe una (incluso si contiene texto vacío), sp_dropextendedproperty para limpiar. Las vistas se tratan como vistas. | Los mismos procedimientos a nivel de columna. |
| PostgreSQL | COMMENT ON TABLE / COMMENT ON VIEW … IS '…'; IS NULL limpia. | COMMENT ON COLUMN … IS '…'. |
| CockroachDB | COMMENT ON TABLE … IS '…'. CockroachDB no tiene COMMENT ON VIEW, por lo que el campo de descripción de una vista se oculta por esa razón. | COMMENT ON COLUMN … IS '…'. |
| DuckDB | COMMENT ON TABLE / COMMENT ON VIEW; IS NULL limpia. | COMMENT ON COLUMN. |
| Oracle Database | COMMENT ON TABLE … IS '…' (Oracle trata las vistas con la palabra clave TABLE); IS '' limpia. | COMMENT ON COLUMN. |
| MySQL / MariaDB | ALTER TABLE … COMMENT = '…'. Las vistas no pueden guardar una descripción (el servidor devuelve el comentario de cada vista como VIEW), así que el campo de la vista queda oculto con ese motivo. | MySQL no tiene ninguna instrucción que cambie solo un comentario, así que SQLly ejecuta ALTER TABLE … MODIFY COLUMN. En un cambio solo de descripción, vuelve a declarar la columna exactamente como SHOW CREATE TABLE la imprime y reemplaza solo la cláusula COMMENT '…' , manteniendo todo lo demás, incluidas las cláusulas que sigan al comentario, como las de MariaDB CHECK (json_valid(…)); si ese texto no puede leerse, SQLly rechaza el cambio en lugar de adivinar. Cuando la misma edición también renombra, cambia el tipo, cambia el valor por defecto o añade la columna, la COMMENT entra en esa cláusula CHANGE/MODIFY/ADD en su lugar. |
| ClickHouse | ALTER TABLE … MODIFY COMMENT '…'. Las vistas no admiten comentarios después de crearlas; SQLly te pide que la vuelvas a crear con un COMMENT cláusula. | ALTER TABLE … COMMENT COLUMN … '…'. |
| SQLite / libSQL | No hay almacén de comentarios del lado del servidor. Los campos de descripción están ocultos y el editor muestra el motivo en su lugar. | |
El texto se entrecomilla para el motor: las comillas internas se duplican en todos los casos, y los valores de SQL Server se envían como Unicode N'…' literales, y MySQL y ClickHouse también escapan las barras invertidas.
En MySQL y MariaDB, una columna que la opción Editar estructura renombre, cambie de tipo o de valor predeterminado se reconstruye a partir de los campos del editor: su tipo, nulabilidad, valor predeterminado, autoincremento, su ON UPDATE (para columnas timestamp y datetime), y su descripción. Una anulación del juego de caracteres o de la colación, una expresión generada, INVISIBLE, o uno a nivel de columna CHECK no se reitera; cuando la definición actual tiene una, el script lo indica en una -- WARNING línea para que puedas añadirla al tipo antes de ejecutar.

