HOWTO · SQLite
SQLite 데이터베이스에서 열 삭제
이 기사에서는 SQLite 데이터베이스에서 열을 삭제하는 방법에 대해 설명합니다.
이 페이지의 내용
열을 삭제하면 해당 열의 데이터도 삭제됩니다. 데이터베이스를 변경하기 전에 백업하고, 마이그레이션 방법을 정하기 전에 테이블에 종속된 스키마 객체를 확인하세요. 지원되는 버전에서는 SQLite가 직접 ALTER TABLE ... DROP COLUMN 작업을 제공합니다. 이 작업을 사용할 수 없거나 적절하지 않으면 테이블을 재구축할 수 있습니다.
SQLite 테이블에서 열 삭제
직접 삭제는 간결하지만, 마이그레이션을 실행할 SQLite 라이브러리가 DROP COLUMN를 지원하고 해당 열이 제약 조건이나 다른 스키마 객체에 필요하지 않을 때만 적절합니다. 테이블을 재구축하면 교체할 스키마와 데이터 매핑을 직접 제어할 수 있지만, 마이그레이션 단계가 늘어납니다. 어느 방법을 선택하든 복사본이나 트랜잭션으로 보호된 데이터베이스에서 시험하고, 결과를 확인한 뒤 사용하세요.
SQLite 버전과 열 종속성 확인
직접 ALTER TABLE ... DROP COLUMN 작업은 SQLite 3.35.0부터 지원됩니다. 마이그레이션을 실행할 애플리케이션이나 명령줄 도구가 사용하는 SQLite 라이브러리를 확인하세요. 설치 환경마다 서로 다른 라이브러리를 사용할 수 있습니다. SQLite의 ALTER TABLE 문서에는 버전 기준과 제한 사항이 설명되어 있습니다. 해당 열이 기본 키나 고유 제약 조건, 인덱스, 부분 인덱스 조건식, 외래 키, CHECK 제약 조건, 생성 열 표현식, 트리거 또는 뷰에 포함되어 있으면 삭제가 실패할 수 있습니다. 아래 예제는 라이브러리 버전, 테이블의 열 목록, 삭제 후 남은 행을 출력합니다. Python 표준 sqlite3 모듈과 메모리 데이터베이스를 사용하므로 프로젝트 데이터베이스는 수정하지 않습니다.
열을 삭제하기 전에 테이블 정의와 관련 인덱스, 트리거, 뷰, 생성 열 표현식 및 제약 조건을 살펴보세요. SQLite는 해당 열에 의존하는 스키마 기능이 있으면 삭제를 거부할 수 있습니다. 외래 키 관계도 검토하세요. 테이블 변경은 관련 데이터의 무결성에 영향을 줄 수 있습니다. 직접 삭제가 거부되면 어떤 종속성이 원인인지 확인하고, 이를 수정할지 아니면 재구축을 더 안전한 마이그레이션 방법으로 선택할지 결정하세요.
ALTER TABLE로 열 삭제
지원되는 형식은 ALTER TABLE table_name DROP COLUMN column_name;입니다. 더 짧은 ALTER TABLE table_name DROP column_name; 형식은 SQLite 문법이 아닙니다. 다음 자체 완결형 예제는 작은 테이블을 만들고 last_name을 삭제한 다음, 결과 열 목록과 남은 값을 읽습니다. 예제를 실행하세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
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)]
실행 결과에는 SQLite 3.40.1, 남은 열 id, first_name, age, 그리고 보존된 행 (1, 'Ada', 36)이 표시됩니다. 출력의 Columns:와 Rows: 레이블은 바이트 동일성 규칙에 따라 영어로 유지됩니다. last_name에 저장된 값은 삭제되며 DROP COLUMN는 그 값을 다른 곳으로 복사하지 않습니다.
필요한 경우 테이블 재구축
직접 삭제를 사용할 수 없다면 필요한 자료형, 기본 키, 기본값, 데이터 정렬 규칙, CHECK 제약 조건 및 외래 키 절을 보존하는 정의로 테이블을 재구축하세요. 다음 순서가 있는 템플릿은 last_name을 제거합니다. 테이블에 맞게 정의와 서로 대응하는 두 열 목록을 수정하세요. 복사 단계에서는 각 대상 열이 같은 위치의 원본 표현식에 대응해야 합니다.
- 트랜잭션을 시작하기 전에 외래 키 관계를 살펴보고 유지해야 할 인덱스, 트리거 및 뷰의 정의를 저장하세요. 문서에 설명된 재구축 절차에 외래 키 검사를 비활성화해야 한다면 현재 설정을 기록하고 트랜잭션을 시작하기 전에
PRAGMA foreign_keys = OFF;를 실행하세요. 트랜잭션 안에서 이 pragma를 변경해도 적용되지 않습니다. 스키마와 재구축 순서가 허용한다면 검사를 활성화한 상태로 유지하세요. BEGIN IMMEDIATE;로 시작하고, 이 예제에서 사용할 정의에 따라CREATE TABLE new_students (id INTEGER PRIMARY KEY, first_name TEXT NOT NULL, age INTEGER NOT NULL);로 대체 테이블을 만드세요. 그런 다음INSERT INTO new_students (id, first_name, age) SELECT id, first_name, age FROM students;로 열을 명시해 복사하세요.students를 변경하기 전에SELECT COUNT(*) FROM students;와SELECT COUNT(*) FROM new_students;의 결과를 비교하고, 두 테이블을 대상으로 쿼리해 보존할 키와 값을 비교하세요. 마이그레이션의 기대 사항에 맞춰 필요한 값과 제약 조건도 확인하세요. 결과가 하나라도 다르면ROLLBACK;을 실행하고 원인을 조사하세요. 원본 테이블은 그대로 남아 있습니다.- 모든 확인을 통과한 뒤에만
DROP TABLE students;와ALTER TABLE new_students RENAME TO students;를 실행하세요. 저장해 둔 인덱스와 트리거를 다시 만들고, 이전 정의에 종속된 뷰와 기타 스키마 객체를 갱신하거나 다시 만드세요. PRAGMA foreign_key_check;를 실행하고 결과 행을 살펴보세요. 위반 사항이 있으면 커밋하지 말고 롤백하세요. 문제가 없으면COMMIT;을 실행합니다. 외래 키 검사를 비활성화했다면 트랜잭션이 끝난 뒤 기록한 설정을 복원하세요(예를 들어 원래 켜져 있었다면PRAGMA foreign_keys = ON;을 실행). 그런 다음 설정이 복원되었는지 확인하세요. 마이그레이션과 애플리케이션 검사가 통과할 때까지 백업을 보관하세요.
이 템플릿은 특정 스키마를 위한 마이그레이션 절차이지, 모든 상황에서 그대로 복사해 쓸 수 있는 스크립트가 아닙니다. 특히 원본을 삭제하기 전에 다른 테이블의 참조를 검토하고, 해당 스키마에 적용되는 외래 키 및 종속 객체 관련 세부 사항은 SQLite의 테이블 재구축 절차를 따르세요. 스키마 속성이 중요한 경우 CREATE TABLE ... AS SELECT는 원래 테이블 정의를 재현하지 못하므로 대체 방법이 아닙니다.
스키마와 데이터 확인
두 방법 중 하나를 적용한 뒤 PRAGMA table_info(students)로 스키마를 살펴보거나 sqlite_schema를 조회해 테이블과 종속 객체를 확인하세요. last_name이 더 이상 나타나지 않는지, 유지된 열에 의도한 정의가 적용되었는지, 예상한 행과 값이 남아 있는지 확인합니다. 재구축했다면 원본을 삭제하기 전에 행 수와 중요한 값을 비교하고, 대체 테이블로 교체한 뒤 인덱스, 트리거, 뷰 및 외래 키 무결성을 확인하세요. 마이그레이션을 실행할 환경에서 이 검사들이 통과할 때까지 백업을 보관하세요.