// SQLite 오류 참조

SQLITE_TOOBIG: 문자열 또는 BLOB이 너무 큽니다

문자열, BLOB 또는 SQL 명령문이 SQLite의 한도를 넘었습니다. 기본 한도는 1,000,000,000바이트이며, 애플리케이션이 더 낮게 설정했을 수도 있습니다.

결과 코드
SQLITE_TOOBIG
이름
18
카테고리
주요 결과 코드
오류 메시지
string or blob too big

의미

SQLITE_TOOBIG (18)은 문자열이나 BLOB이 최대 길이를 초과할 때 반환됩니다. 최대 길이는 컴파일 시 다음으로 설정합니다 SQLITE_MAX_LENGTH (기본값 1,000,000,000바이트)이며 다음으로 실행 중에 낮출 수도 있습니다 sqlite3_limit(db, SQLITE_LIMIT_LENGTH, ...). 지나치게 큰 SQL 문도 같은 오류가 납니다; 그 한도는 SQLITE_MAX_SQL_LENGTH / SQLITE_LIMIT_SQL_LENGTH. 길이 제한보다 큰 행도 실패합니다.

일반적인 원인

  • 매우 큰 파일이나 문서를 단일 BLOB 또는 TEXT 값에 저장하는 것.
  • 하나의 거대한 SQL 문을 작성하는 경우, 예를 들어 여러 행 INSERT 수백만 개의 리터럴 값으로.
  • 다음으로 한도를 낮춘 애플리케이션 또는 바인딩 sqlite3_limit().
  • A group_concat() 또는 한도를 넘어 자란 문자열 연결.

해결 방법

  1. 큰 파일은 데이터베이스 외부에 저장하고 경로를 유지하거나, 내용을 행 단위로 나누어 저장하세요.

  2. 하나의 거대한 문 대신, 매개변수를 바인딩한 준비된 문(prepared statement)을 반복 실행해 여러 행을 삽입하세요.

    INSERT INTO items (id, name) VALUES (?, ?);  -- prepare once, bind and run per row
  3. 바인딩이 길이 제한을 낮게 설정하는지 확인하고, 적절하다면 제한을 올리세요.

관련 오류

그 밖의 기본 결과 코드 오류

코드와 메시지 텍스트의 출처는 다음과 같습니다 SQLite 결과 및 오류 코드 문서. 전체 목록은 SQLite 오류 목록 또는 모든 데이터베이스 오류 검색.

// 오류는 줄이고, 수정은 빠르게

SQLly에서 SQLite 작업하기

스키마를 아는 IntelliSense, 위험한 문장에 대한 가드레일, 명확한 오류 메시지를 갖춘 macOS, Windows, Linux용 네이티브 SQL 클라이언트입니다. SQLite는 물론 평소 쓰는 다른 데이터베이스까지 지원합니다.