본문으로 건너뛰기
IntoSQL 홈

SQLite 데이터베이스를 이전 또는 최신 SQLite로 옮기기

SQLite 데이터베이스 파일(.db, .sqlite, .sqlite3)이나 sqlite3 .dump가 쓰는 SQL을 놓으면 SQLite 3.31 이상에서 불러와지는 스크립트를 받아요. 각 열은 선언된 타입과 콜레이션을 유지하고, 이전 버전이 테이블을 받도록 STRICT는 빼며, 모든 변경은 보고서에 나와요.

내 파일
sqlshop_2024_sqlite.sql샘플 파일, 3.4kB
내 데이터베이스

18개 행 변환, 수정 없음, 거부 없음

보기

shop_2024_sqlite.sql의 테이블SQLite 덤프 · sqlite3(으)로 작성됨 · utf-8

  • customers8개 행
    7개 열
    idINTEGER not null
    nameTEXT not null
    emailTEXT not null
    countryTEXT not null
    is_activeINTEGER not null
    signed_upDATE
    created_atDATETIME not null
  • orders10개 행
    9개 열
    idINTEGER not null
    customer_idINTEGER not null
    statusTEXT not null
    totalDECIMAL(10,2) not null
    itemsINTEGER not null
    ordered_atDATETIME not null
    shipped_atDATETIME
    noteTEXT
    receiptBLOB

변환되지 않음

  • 뷰 order_totals
  • 트리거 orders_shipped

데이터베이스마다 이 객체를 자체 언어로 작성해요. SQLite에 맞게 다시 작성하세요.

-- Written by IntoSQL from a SQLite dump. Load it with: sqlite3 -bail <database> < <file>
PRAGMA foreign_keys = OFF;
PRAGMA synchronous = OFF;
BEGIN;

CREATE TABLE customers (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    name TEXT NOT NULL,
    email TEXT COLLATE NOCASE NOT NULL,
    country TEXT DEFAULT 'US' NOT NULL,
    is_active INTEGER DEFAULT 1 NOT NULL,
    signed_up DATE,
    created_at DATETIME DEFAULT (datetime('now', 'localtime')) NOT NULL,
    CONSTRAINT customers_is_active_check CHECK (is_active IN (0, 1)),
    CONSTRAINT customers_check1 CHECK (length(country) = 2)
);

CREATE TABLE orders (
    id INTEGER PRIMARY KEY AUTOINCREMENT,
    customer_id INTEGER NOT NULL,
    status TEXT DEFAULT 'pending' NOT NULL,
    total DECIMAL(10,2) NOT NULL,
    items INTEGER DEFAULT 1 NOT NULL,
    ordered_at DATETIME NOT NULL,
    shipped_at DATETIME,
    note TEXT,
    receipt BLOB,
    CONSTRAINT orders_check1 CHECK (status IN ('pending', 'paid', 'shipped', 'cancelled')),
    CONSTRAINT orders_fkey FOREIGN KEY (customer_id) REFERENCES customers (id) ON DELETE CASCADE
);

INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(1,'Ana Martínez','ana@example.com','MX',1,'2023-01-15','2023-01-15 10:24:00');
INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(2,'Zoë Müller','zoe@example.de','DE',1,'2023-02-03','2023-02-03 08:11:42');
INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(3,'José Peña','jose@example.es','ES',0,'2023-03-21','2023-03-21 19:05:17');
INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(4,'李雷','lilei@example.cn','CN',1,'2023-05-09','2023-05-09 02:40:00');
INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(5,'Noah O''Brien','noah@example.ie','IE',1,NULL,'2023-06-30 14:00:00');
INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(6,'Amélie Laurent','amelie@example.fr','FR',1,'2024-01-02','2024-01-02 09:30:00');
INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(7,'Ravi Patel','ravi@example.in','IN',0,'2024-02-29','2024-02-29 23:59:59');
INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(8,'Sofia Rossi 🌻','sofia@example.it','IT',1,'2024-04-12','2024-04-12 12:12:12');
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(1,1,'shipped',129.9,3,'2024-03-01 10:00:00','2024-03-02 16:30:00',NULL,NULL);
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(2,2,'paid',54,1,'2024-03-02 11:15:00',NULL,'Gift wrap 🎁',NULL);
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(3,1,'cancelled',12.5,1,'2024-03-03 09:45:00',NULL,'Customer changed their mind',NULL);
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(4,4,'shipped',980,12,'2024-03-05 02:10:00','2024-03-07 08:00:00','请小心轻放',X'25504446');
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(5,5,'pending',45.75,2,'2024-03-08 17:20:00',NULL,'Leave at the door;
ring twice',NULL);
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(6,6,'shipped',310.4,5,'2024-03-10 13:00:00','2024-03-11 09:00:00','Fragile: "glass"',NULL);
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(7,8,'paid',76.2,2,'2024-03-11 18:45:00',NULL,NULL,NULL);
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(8,2,'paid',19.99,1,'2024-03-12 08:00:00',NULL,'Paid at the counter',NULL);
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(9,3,'shipped',64,2,'2024-03-14 15:30:00',NULL,'Shipping date never recorded',NULL);
INSERT INTO orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) VALUES
(10,7,'paid',1499,1,'2024-03-15 21:05:00',NULL,'C:\Users\ravi\invoice.pdf',NULL);

