将 SQLite 转换为 PostgreSQL
拖入 SQLite 数据库文件(.db、.sqlite、.sqlite3)或 sqlite3 的 .dump 写出的 SQL,即可下载包含相同表、键、索引和数据的 PostgreSQL 脚本。每列获得其值都符合的类型,PostgreSQL 无法原样存储的每个值都会在报告中列出。
已转换 18 行,无修正,无拒绝
shop_2024_sqlite.sql 中的表SQLite 转储 · 由 sqlite3 写出 · utf-8
customers8 行
7 列 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 行
9 列 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
未转换
- 视图 order_totals
- 触发器 orders_shipped
每种数据库都用自己的语言编写这些对象。请为 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);
修正
没有需要修正的内容。
需要检查
- 源数据中有 1 个文本列比较时不区分大小写;PostgreSQL 精确比较,因此唯一键和搜索的行为可能不同。 在需要的列上使用不区分大小写的排序规则或列类型。
- 2 个视图、触发器、例程或事件未转换;报告逐一列出了它们。 请在 PostgreSQL 中手动重新创建它们。
文件在这台电脑上转换,永远不会上传。
其他示例:
从 SQLite 到 PostgreSQL 的变化
每一行是转换器应用的一条规则,以及该规则更改你的数据时在报告中写入的记录。
declared types (any text: VARCHAR(255), DATETIME, BOOLEAN, JSON or none)
列中每个值都符合的类型
SQLite 允许任何列存放任何值,因此声明的类型只是提示:每列获得其所有值都符合的类型,包含混合值的列保留其文本。
BOOLEAN, BOOL
boolean
当每个值都是 0 或 1 时;同时包含其他值的列会将它们保留为数字或文本。
TEXT, VARCHAR(n), CHAR(n), CLOB
每个值都符合声明的长度时为 varchar(n),否则为 text
SQLite 从不强制长度;只有当每个值都符合时,才保留声明的长度。
DECIMAL(p,s), NUMERIC
每个值都符合时为精确类型,否则为 double
SQLite 将这些值存储为整数或 double;只有当值符合时,才保留声明的精度。
BLOB, and columns holding bytes
bytea
字节保持为字节;同一列中的文本和数字按其字节保留。
DATE, DATETIME, TIMESTAMP holding ISO 8601 text
date、timestamp
当每个值都是日期或日期加时间时;纪元时间数字和其他文本保持原值不变。
JSON holding JSON text
jsonb
当每个值都是 JSON 对象或数组时。
Infinity in REAL columns
Infinity,PostgreSQL 的 double 会保留它
PostgreSQL 的 double 可以保存无穷大。
INTEGER PRIMARY KEY, AUTOINCREMENT
GENERATED BY DEFAULT AS IDENTITY,从最大的 id 或 sqlite_sequence 的值之后继续
只有声明恰好为 INTEGER PRIMARY KEY 的列才是 rowid;每一行都保留其 id,计数器从曾经分配过的最大 id 之后开始。
COLLATE NOCASE
精确比较
除非另有指定,PostgreSQL 会精确比较文本;NOCASE 列不再忽略大小写。
报告记录: case_insensitive_collation
generated columns
STORED
PostgreSQL 13 到 17 只支持存储生成列;公式相同。
报告记录: virtual_as_stored
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)
外键,先以 NOT VALID 添加,然后验证
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() 和 || 会按 shell 写出的形式求值;其他表达式在没有数据库时无法求值。
报告记录: expression_value
NUL characters in text
去除
sqlite3 shell 和 Python 在转储时会在 NUL 字符处截断文本,因此转储中只有它之前的内容。PostgreSQL 的文本也无法包含 NUL 字符。
报告记录: nul_removed
text that isn't valid UTF-8
错误的字节变为替换字符
转储会将这类文本写为原始字节;脚本是 UTF-8。
报告记录: invalid_utf8_replaced
text decoded twice (ñ)
按原样复制
转储中存储的正是这些字符,因此按原样复制;报告会指出它们。
报告记录: mojibake_suspected
| 在 SQLite 中 | 在 PostgreSQL 中 | 报告记录 |
|---|---|---|
| declared types (any text: VARCHAR(255), DATETIME, BOOLEAN, JSON or none) | 列中每个值都符合的类型SQLite 允许任何列存放任何值,因此声明的类型只是提示:每列获得其所有值都符合的类型,包含混合值的列保留其文本。 | |
| BOOLEAN, BOOL | boolean当每个值都是 0 或 1 时;同时包含其他值的列会将它们保留为数字或文本。 | |
| TEXT, VARCHAR(n), CHAR(n), CLOB | 每个值都符合声明的长度时为 varchar(n),否则为 textSQLite 从不强制长度;只有当每个值都符合时,才保留声明的长度。 | |
| DECIMAL(p,s), NUMERIC | 每个值都符合时为精确类型,否则为 doubleSQLite 将这些值存储为整数或 double;只有当值符合时,才保留声明的精度。 | |
| BLOB, and columns holding bytes | bytea字节保持为字节;同一列中的文本和数字按其字节保留。 | |
| DATE, DATETIME, TIMESTAMP holding ISO 8601 text | date、timestamp当每个值都是日期或日期加时间时;纪元时间数字和其他文本保持原值不变。 | |
| JSON holding JSON text | jsonb当每个值都是 JSON 对象或数组时。 | |
| Infinity in REAL columns | Infinity,PostgreSQL 的 double 会保留它PostgreSQL 的 double 可以保存无穷大。 | |
| INTEGER PRIMARY KEY, AUTOINCREMENT | GENERATED BY DEFAULT AS IDENTITY,从最大的 id 或 sqlite_sequence 的值之后继续只有声明恰好为 INTEGER PRIMARY KEY 的列才是 rowid;每一行都保留其 id,计数器从曾经分配过的最大 id 之后开始。 | |
| COLLATE NOCASE | 精确比较除非另有指定,PostgreSQL 会精确比较文本;NOCASE 列不再忽略大小写。 | case_insensitive_collation |
| generated columns | STOREDPostgreSQL 13 到 17 只支持存储生成列;公式相同。 | virtual_as_stored |
| 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) | 外键,先以 NOT VALID 添加,然后验证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 NULLSQLite 允许 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 | NULLunistr()、replace()、char() 和 || 会按 shell 写出的形式求值;其他表达式在没有数据库时无法求值。 | expression_value |
| NUL characters in text | 去除sqlite3 shell 和 Python 在转储时会在 NUL 字符处截断文本,因此转储中只有它之前的内容。PostgreSQL 的文本也无法包含 NUL 字符。 | nul_removed |
| text that isn't valid UTF-8 | 错误的字节变为替换字符转储会将这类文本写为原始字节;脚本是 UTF-8。 | invalid_utf8_replaced |
| text decoded twice (ñ) | 按原样复制转储中存储的正是这些字符,因此按原样复制;报告会指出它们。 | mojibake_suspected |
将脚本导入 PostgreSQL
脚本先创建表、复制行,再添加键、索引和外键,因此导入速度快,并会在遇到第一个错误时停止。
psql -v ON_ERROR_STOP=1 -d mydb -f sqlite.postgresql.sql外键先以 NOT VALID 添加,然后再验证。如果某行指向不存在的行,脚本会告诉你是哪个约束,而不是中途失败。
对于较大的转储,请先创建数据库,然后在服务器所在的机器上用 psql 运行脚本。
IntoSQL Pro 可以通过桌面应用或命令行将文件直接导入 PostgreSQL,无需生成脚本。
如何转储 SQLite 以获得最佳结果
转换器读取转储中的内容。以下选项能让转储保留更多数据:
- 数据库文件本身会原样转换,在浏览器中逐页读取。请先关闭正在写入它的应用,以免有更改遗留在其 -wal 文件中。
- sqlite3 app.db .dump > app.sql 会将同一个数据库写为 SQL,它同样可以转换,格式为 .sql 或 .sql.gz。
- DB Browser for SQLite 通过 File、Export、Database to SQL file 也能写出该 SQL,Python 的 iterdump() 也一样。
哪些内容不会转换
视图和触发器是用 SQLite 自己的语言编写的。它们会按名称在报告中列出,绝不会被悄悄丢弃,以便你为 PostgreSQL 重写。FTS5 和 R*Tree 等虚拟表也会列出,其影子表则不包含在内。
关于 SQLite 转 PostgreSQL 的问题
这里没有你要的答案?请通过联系页面给我们留言,会有专人回复。 联系页面
我的转储会被上传吗?
不会。转换器在你的浏览器中运行,分块从磁盘读取转储,因此转储不会离开你的电脑。桌面应用和命令行也在你的电脑上转换。
转储可以多大?
转换器从不把整个转储放进内存:它按范围读取文件两次,边读边写出脚本。几 GB 的转储可以在浏览器、桌面应用和命令行中转换。
可以直接转换 .db 文件吗?
可以。拖入 .db、.sqlite 或 .sqlite3 文件:它在浏览器中读取,绝不会上传。含 NUL 字符的文本和 double 值的每一位数字都会按存储原样保留,而 .dump 可能会将其截断。
转储可以来自哪些 SQLite 版本?
SQLite 3.0 及更高版本的 UTF-8 或 UTF-16 数据库文件,以及由 sqlite3 shell 的 .dump 或 Python 的 iterdump() 写出的转储。每个测试文件和转储都来自 sqlite3 3.31 到 3.54,包括 STRICT 和 WITHOUT ROWID 表,并与其源数据逐个单元格比较。
SQLite 不强制类型时,列类型如何确定?
声明的类型只是提示,由值决定:当每个值都符合时,列会变为 integer、numeric、double precision、date、timestamp、boolean、bytea 或 text。包含混合值的列保留其文本,报告会指出是哪些列。
INTEGER PRIMARY KEY 和 AUTOINCREMENT 会保留吗?
会。INTEGER PRIMARY KEY 变为标识列,每一行都保留其 id,下一个 id 从最大的 id 之后继续;使用 AUTOINCREMENT 时则从 sqlite_sequence 的值之后继续。
视图和触发器怎么处理?
它们会按名称在报告中列出,但不会转换,因为每种数据库都用自己的语言编写它们。
脚本可以导入哪些 PostgreSQL 版本?
PostgreSQL 13 到 18。同一个脚本可以在其中每个版本上导入,如有问题会在第一个错误处停止。