HOWTO · SQLite
SQLite 데이터베이스에 테이블이 있는지 확인
SQLite에 테이블이 있는지 확인하는 방법을 알아보세요.
이 페이지의 내용
SQLite 데이터베이스에 특정 테이블이 있는지 확인하려면 작업을 시도한 뒤 오류를 처리하는 대신 스키마를 조회하세요. SQLite는 스키마 객체를 sqlite_master에 기록합니다. type과 name을 모두 조건으로 지정하면 같은 이름의 뷰가 테이블로 잘못 계산되지 않습니다. Python에서는 표준 sqlite3 모듈로 바인딩 매개변수를 사용해 해당 쿼리를 실행할 수 있습니다.
sqlite_master를 조회해 테이블 확인하기
스키마 테이블에는 테이블, 인덱스, 뷰, 트리거에 대한 레코드가 들어 있습니다. 다음 쿼리는 요청한 이름을 가진 객체의 유형이 table일 때만 행을 반환합니다.
SELECT name FROM sqlite_master WHERE type = 'table' AND name = ?;
?는 값 자리표시자입니다. 요청한 이름을 SQL에 직접 끼워 넣지 말고 매개변수로 바인딩하세요. 이 비교는 저장된 테이블 이름을 확인할 뿐, 테이블에 특정 열이 있는지 또는 행이 들어 있는지는 확인하지 않습니다. SQLite는 이 스키마 테이블의 내부 이름으로 sqlite_schema도 사용합니다. sqlite_master는 호환성을 유지하는 널리 쓰이는 이름입니다.
Python에서 테이블 확인하기
다음 완전한 예제는 임시 데이터베이스를 만들고 테이블 하나를 생성한 뒤 존재 여부를 확인합니다. 쿼리에서 오류가 발생하더라도 연결을 닫습니다. 임시 파일을 사용하므로 기존 데이터베이스에 영향을 받지 않습니다.
이 예제를 실행하세요.
이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.
import os
import sqlite3
import tempfile
from contextlib import closing
fd, db_path = tempfile.mkstemp(suffix=".db")
os.close(fd)
try:
with closing(sqlite3.connect(db_path)) as connection:
with connection:
connection.execute("CREATE TABLE customers (id INTEGER PRIMARY KEY)")
row = connection.execute(
"SELECT 1 FROM sqlite_master WHERE type = ? AND name = ?",
("table", "customers"),
).fetchone()
print(row is not None)
finally:
os.remove(db_path)
True
fetchone()은 일치하는 항목이 있으면 행을 반환하고, 없으면 None을 반환하므로 이 식은 불리언 값을 출력합니다. 안쪽의 with connection 컨텍스트 관리자는 블록이 성공하면 트랜잭션을 커밋하고 예외가 발생하면 롤백하지만, 연결을 닫지는 않습니다. 바깥쪽의 closing(...) 컨텍스트 관리자는 쿼리에서 예외가 발생한 경우를 포함해 종료 시 연결을 닫습니다. 여러 이름을 확인하려면 매개변수화된 쿼리를 이름마다 반복하거나, 주의해서 구성한 여러 자리표시자에 목록을 바인딩하세요. 값은 SQL 식별자나 SQL 구문 전체를 대신할 수 없습니다.
테이블이 없을 때만 생성하기
테이블이 없을 때 생성하려는 목적이라면 CREATE TABLE IF NOT EXISTS customers (id INTEGER PRIMARY KEY)를 사용하세요. 이는 읽기 전용 존재 확인이 아니라 스키마를 변경하는 작업입니다. SQLite는 이미 있는 테이블을 그대로 두며, 열 구성을 정의와 비교하거나 갱신하지 않습니다. 기존 스키마를 변경해야 한다면 마이그레이션을 사용하세요.
존재 여부를 확인하는 방법으로 포괄적인 OperationalError 처리기를 사용하지 마세요. 이 오류는 잘못된 SQL이나 데이터베이스 접근 실패 같은 다른 문제를 나타낼 수도 있습니다. 오류를 숨기면 실제 원인을 찾기 어려워질 수 있습니다.
PRAGMA table_info로 테이블 열 살펴보기
PRAGMA table_info(customers)는 열 이름과 기본 키 정보 등 테이블의 열 메타데이터를 반환합니다. 테이블을 확인한 다음 구조를 살펴볼 때 유용합니다. 하지만 sqlite_master를 조회하는 존재 확인 쿼리와 같은 용도는 아닙니다. 열 행이 반환되지 않으면 테이블이 없다는 뜻일 수 있지만, 이 명령은 열을 살펴보기 위한 것입니다. 테이블이 있는지가 궁금하다면 스키마 쿼리를 사용하세요.
자주 묻는 질문과 주의할 점
뷰의 존재를 확인하려면 sqlite_master에서 type = 'view' 조건으로 조회하세요. 테이블만 찾는 쿼리는 의도적으로 뷰를 제외합니다. 객체 이름과 같은 데이터 값은 ? 자리표시자로 바인딩하세요. 테이블 이름을 SQL 구문에 넣어야 한다면 자리표시자로 바인딩할 수 없습니다. 허용된 이름 목록과 대조해 검증하고 SQLite에 맞는 올바른 방식으로 인용하세요.
작업에 맞는 방법을 선택하세요. 읽기 전용 존재 확인에는 sqlite_master 조회를, 생성이 목적일 때는 CREATE TABLE IF NOT EXISTS를, 열을 살펴볼 때는 PRAGMA table_info를 사용하세요. Python 모듈 이름은 sqlite3이며, 위에서 사용한 연결 및 매개변수 바인딩 인터페이스를 제공합니다.