-- Indexes, triggers and counters, after the rows so each index builds once.
CREATE UNIQUE INDEX customers_email ON customers (email);
CREATE INDEX orders_idx_orders_customer ON orders (customer_id);
CREATE INDEX orders_idx_orders_status_date ON orders (status, ordered_at);
UPDATE sqlite_sequence SET seq = max(seq, 8) WHERE name = 'customers';
INSERT INTO sqlite_sequence (name, seq) SELECT 'customers', 8 WHERE NOT EXISTS (SELECT 1 FROM sqlite_sequence WHERE name = 'customers');
UPDATE sqlite_sequence SET seq = max(seq, 10) WHERE name = 'orders';
INSERT INTO sqlite_sequence (name, seq) SELECT 'orders', 10 WHERE NOT EXISTS (SELECT 1 FROM sqlite_sequence WHERE name = 'orders');
COMMIT;

-- Rows whose foreign key finds no parent, if any: the load doesn't stop for them.
PRAGMA foreign_key_check;

수정 사항

수정할 부분이 없었어요.

확인 필요

  • 뷰, 트리거, 루틴, 이벤트 2개가 변환되지 않았어요. 보고서에 각각 나와 있어요. SQLite에서 직접 다시 만드세요.

파일은 이 컴퓨터에서 변환되고 업로드되지 않아요.

다른 샘플:

파일과 스크립트에서 바뀌는 점

