HOWTO · SQLite
Eliminar una columna en la base de datos SQLite
En este artículo se discutirá cómo eliminar una columna en una base de datos SQLite.
En esta página
Eliminar una columna borra los datos de esa columna. Haz una copia de seguridad antes de modificar una base de datos y revisa los objetos del esquema que dependen de la tabla antes de elegir una migración. En las versiones compatibles, SQLite ofrece la operación directa ALTER TABLE ... DROP COLUMN; reconstruir la tabla es la alternativa cuando la operación no está disponible o no resulta adecuada.
Eliminar una columna de una tabla de SQLite
El método directo es breve, pero solo es apropiado si la biblioteca SQLite que ejecutará la migración admite DROP COLUMN y la columna no es necesaria para una restricción ni para otro objeto del esquema. Reconstruir la tabla permite controlar el esquema de reemplazo y la asignación de datos, aunque requiere más pasos de migración. En ambos casos, prueba el cambio en una copia o en una base de datos protegida mediante una transacción y verifica el resultado antes de confiar en él.
Comprobar la versión de SQLite y las dependencias de la columna
La compatibilidad con ALTER TABLE ... DROP COLUMN empieza en SQLite 3.35.0. Comprueba qué biblioteca SQLite utiliza la aplicación o la herramienta de línea de comandos que ejecutará la migración; distintas instalaciones pueden usar bibliotecas diferentes. La documentación de SQLite sobre ALTER TABLE indica el límite de versión y las restricciones: la eliminación puede fallar si la columna forma parte de una clave primaria o una restricción de unicidad, un índice, el predicado de un índice parcial, una clave externa, una restricción CHECK, una expresión de columna generada, un desencadenador o una vista. El ejemplo siguiente muestra la versión de la biblioteca, las columnas de la tabla y la fila que queda después de eliminar la columna. Usa el módulo estándar sqlite3 de Python con una base de datos en memoria, por lo que no modifica una base de datos del proyecto.
Antes de eliminar una columna, inspecciona la definición de la tabla y los índices, desencadenadores, vistas, expresiones generadas y restricciones relacionados. SQLite puede rechazar la operación si la columna participa en una característica del esquema que depende de ella. Revisa también las relaciones de claves externas: un cambio en la tabla puede afectar la integridad de los datos relacionados. Si se rechaza la operación directa, identifica la dependencia y decide si debes actualizarla o si reconstruir la tabla es la migración más segura.
Eliminar una columna con ALTER TABLE
La sintaxis compatible es ALTER TABLE table_name DROP COLUMN column_name;. La forma abreviada ALTER TABLE table_name DROP column_name; no es sintaxis de SQLite. El ejemplo autónomo siguiente crea una tabla pequeña, elimina last_name y luego consulta la lista de columnas resultante y los valores restantes. El código y las etiquetas o salidas visibles de esta sección se mantienen en inglés. Ejecuta este ejemplo:
import sqlite3
connection = sqlite3.connect(":memory:")
connection.execute(
"CREATE TABLE students "
"(id INTEGER PRIMARY KEY, first_name TEXT NOT NULL, "
"last_name TEXT NOT NULL, age INTEGER NOT NULL)"
)
connection.execute(
"INSERT INTO students (first_name, last_name, age) VALUES (?, ?, ?)",
("Ada", "Lovelace", 36),
)
print("SQLite", sqlite3.sqlite_version)
connection.execute("ALTER TABLE students DROP COLUMN last_name")
columns = [row[1] for row in connection.execute("PRAGMA table_info(students)")]
print("Columns:", ", ".join(columns))
print("Rows:", connection.execute("SELECT id, first_name, age FROM students").fetchall())
connection.close()
SQLite 3.40.1
Columns: id, first_name, age
Rows: [(1, 'Ada', 36)]
La ejecución muestra SQLite 3.40.1, las columnas restantes id, first_name y age, y la fila conservada (1, 'Ada', 36). El valor almacenado en last_name se descarta; DROP COLUMN no lo copia a ningún otro lugar.
Reconstruir la tabla cuando sea necesario
Cuando no se puede usar la operación directa, reconstruye la tabla con una definición que conserve los tipos, la clave primaria, los valores predeterminados, las intercalaciones, las comprobaciones y las cláusulas de clave externa necesarios. La plantilla ordenada siguiente elimina last_name; adapta la definición y ambas listas de columnas correspondientes a tu tabla. En el paso de copia, cada columna de destino debe corresponder a la expresión de origen situada en la misma posición.
- Antes de iniciar la transacción, inspecciona las relaciones de claves externas y guarda las definiciones de los índices, desencadenadores y vistas que deban conservarse. Si el procedimiento de reconstrucción documentado requiere desactivar la aplicación de claves externas, anota el valor actual y ejecuta
PRAGMA foreign_keys = OFF;antes de iniciar la transacción; cambiar esta directiva dentro de una transacción no tiene efecto. Mantén activada la aplicación cuando el esquema y la secuencia de reconstrucción lo permitan. - Empieza con
BEGIN IMMEDIATE;, crea la tabla de reemplazo con la definición prevista —en este ejemplo,CREATE TABLE new_students (id INTEGER PRIMARY KEY, first_name TEXT NOT NULL, age INTEGER NOT NULL);— y luego copia los datos de forma explícita conINSERT INTO new_students (id, first_name, age) SELECT id, first_name, age FROM students;. - Antes de modificar
students, comparaSELECT COUNT(*) FROM students;conSELECT COUNT(*) FROM new_students;y compara las claves y los valores que se conservarán mediante consultas a ambas tablas. Comprueba también los valores y las restricciones requeridos según las expectativas de la migración. Si alguna comprobación da un resultado distinto, ejecutaROLLBACK;e investiga; la tabla original seguirá intacta. - Solo después de que todas las comprobaciones sean correctas, ejecuta
DROP TABLE students;yALTER TABLE new_students RENAME TO students;. Vuelve a crear los índices y desencadenadores guardados, y actualiza o vuelve a crear las vistas y otros objetos del esquema que dependan de la definición anterior. - Ejecuta
PRAGMA foreign_key_check;y revisa las filas que devuelve. Si informa de alguna infracción, revierte la transacción en vez de confirmarla. De lo contrario, ejecutaCOMMIT;; si desactivaste las claves externas, restablece después de la transacción el valor que anotaste (por ejemplo,PRAGMA foreign_keys = ON;si originalmente estaba activado) y compruébalo. Conserva una copia de seguridad hasta que la migración y las comprobaciones de la aplicación hayan terminado correctamente.
Esta es una plantilla de migración específica para un esquema, no un script universal para copiar y pegar. En particular, revisa las referencias desde otras tablas antes de eliminar la original y sigue el procedimiento de reconstrucción de tablas de SQLite para conocer los detalles sobre claves externas y objetos dependientes que se aplican a tu esquema. CREATE TABLE ... AS SELECT no es un sustituto adecuado cuando importan las propiedades del esquema, ya que no reproduce la definición original de la tabla.
Verificar el esquema y los datos
Después de cualquiera de los dos métodos, inspecciona el esquema con PRAGMA table_info(students) o consulta sqlite_schema para ver la tabla y los objetos que dependen de ella. Confirma que last_name ya no aparece, que las columnas conservadas tienen las definiciones previstas y que permanecen las filas y los valores esperados. Si reconstruiste la tabla, compara el número de filas y los valores importantes con los de la tabla de origen antes de eliminarla; después del reemplazo, verifica los índices, desencadenadores, vistas y la integridad de las claves externas. Conserva la copia de seguridad hasta que estas comprobaciones se completen en el entorno donde se ejecutará la migración.