Chuyển SQLite sang PostgreSQL
Thả tệp cơ sở dữ liệu SQLite (.db, .sqlite, .sqlite3) hoặc đoạn SQL mà lệnh .dump của sqlite3 ghi ra, và tải xuống tập lệnh PostgreSQL với cùng bảng, khóa, chỉ mục và dữ liệu. Mỗi cột nhận kiểu mà giá trị của nó vừa, và mọi giá trị PostgreSQL không chứa được nguyên trạng đều được liệt kê trong báo cáo.
Đã chuyển đổi 18 hàng, không có bản sửa, không hàng nào bị từ chối
Các bảng trong shop_2024_sqlite.sqlBản dump SQLite · do sqlite3 ghi · utf-8
customers8 hàng
7 cột id bigint not null name text not null email text not null country text not null is_active boolean not null signed_up date created_at timestamp(0) not null orders10 hàng
9 cột id bigint not null customer_id bigint not null status text not null total numeric(10,2) not null items integer not null ordered_at timestamp(0) not null shipped_at timestamp(0) note text receipt bytea
Không được chuyển đổi
- Khung nhìn order_totals
- Trình kích hoạt orders_shipped
Mỗi cơ sở dữ liệu viết các đối tượng này bằng ngôn ngữ riêng. Hãy viết lại chúng cho PostgreSQL.
-- Written by IntoSQL from a SQLite dump. Load it with: psql -v ON_ERROR_STOP=1 -f <file>
SET client_encoding = 'UTF8';
SET standard_conforming_strings = on;
SET check_function_bodies = false;
SET client_min_messages = warning;
SET synchronous_commit = off;
SET maintenance_work_mem = '512MB';
CREATE TABLE customers (
id bigint GENERATED BY DEFAULT AS IDENTITY NOT NULL,
name text NOT NULL,
email text NOT NULL,
country text DEFAULT 'US' NOT NULL,
is_active boolean DEFAULT true NOT NULL,
signed_up date,
created_at timestamp(0) DEFAULT LOCALTIMESTAMP NOT NULL,
CONSTRAINT customers_check1 CHECK (char_length(country) = 2)
);
CREATE TABLE orders (
id bigint GENERATED BY DEFAULT AS IDENTITY NOT NULL,
customer_id bigint NOT NULL,
status text DEFAULT 'pending' NOT NULL,
total numeric(10,2) NOT NULL,
items integer DEFAULT 1 NOT NULL,
ordered_at timestamp(0) NOT NULL,
shipped_at timestamp(0),
note text,
receipt bytea,
CONSTRAINT orders_check1 CHECK (status IN ('pending', 'paid', 'shipped', 'cancelled'))
);
COPY customers (id, name, email, country, is_active, signed_up, created_at) FROM stdin;
1 Ana Martínez ana@example.com MX t 2023-01-15 2023-01-15 10:24:00
2 Zoë Müller zoe@example.de DE t 2023-02-03 2023-02-03 08:11:42
3 José Peña jose@example.es ES f 2023-03-21 2023-03-21 19:05:17
4 李雷 lilei@example.cn CN t 2023-05-09 2023-05-09 02:40:00
5 Noah O'Brien noah@example.ie IE t \N 2023-06-30 14:00:00
6 Amélie Laurent amelie@example.fr FR t 2024-01-02 2024-01-02 09:30:00
7 Ravi Patel ravi@example.in IN f 2024-02-29 2024-02-29 23:59:59
8 Sofia Rossi 🌻 sofia@example.it IT t 2024-04-12 2024-04-12 12:12:12
\.
COPY orders (id, customer_id, status, total, items, ordered_at, shipped_at, note, receipt) FROM stdin;
1 1 shipped 129.9 3 2024-03-01 10:00:00 2024-03-02 16:30:00 \N \N
2 2 paid 54 1 2024-03-02 11:15:00 \N Gift wrap 🎁 \N
3 1 cancelled 12.5 1 2024-03-03 09:45:00 \N Customer changed their mind \N
4 4 shipped 980 12 2024-03-05 02:10:00 2024-03-07 08:00:00 请小心轻放 \\x25504446
5 5 pending 45.75 2 2024-03-08 17:20:00 \N Leave at the door;\nring twice \N
6 6 shipped 310.4 5 2024-03-10 13:00:00 2024-03-11 09:00:00 Fragile: "glass" \N
7 8 paid 76.2 2 2024-03-11 18:45:00 \N \N \N
8 2 paid 19.99 1 2024-03-12 08:00:00 \N Paid at the counter \N
9 3 shipped 64 2 2024-03-14 15:30:00 \N Shipping date never recorded \N
10 7 paid 1499 1 2024-03-15 21:05:00 \N C:\\Users\\ravi\\invoice.pdf \N
\.
-- Keys, indexes and constraints, after the rows so each builds once.
CREATE UNIQUE INDEX customers_pkey ON customers (id);
CREATE UNIQUE INDEX customers_email ON customers (email);
CREATE UNIQUE INDEX orders_pkey ON orders (id);
CREATE INDEX orders_idx_orders_customer ON orders (customer_id);
CREATE INDEX orders_idx_orders_status_date ON orders (status, ordered_at);
ALTER TABLE customers ADD CONSTRAINT customers_pkey PRIMARY KEY USING INDEX customers_pkey;
ALTER TABLE customers ADD CONSTRAINT customers_email UNIQUE USING INDEX customers_email;
ALTER TABLE orders ADD CONSTRAINT orders_pkey PRIMARY KEY USING INDEX orders_pkey;
ALTER TABLE orders ADD CONSTRAINT orders_fkey FOREIGN KEY (customer_id) REFERENCES customers (id) ON DELETE CASCADE NOT VALID;
DO $f$ BEGIN
ALTER TABLE orders VALIDATE CONSTRAINT orders_fkey;
EXCEPTION WHEN foreign_key_violation THEN
RAISE WARNING 'foreign key % has rows without a parent: it stays NOT VALID, and new rows are checked', 'orders_fkey';
END $f$;
SELECT setval(pg_get_serial_sequence('customers', 'id'), LEAST(GREATEST(COALESCE((SELECT max(id) FROM customers)::numeric, 0) + 1, 9), 9223372036854775807)::bigint, false);
SELECT setval(pg_get_serial_sequence('orders', 'id'), LEAST(GREATEST(COALESCE((SELECT max(id) FROM orders)::numeric, 0) + 1, 11), 9223372036854775807)::bigint, false);
Bản sửa
Không có gì cần sửa.
Cần xem lại
- 1 cột văn bản trong nguồn so sánh không phân biệt hoa thường; PostgreSQL so sánh chính xác, nên khóa duy nhất và tìm kiếm có thể hoạt động khác. Hãy dùng một collation hoặc kiểu cột không phân biệt hoa thường cho các cột cần điều đó.
- 2 khung nhìn, trình kích hoạt, thủ tục hoặc sự kiện không được chuyển đổi; báo cáo liệt kê từng mục. Hãy tạo lại chúng thủ công trong PostgreSQL.
Tệp được chuyển đổi ngay trên máy tính này và không bao giờ được tải lên.
Mẫu khác:
Những gì thay đổi từ SQLite sang PostgreSQL
Mỗi hàng là một quy tắc trình chuyển đổi áp dụng, kèm dòng báo cáo được ghi khi quy tắc thay đổi dữ liệu của bạn.
declared types (any text: VARCHAR(255), DATETIME, BOOLEAN, JSON or none)
kiểu mà mọi giá trị trong cột đều vừa
SQLite giữ mọi giá trị trong mọi cột, nên kiểu đã khai báo chỉ là gợi ý: mỗi cột nhận kiểu mà mọi giá trị của nó đều vừa, và cột chứa giá trị hỗn hợp giữ văn bản của chúng.
BOOLEAN, BOOL
boolean
Khi mọi giá trị là 0 hoặc 1; cột còn chứa giá trị khác thì giữ chúng dưới dạng số hoặc văn bản.
TEXT, VARCHAR(n), CHAR(n), CLOB
varchar(n) khi mọi giá trị vừa độ dài đã khai báo, nếu không thì text
SQLite không bao giờ áp đặt độ dài; độ dài đã khai báo chỉ được giữ khi mọi giá trị đều vừa.
DECIMAL(p,s), NUMERIC
kiểu chính xác khi mọi giá trị đều vừa, nếu không thì double
SQLite lưu chúng dưới dạng số nguyên hoặc double; độ chính xác đã khai báo chỉ được giữ khi các giá trị vừa.
BLOB, and columns holding bytes
bytea
Byte vẫn là byte; văn bản và số trong cùng cột được giữ dưới dạng byte của chúng.
DATE, DATETIME, TIMESTAMP holding ISO 8601 text
date, timestamp
Khi mọi giá trị là ngày hoặc ngày và giờ; số epoch và văn bản khác giữ nguyên giá trị.
JSON holding JSON text
jsonb
Khi mọi giá trị là đối tượng hoặc mảng JSON.
Infinity in REAL columns
Infinity, như double của PostgreSQL giữ nó
Double của PostgreSQL chứa được vô cực.
INTEGER PRIMARY KEY, AUTOINCREMENT
GENERATED BY DEFAULT AS IDENTITY, tiếp tục sau id lớn nhất hoặc giá trị của sqlite_sequence
Chỉ cột được khai báo đúng là INTEGER PRIMARY KEY mới là rowid; mỗi hàng giữ id của nó, và bộ đếm bắt đầu sau id lớn nhất từng được cấp.
COLLATE NOCASE
so sánh chính xác
PostgreSQL so sánh văn bản chính xác trừ khi được chỉ định khác; cột NOCASE mất khả năng không phân biệt hoa thường.
Dòng báo cáo: case_insensitive_collation
generated columns
STORED
PostgreSQL 13 đến 17 chỉ lưu cột tính toán; công thức giữ nguyên.
Dòng báo cáo: virtual_as_stored
generated columns with functions IntoSQL doesn't write, and the || operator
một cột thường
Công thức không viết được để lại một cột thường và một dòng trong báo cáo; bản dump không có giá trị cho cột tính toán.
Dòng báo cáo: generated_not_translated
defaults with functions IntoSQL doesn't write (strftime, randomblob)
không có giá trị mặc định
Giá trị mặc định không viết được sẽ bị bỏ và được báo cáo; CURRENT_TIMESTAMP và datetime('now') vẫn được viết.
Dòng báo cáo: default_not_translated
CHECK constraints
được chuyển đổi
Cùng các ràng buộc kiểm tra, được kiểm tra khi từng hàng được nạp.
CHECK constraints with functions IntoSQL doesn't write
không được tạo
Ràng buộc kiểm tra không viết được sẽ bị bỏ và được báo cáo.
Dòng báo cáo: check_skipped
partial and expression indexes
không được tạo
IntoSQL ghi chỉ mục trên toàn bộ cột; hãy tạo lại các chỉ mục khác sau khi nạp.
Dòng báo cáo: index_skipped
foreign keys (unenforced unless PRAGMA foreign_keys=ON)
khóa ngoại, NOT VALID rồi xác thực
SQLite chỉ kiểm tra khóa ngoại khi được yêu cầu, nên hàng không có hàng cha khá phổ biến: chúng vẫn được nạp, và khóa ở trạng thái chưa kiểm tra kèm cảnh báo thay vì dừng quá trình nạp.
foreign keys to tables the dump doesn't create
không được tạo
Khóa không thể tham chiếu tới bảng không tồn tại.
Dòng báo cáo: foreign_key_skipped
primary keys holding NULL, and NOT NULL columns with values that become NULL
bỏ NOT NULL
SQLite cho phép khóa chính không phải rowid chứa NULL; cột không thể là NOT NULL ở đích, nếu không quá trình nạp sẽ dừng.
Dòng báo cáo: not_null_relaxed
views, triggers and virtual tables (FTS, R*Tree)
được liệt kê trong báo cáo
Mã của chúng viết bằng ngôn ngữ riêng của SQLite, và bảng ảo cần các mô-đun của SQLite; chúng được liệt kê để bạn tạo lại. Các bảng nội bộ của chúng không được sao chép.
Dòng báo cáo: not_converted_objects
dumps without CREATE TABLE (--data-only)
kiểu suy ra từ giá trị
Bản dump chỉ có dữ liệu thì chỉ có các hàng, nên kiểu được suy ra từ giá trị và các cột được đánh số.
Dòng báo cáo: no_schema
expressions in INSERT values other than the text functions dumps write
NULL
unistr(), replace(), char() và || được tính như cách shell ghi chúng; các biểu thức khác không tính được nếu không có cơ sở dữ liệu.
Dòng báo cáo: expression_value
NUL characters in text
bị xóa
Shell sqlite3 và Python cắt văn bản tại ký tự NUL khi dump, nên chỉ phần đứng trước nó có trong bản dump. Văn bản PostgreSQL cũng không chứa được ký tự này.
Dòng báo cáo: nul_removed
text that isn't valid UTF-8
byte lỗi thành ký tự thay thế
Bản dump ghi văn bản như vậy dưới dạng byte thô; tập lệnh là UTF-8.
Dòng báo cáo: invalid_utf8_replaced
text decoded twice (ñ)
sao chép nguyên trạng
Bản dump chứa đúng các ký tự này, nên chúng được sao chép; báo cáo chỉ ra chúng.
Dòng báo cáo: mojibake_suspected
| Trong SQLite | Trong PostgreSQL | Dòng báo cáo |
|---|---|---|
| declared types (any text: VARCHAR(255), DATETIME, BOOLEAN, JSON or none) | kiểu mà mọi giá trị trong cột đều vừaSQLite giữ mọi giá trị trong mọi cột, nên kiểu đã khai báo chỉ là gợi ý: mỗi cột nhận kiểu mà mọi giá trị của nó đều vừa, và cột chứa giá trị hỗn hợp giữ văn bản của chúng. | |
| BOOLEAN, BOOL | booleanKhi mọi giá trị là 0 hoặc 1; cột còn chứa giá trị khác thì giữ chúng dưới dạng số hoặc văn bản. | |
| TEXT, VARCHAR(n), CHAR(n), CLOB | varchar(n) khi mọi giá trị vừa độ dài đã khai báo, nếu không thì textSQLite không bao giờ áp đặt độ dài; độ dài đã khai báo chỉ được giữ khi mọi giá trị đều vừa. | |
| DECIMAL(p,s), NUMERIC | kiểu chính xác khi mọi giá trị đều vừa, nếu không thì doubleSQLite lưu chúng dưới dạng số nguyên hoặc double; độ chính xác đã khai báo chỉ được giữ khi các giá trị vừa. | |
| BLOB, and columns holding bytes | byteaByte vẫn là byte; văn bản và số trong cùng cột được giữ dưới dạng byte của chúng. | |
| DATE, DATETIME, TIMESTAMP holding ISO 8601 text | date, timestampKhi mọi giá trị là ngày hoặc ngày và giờ; số epoch và văn bản khác giữ nguyên giá trị. | |
| JSON holding JSON text | jsonbKhi mọi giá trị là đối tượng hoặc mảng JSON. | |
| Infinity in REAL columns | Infinity, như double của PostgreSQL giữ nóDouble của PostgreSQL chứa được vô cực. | |
| INTEGER PRIMARY KEY, AUTOINCREMENT | GENERATED BY DEFAULT AS IDENTITY, tiếp tục sau id lớn nhất hoặc giá trị của sqlite_sequenceChỉ cột được khai báo đúng là INTEGER PRIMARY KEY mới là rowid; mỗi hàng giữ id của nó, và bộ đếm bắt đầu sau id lớn nhất từng được cấp. | |
| COLLATE NOCASE | so sánh chính xácPostgreSQL so sánh văn bản chính xác trừ khi được chỉ định khác; cột NOCASE mất khả năng không phân biệt hoa thường. | case_insensitive_collation |
| generated columns | STOREDPostgreSQL 13 đến 17 chỉ lưu cột tính toán; công thức giữ nguyên. | virtual_as_stored |
| generated columns with functions IntoSQL doesn't write, and the || operator | một cột thườngCông thức không viết được để lại một cột thường và một dòng trong báo cáo; bản dump không có giá trị cho cột tính toán. | generated_not_translated |
| defaults with functions IntoSQL doesn't write (strftime, randomblob) | không có giá trị mặc địnhGiá trị mặc định không viết được sẽ bị bỏ và được báo cáo; CURRENT_TIMESTAMP và datetime('now') vẫn được viết. | default_not_translated |
| CHECK constraints | được chuyển đổiCùng các ràng buộc kiểm tra, được kiểm tra khi từng hàng được nạp. | |
| CHECK constraints with functions IntoSQL doesn't write | không được tạoRàng buộc kiểm tra không viết được sẽ bị bỏ và được báo cáo. | check_skipped |
| partial and expression indexes | không được tạoIntoSQL ghi chỉ mục trên toàn bộ cột; hãy tạo lại các chỉ mục khác sau khi nạp. | index_skipped |
| foreign keys (unenforced unless PRAGMA foreign_keys=ON) | khóa ngoại, NOT VALID rồi xác thựcSQLite chỉ kiểm tra khóa ngoại khi được yêu cầu, nên hàng không có hàng cha khá phổ biến: chúng vẫn được nạp, và khóa ở trạng thái chưa kiểm tra kèm cảnh báo thay vì dừng quá trình nạp. | |
| foreign keys to tables the dump doesn't create | không được tạoKhóa không thể tham chiếu tới bảng không tồn tại. | foreign_key_skipped |
| primary keys holding NULL, and NOT NULL columns with values that become NULL | bỏ NOT NULLSQLite cho phép khóa chính không phải rowid chứa NULL; cột không thể là NOT NULL ở đích, nếu không quá trình nạp sẽ dừng. | not_null_relaxed |
| views, triggers and virtual tables (FTS, R*Tree) | được liệt kê trong báo cáoMã của chúng viết bằng ngôn ngữ riêng của SQLite, và bảng ảo cần các mô-đun của SQLite; chúng được liệt kê để bạn tạo lại. Các bảng nội bộ của chúng không được sao chép. | not_converted_objects |
| dumps without CREATE TABLE (--data-only) | kiểu suy ra từ giá trịBản dump chỉ có dữ liệu thì chỉ có các hàng, nên kiểu được suy ra từ giá trị và các cột được đánh số. | no_schema |
| expressions in INSERT values other than the text functions dumps write | NULLunistr(), replace(), char() và || được tính như cách shell ghi chúng; các biểu thức khác không tính được nếu không có cơ sở dữ liệu. | expression_value |
| NUL characters in text | bị xóaShell sqlite3 và Python cắt văn bản tại ký tự NUL khi dump, nên chỉ phần đứng trước nó có trong bản dump. Văn bản PostgreSQL cũng không chứa được ký tự này. | nul_removed |
| text that isn't valid UTF-8 | byte lỗi thành ký tự thay thếBản dump ghi văn bản như vậy dưới dạng byte thô; tập lệnh là UTF-8. | invalid_utf8_replaced |
| text decoded twice (ñ) | sao chép nguyên trạngBản dump chứa đúng các ký tự này, nên chúng được sao chép; báo cáo chỉ ra chúng. | mojibake_suspected |
Nạp tập lệnh vào PostgreSQL
Tập lệnh tạo bảng, sao chép các hàng, rồi thêm khóa, chỉ mục và khóa ngoại, nên nạp nhanh và dừng ở lỗi đầu tiên.
psql -v ON_ERROR_STOP=1 -d mydb -f sqlite.postgresql.sqlKhóa ngoại được thêm dưới dạng NOT VALID rồi được xác thực. Nếu một hàng trỏ tới hàng không tồn tại, tập lệnh cho bạn biết ràng buộc nào, thay vì thất bại giữa chừng.
Với bản dump lớn, hãy tạo cơ sở dữ liệu trước và chạy tập lệnh bằng psql trên cùng máy với máy chủ.
IntoSQL Pro nạp tệp thẳng vào PostgreSQL từ ứng dụng máy tính hoặc dòng lệnh, không cần tạo tập lệnh.
Tạo bản dump SQLite để có kết quả tốt nhất
Trình chuyển đổi đọc những gì bản dump chứa. Các tùy chọn sau giữ lại nhiều dữ liệu hơn trong đó:
- Chính tệp cơ sở dữ liệu được chuyển đổi nguyên trạng, đọc từng trang trong trình duyệt của bạn. Hãy đóng ứng dụng đang ghi vào tệp trước, để không thay đổi nào bị bỏ lại trong tệp -wal của nó.
- sqlite3 app.db .dump > app.sql ghi cùng cơ sở dữ liệu đó dưới dạng SQL, cũng chuyển đổi được, dạng .sql hoặc .sql.gz.
- DB Browser for SQLite ghi đoạn SQL đó qua File, Export, Database to SQL file, và iterdump() của Python cũng vậy.
Những gì không được chuyển đổi
Khung nhìn và trình kích hoạt được viết bằng ngôn ngữ riêng của SQLite. Chúng được liệt kê theo tên trong báo cáo, không bao giờ bị bỏ âm thầm, để bạn viết lại cho PostgreSQL. Bảng ảo, như FTS5 và R*Tree, cũng được liệt kê, còn các bảng bóng của chúng bị bỏ qua.
Câu hỏi về SQLite sang PostgreSQL
Chưa có câu trả lời ở đây? Hãy viết cho chúng tôi từ trang liên hệ, sẽ có người trả lời. Trang liên hệ
Bản dump của tôi có bị tải lên không?
Không. Trình chuyển đổi chạy trong trình duyệt và đọc bản dump từ ổ đĩa theo từng phần, nên nó không bao giờ rời khỏi máy tính của bạn. Ứng dụng máy tính và dòng lệnh cũng chuyển đổi ngay trên máy tính của bạn.
Bản dump có thể lớn đến đâu?
Trình chuyển đổi không bao giờ giữ toàn bộ bản dump trong bộ nhớ: nó đọc tệp hai lần, theo từng đoạn, và ghi tập lệnh trong lúc đọc. Bản dump nhiều gigabyte vẫn chuyển đổi được trong trình duyệt, trong ứng dụng máy tính và bằng dòng lệnh.
Tôi có thể chuyển đổi trực tiếp tệp .db không?
Có. Thả tệp .db, .sqlite hoặc .sqlite3: tệp được đọc trong trình duyệt của bạn và không bao giờ được tải lên. Văn bản có ký tự NUL và mọi chữ số của một giá trị double đều đến đúng như đã lưu, điều mà .dump có thể cắt bớt.
Bản dump có thể đến từ những phiên bản SQLite nào?
Tệp cơ sở dữ liệu từ SQLite 3.0 trở lên, dạng UTF-8 hoặc UTF-16, và bản dump từ lệnh .dump của shell sqlite3 hoặc iterdump() của Python. Mọi tệp và bản dump thử nghiệm đến từ sqlite3 3.31 đến 3.54, gồm cả bảng STRICT và WITHOUT ROWID, và được so với nguồn từng ô một.
Kiểu cột được quyết định thế nào khi SQLite không áp đặt chúng?
Kiểu đã khai báo chỉ là gợi ý và giá trị mới quyết định: cột trở thành integer, numeric, double precision, date, timestamp, boolean, bytea hoặc text khi mọi giá trị đều vừa. Cột chứa giá trị hỗn hợp giữ văn bản của chúng, và báo cáo cho biết đó là cột nào.
INTEGER PRIMARY KEY và AUTOINCREMENT có được giữ không?
Có. INTEGER PRIMARY KEY trở thành cột identity, mỗi hàng giữ id của nó, và id tiếp theo tiếp tục sau id lớn nhất, hoặc sau giá trị của sqlite_sequence khi có AUTOINCREMENT.
Còn khung nhìn và trình kích hoạt thì sao?
Chúng được liệt kê theo tên trong báo cáo và không được chuyển đổi, vì mỗi cơ sở dữ liệu viết chúng bằng ngôn ngữ riêng.
Tập lệnh nạp được trên những phiên bản PostgreSQL nào?
PostgreSQL 13 đến 18. Cùng một tập lệnh nạp được trên từng phiên bản, và dừng ở lỗi đầu tiên nếu có sự cố.