각 행은 변환기가 적용하는 규칙이며, 규칙이 데이터를 바꿀 때 보고서에 쓰는 줄이 함께 나와요.

  • declared types (any text: VARCHAR(255), DATETIME, BOOLEAN, JSON or none)

    열의 모든 값이 들어가는 타입

    선언된 타입이 같아서 값은 저장된 그대로 불러와져요.

  • BOOLEAN, BOOL

    CHECK가 붙은 INTEGER 0 또는 1

    모든 값이 0 또는 1일 때예요. 다른 값도 담은 열은 그 값을 숫자나 텍스트로 유지해요.

  • TEXT, VARCHAR(n), CHAR(n), CLOB

    선언된 타입을 그대로 유지

    SQLite는 길이를 강제하지 않아요. 선언된 길이는 모든 값이 들어갈 때만 유지해요.

  • DECIMAL(p,s), NUMERIC

    모든 값이 들어가면 정확한 타입, 아니면 double

    SQLite는 이 값을 정수나 double로 저장해요. 선언된 정밀도는 값이 들어갈 때만 유지해요.

  • BLOB, and columns holding bytes

    BLOB

    바이트는 바이트로 남아요. 같은 열에 있는 텍스트와 숫자는 그 바이트로 유지해요.

  • DATE, DATETIME, TIMESTAMP holding ISO 8601 text

    DATE, DATETIME을 ISO 8601 텍스트로

    모든 값이 날짜 또는 날짜와 시간일 때예요. 에포크 숫자와 다른 텍스트는 값을 그대로 유지해요.

  • JSON holding JSON text

    TEXT

    모든 값이 JSON 객체나 배열일 때예요.

  • Infinity in REAL columns

    9e999, SQLite 고유의 무한대

    SQLite는 무한대를 오버플로하는 리터럴로 쓰고, 불러오면 다시 무한대가 돼요.

  • INTEGER PRIMARY KEY, AUTOINCREMENT

    INTEGER PRIMARY KEY, AUTOINCREMENT 유지

    정확히 INTEGER PRIMARY KEY로 선언된 열만 rowid예요. 모든 행은 id를 유지하고, 카운터는 지금까지 부여된 가장 큰 id 다음부터 시작해요.

  • COLLATE NOCASE

    COLLATE NOCASE

    같은 콜레이션이에요.

  • generated columns

    생성 열, 원본과 같이 STORED 또는 VIRTUAL

    SQLite도 같은 방식으로 계산해요.

  • generated columns with functions IntoSQL doesn't write, and the || operator

    일반 열

    쓸 수 없는 수식은 일반 열로 남고 보고서에 한 줄 기록돼요. 덤프에는 생성 열의 값이 없어요.

    보고서 줄: generated_not_translated

  • defaults with functions IntoSQL doesn't write (strftime, randomblob)

    기본값 없음

    쓸 수 없는 기본값은 제외하고 보고해요. CURRENT_TIMESTAMP와 datetime('now')는 써요.

    보고서 줄: default_not_translated

  • CHECK constraints

    변환됨

    같은 체크 제약이고, 각 행을 불러올 때 검사해요.

  • CHECK constraints with functions IntoSQL doesn't write

    만들지 않음

    쓸 수 없는 체크 제약은 제외하고 보고해요.

    보고서 줄: check_skipped

  • partial and expression indexes

    만들지 않음

    IntoSQL은 열 전체에 대한 인덱스를 써요. 다른 인덱스는 불러온 뒤 다시 만드세요.

    보고서 줄: index_skipped

  • foreign keys (unenforced unless PRAGMA foreign_keys=ON)

    같은 외래 키, PRAGMA foreign_key_check로 나열

    SQLite는 지시받을 때만 외래 키를 검사하므로 부모 행이 없는 행이 흔해요. 그런 행도 불러오고, 불러오기를 멈추지 않고 경고와 함께 키를 검사하지 않은 상태로 남겨요.

  • foreign keys to tables the dump doesn't create

    만들지 않음

    키는 없는 테이블을 가리킬 수 없어요.

    보고서 줄: foreign_key_skipped

  • primary keys holding NULL, and NOT NULL columns with values that become NULL

    NOT NULL 제거

    SQLite에서는 rowid가 아닌 기본 키가 NULL을 담을 수 있어요. 대상에서 그 열은 NOT NULL일 수 없어요. 그러면 불러오기가 멈춰요.

    보고서 줄: not_null_relaxed

  • views, triggers and virtual tables (FTS, R*Tree)

    보고서에 나열

    코드는 SQLite의 자체 언어로 작성되고, 가상 테이블에는 SQLite의 모듈이 필요해요. 다시 만들 수 있도록 나열해요. 내부 테이블은 복사하지 않아요.

    보고서 줄: not_converted_objects

  • dumps without CREATE TABLE (--data-only)

    값으로 판단한 타입

    데이터만 있는 덤프에는 행만 있어서 타입을 값으로 판단하고 열에는 번호가 붙어요.

    보고서 줄: no_schema

  • expressions in INSERT values other than the text functions dumps write

    NULL

    unistr(), replace(), char(), ||는 셸이 쓰는 그대로 계산해요. 다른 식은 데이터베이스 없이 계산할 수 없어요.

    보고서 줄: expression_value

  • NUL characters in text

    유지

    sqlite3 셸과 Python은 덤프할 때 NUL 문자에서 텍스트를 잘라서, 덤프에는 그 앞부분만 들어 있어요.

  • text that isn't valid UTF-8

    잘못된 바이트를 대체 문자로

    덤프는 이런 텍스트를 원시 바이트로 써요. 스크립트는 UTF-8이에요.

    보고서 줄: invalid_utf8_replaced

  • text decoded twice (ñ)

    그대로 복사

    덤프에 정확히 이 문자들이 있으므로 그대로 복사하고, 보고서에서 알려 줘요.

    보고서 줄: mojibake_suspected

파일에서스크립트에서보고서 줄
declared types (any text: VARCHAR(255), DATETIME, BOOLEAN, JSON or none)열의 모든 값이 들어가는 타입선언된 타입이 같아서 값은 저장된 그대로 불러와져요.
BOOLEAN, BOOLCHECK가 붙은 INTEGER 0 또는 1모든 값이 0 또는 1일 때예요. 다른 값도 담은 열은 그 값을 숫자나 텍스트로 유지해요.
TEXT, VARCHAR(n), CHAR(n), CLOB선언된 타입을 그대로 유지SQLite는 길이를 강제하지 않아요. 선언된 길이는 모든 값이 들어갈 때만 유지해요.
DECIMAL(p,s), NUMERIC모든 값이 들어가면 정확한 타입, 아니면 doubleSQLite는 이 값을 정수나 double로 저장해요. 선언된 정밀도는 값이 들어갈 때만 유지해요.
BLOB, and columns holding bytesBLOB바이트는 바이트로 남아요. 같은 열에 있는 텍스트와 숫자는 그 바이트로 유지해요.
DATE, DATETIME, TIMESTAMP holding ISO 8601 textDATE, DATETIME을 ISO 8601 텍스트로모든 값이 날짜 또는 날짜와 시간일 때예요. 에포크 숫자와 다른 텍스트는 값을 그대로 유지해요.
JSON holding JSON textTEXT모든 값이 JSON 객체나 배열일 때예요.
Infinity in REAL columns9e999, SQLite 고유의 무한대SQLite는 무한대를 오버플로하는 리터럴로 쓰고, 불러오면 다시 무한대가 돼요.
INTEGER PRIMARY KEY, AUTOINCREMENTINTEGER PRIMARY KEY, AUTOINCREMENT 유지정확히 INTEGER PRIMARY KEY로 선언된 열만 rowid예요. 모든 행은 id를 유지하고, 카운터는 지금까지 부여된 가장 큰 id 다음부터 시작해요.
COLLATE NOCASECOLLATE NOCASE같은 콜레이션이에요.
generated columns생성 열, 원본과 같이 STORED 또는 VIRTUALSQLite도 같은 방식으로 계산해요.
generated columns with functions IntoSQL doesn't write, and the || operator일반 열쓸 수 없는 수식은 일반 열로 남고 보고서에 한 줄 기록돼요. 덤프에는 생성 열의 값이 없어요.generated_not_translated
defaults with functions IntoSQL doesn't write (strftime, randomblob)기본값 없음쓸 수 없는 기본값은 제외하고 보고해요. CURRENT_TIMESTAMP와 datetime('now')는 써요.default_not_translated
CHECK constraints변환됨같은 체크 제약이고, 각 행을 불러올 때 검사해요.
CHECK constraints with functions IntoSQL doesn't write만들지 않음쓸 수 없는 체크 제약은 제외하고 보고해요.check_skipped
partial and expression indexes만들지 않음IntoSQL은 열 전체에 대한 인덱스를 써요. 다른 인덱스는 불러온 뒤 다시 만드세요.index_skipped
foreign keys (unenforced unless PRAGMA foreign_keys=ON)같은 외래 키, PRAGMA foreign_key_check로 나열SQLite는 지시받을 때만 외래 키를 검사하므로 부모 행이 없는 행이 흔해요. 그런 행도 불러오고, 불러오기를 멈추지 않고 경고와 함께 키를 검사하지 않은 상태로 남겨요.
foreign keys to tables the dump doesn't create만들지 않음키는 없는 테이블을 가리킬 수 없어요.foreign_key_skipped
primary keys holding NULL, and NOT NULL columns with values that become NULLNOT NULL 제거SQLite에서는 rowid가 아닌 기본 키가 NULL을 담을 수 있어요. 대상에서 그 열은 NOT NULL일 수 없어요. 그러면 불러오기가 멈춰요.not_null_relaxed
views, triggers and virtual tables (FTS, R*Tree)보고서에 나열코드는 SQLite의 자체 언어로 작성되고, 가상 테이블에는 SQLite의 모듈이 필요해요. 다시 만들 수 있도록 나열해요. 내부 테이블은 복사하지 않아요.not_converted_objects
dumps without CREATE TABLE (--data-only)값으로 판단한 타입데이터만 있는 덤프에는 행만 있어서 타입을 값으로 판단하고 열에는 번호가 붙어요.no_schema
expressions in INSERT values other than the text functions dumps writeNULLunistr(), replace(), char(), ||는 셸이 쓰는 그대로 계산해요. 다른 식은 데이터베이스 없이 계산할 수 없어요.expression_value
NUL characters in text유지sqlite3 셸과 Python은 덤프할 때 NUL 문자에서 텍스트를 잘라서, 덤프에는 그 앞부분만 들어 있어요.
text that isn't valid UTF-8잘못된 바이트를 대체 문자로덤프는 이런 텍스트를 원시 바이트로 써요. 스크립트는 UTF-8이에요.invalid_utf8_replaced
text decoded twice (ñ)그대로 복사덤프에 정확히 이 문자들이 있으므로 그대로 복사하고, 보고서에서 알려 줘요.mojibake_suspected

스크립트를 SQLite에 불러오기

스크립트는 테이블을 만들고 행을 복사한 다음 키, 인덱스, 외래 키를 추가해요. 그래서 빨리 불러오고 첫 오류에서 멈춰요.

sqlite3 -bail mydb.sqlite < sqlite.sqlite.sql

외래 키는 각 테이블 안에 선언하고, 행은 외래 키 검사를 끈 채로 불러와요. 그런 다음 스크립트는 중간에 실패하지 않고, 존재하지 않는 행을 가리키는 행을 모두 나열해요.

큰 덤프는 로컬 디스크의 새 파일로 불러오세요. 스크립트는 동기화를 끈 하나의 트랜잭션으로 모두 불러오므로 디스크 속도로 실행되고, 중간에 멈춰도 일부만 채워진 테이블이 남지 않아요.

명령줄은 파일을 SQLite 데이터베이스에 바로 불러와요. 스크립트를 따로 만들 필요가 없고 무료예요.

좋은 결과를 위한 SQLite 덤프 방법

변환기는 덤프에 담긴 내용을 읽어요. 다음 옵션을 쓰면 더 많은 데이터가 덤프에 남아요:

  • 데이터베이스 파일 자체를 그대로 변환하며, 브라우저에서 페이지 단위로 읽어요. 변경 사항이 -wal 파일에 남지 않도록 먼저 파일에 쓰고 있는 앱을 닫으세요.
  • sqlite3 app.db .dump > app.sql은 같은 데이터베이스를 SQL로 써요. 이 SQL도 .sql 또는 .sql.gz로 변환돼요.
  • DB Browser for SQLite에서는 File, Export, Database to SQL file 순서로 선택하면 그 SQL을 써요. Python의 iterdump()도 마찬가지예요.

변환되지 않는 것

뷰, 트리거, 프로시저, 함수 등 SQLite 자체 언어로 작성된 객체는 몰래 빠지지 않고 보고서에 이름으로 나와요. 불러올 SQLite 버전에서 확인한 뒤 다시 만들 수 있어요.

SQLite 버전 간 이동 질문

여기에 답이 없나요? 문의 페이지로 연락하시면 담당자가 답장해요. 문의 페이지

덤프가 업로드되나요?

아니요. 변환기는 브라우저에서 실행되고 디스크의 덤프를 조각조각 읽으므로, 덤프가 컴퓨터 밖으로 나가지 않아요. 데스크톱 앱과 명령줄도 컴퓨터에서 변환해요.

덤프는 얼마나 커도 되나요?

변환기는 덤프 전체를 메모리에 올리지 않아요. 파일을 범위별로 두 번 읽고, 읽는 대로 스크립트를 써요. 수 GB 덤프도 브라우저, 데스크톱 앱, 명령줄에서 변환돼요.

.db 파일 자체를 변환할 수 있나요?

네. .db, .sqlite 또는 .sqlite3 파일을 놓으세요. 브라우저에서 읽고 업로드하지 않아요. NUL 문자가 든 텍스트와 double 값의 모든 자릿수가 저장된 그대로 들어오며, .dump에서는 이 부분이 잘릴 수 있어요.

어떤 SQLite 버전의 덤프를 읽나요?

SQLite 3.0 이상의 UTF-8 또는 UTF-16 데이터베이스 파일과, sqlite3 셸의 .dump나 Python의 iterdump()로 만든 덤프예요. 모든 테스트 파일과 덤프는 sqlite3 3.31부터 3.54까지에서 만들고, STRICT와 WITHOUT ROWID 테이블을 포함해 원본과 셀 단위로 비교해요.

SQLite이(가) 타입을 강제하지 않을 때 열 타입은 어떻게 정해지나요?

각 열은 선언된 타입을 유지하고, COLLATE NOCASE와 RTRIM도 그대로예요. STRICT는 빼므로 스크립트는 3.31 이후 모든 버전에서 불러와져요.

INTEGER PRIMARY KEY와 AUTOINCREMENT는 유지되나요?

네. INTEGER PRIMARY KEY와 AUTOINCREMENT는 그대로 유지되고, sqlite_sequence는 덤프 시점의 값부터 이어져요.

뷰와 트리거는 어떻게 되나요?

변환하지 않고 보고서에 이름으로 나열하므로, 테이블을 불러온 뒤 다시 만들 수 있어요.

스크립트는 어떤 SQLite 버전에서 불러올 수 있나요?

SQLite 3.31 이상이에요. 모든 테스트 파일과 덤프를 3.31과 3.54에서 불러오며, 문제가 생기면 첫 오류에서 멈춰요.