将 Oracle 转换为 SQLite
拖入 SQL Developer 的 Database Export 或 SQLcl 写出的 .sql 文件(包含表和 Insert 语句),即可下载包含相同表、键、索引和数据的 SQLite 脚本。SQLite 无法原样存储的每个值,以及它不支持的每个对象,都会在报告中列出。
已转换 18 行,无修正,无拒绝
shop_2024_oracle.sql 中的表Oracle 转储 · 由 SQL Developer 写出 · utf-8
customers8 行
7 列 id INTEGER not null name VARCHAR(100) not null email VARCHAR(150) not null country VARCHAR(2) not null is_active INTEGER not null signed_up DATETIME created_at DATETIME not null orders10 行
9 列 id INTEGER not null customer_id INTEGER not null invoice INTEGER status VARCHAR(10) not null total DECIMAL(10,2) not null items INTEGER not null ordered_at DATETIME not null shipped_at DATETIME note VARCHAR(255)
-- Written by IntoSQL from a Oracle dump. Load it with: sqlite3 -bail <database> < <file>
PRAGMA foreign_keys = OFF;
PRAGMA synchronous = OFF;
BEGIN;
CREATE TABLE customers ( -- People who bought at least once
id INTEGER PRIMARY KEY AUTOINCREMENT,
name VARCHAR(100) NOT NULL,
email VARCHAR(150) NOT NULL,
country VARCHAR(2) DEFAULT 'US' NOT NULL,
is_active INTEGER DEFAULT 1 NOT NULL,
signed_up DATETIME,
created_at DATETIME DEFAULT (datetime('now', 'localtime')) NOT NULL,
CONSTRAINT customers_check1 CHECK (is_active IN (0, 1))
);
CREATE TABLE orders (
id INTEGER PRIMARY KEY AUTOINCREMENT,
customer_id INTEGER NOT NULL,
invoice INTEGER,
status VARCHAR(10) 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 VARCHAR(255),
CONSTRAINT orders_check1 CHECK (status IN ('pending', 'paid', 'shipped', 'cancelled')),
CONSTRAINT orders_customer_fk FOREIGN KEY (customer_id) REFERENCES customers (id)
);
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 00:00:00','2023-01-15 10:24:00.000000000');
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 00:00:00','2023-02-03 08:11:42.000000000');
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 00:00:00','2023-03-21 19:05:17.000000000');
INSERT INTO customers (id, name, email, country, is_active, signed_up, created_at) VALUES
(4,'李雷','lilei@example.cn','CN',1,'2023-05-09 00:00:00','2023-05-09 02:40:00.000000000');
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.000000000');
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 00:00:00','2024-01-02 09:30:00.000000000');
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 00:00:00','2024-02-29 23:59:59.000000000');
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 00:00:00','2024-04-12 12:12:12.000000000');
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(1,1,1000,'shipped',129.9,3,'2024-03-01 10:00:00','2024-03-02 16:30:00',NULL);
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(2,2,1001,'paid',54,1,'2024-03-02 11:15:00',NULL,'Gift wrap 🎁');
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(3,1,1002,'cancelled',12.5,1,'2024-03-03 09:45:00',NULL,'Customer changed their mind');
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(4,4,1003,'shipped',980,12,'2024-03-05 02:10:00','2024-03-07 08:00:00','请小心轻放');
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(5,5,1004,'pending',45.75,2,'2024-03-08 17:20:00',NULL,'Leave at the door; ring twice');
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(6,6,1005,'shipped',310.4,5,'2024-03-10 13:00:00','2024-03-11 09:00:00','Fragile: "glass"');
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(7,8,1006,'paid',76.2,2,'2024-03-11 18:45:00',NULL,NULL);
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(8,2,1007,'paid',19.99,1,'2024-03-12 08:00:00',NULL,'Paid at the counter');
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(9,3,1008,'shipped',64,2,'2024-03-14 15:30:00',NULL,'Shipping date never recorded');
INSERT INTO orders (id, customer_id, invoice, status, total, items, ordered_at, shipped_at, note) VALUES
(10,7,1009,'paid',1499,1,'2024-03-15 21:05:00',NULL,'C:\Users\ravi\invoice.pdf');
-- Indexes, triggers and counters, after the rows so each index builds once.
CREATE UNIQUE INDEX customers_customers_email_uk ON customers (email);
CREATE INDEX orders_orders_status_date_ix ON orders (status, ordered_at);
UPDATE sqlite_sequence SET seq = max(seq, 0) WHERE name = 'customers';
INSERT INTO sqlite_sequence (name, seq) SELECT 'customers', 0 WHERE NOT EXISTS (SELECT 1 FROM sqlite_sequence WHERE name = 'customers');
UPDATE sqlite_sequence SET seq = max(seq, 0) WHERE name = 'orders';
INSERT INTO sqlite_sequence (name, seq) SELECT 'orders', 0 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;
修正
没有需要修正的内容。
需要检查
- 1 个序列未创建;SQLite 没有序列。 如果你的应用需要,请把下一个值保存在表中。
- orders 中 "invoice" 的默认值无法为 SQLite 写出(a sequence),因此该列没有默认值。 如果新行需要,请手动添加默认值。
文件在这台电脑上转换,永远不会上传。
其他示例:
从 Oracle 到 SQLite 的变化
每一行是转换器应用的一条规则,以及该规则更改你的数据时在报告中写入的记录。
BOOLEAN (23ai)
INTEGER 0 或 1,并带有 CHECK
SQLite 没有布尔列,因此 TRUE 和 FALSE 为 1 和 0。
VARCHAR2(n BYTE|CHAR), NVARCHAR2(n), CHAR(n), NCHAR(n), CLOB, NCLOB, LONG
TEXT
无论 Oracle 按字节还是按字符计数,长度都按字符计算,因此每个值都能容纳。
NUMBER, NUMBER(p,s), FLOAT(b)
INTEGER,或超过 15 位时以文本精确保存的 NUMERIC
NUMBER 保留每一位数字;没有精度的 NUMBER 若所有值都是不超过 18 位的整数,则为 64 位整数;负的小数位数会在小数点前保留同样多的位数。
报告记录: decimal_as_text
INTERVAL YEAR TO MONTH, INTERVAL DAY TO SECOND
TEXT,存放 Oracle 的文本,例如 +01-06
SQLite 没有 interval 类型;文本保留每个部分。
报告记录: type_replaced
DATE, TIMESTAMP(p)
DATETIME,以 ISO 8601 文本存储,保留每一位
Oracle 的 DATE 包含精确到秒的时间,因此是日期和时间。在美式或德式会话中导出时,日期不含时间和世纪(DD-MON-RR);请在 ISO 会话(SYYYY-MM-DD HH24:MI:SS)中导出以保留它们。
TIMESTAMP WITH TIME ZONE, TIMESTAMP WITH LOCAL TIME ZONE
TIMESTAMP,存为 UTC 的 ISO 8601 文本
SQLite 没有能保留偏移量的类型,因此每个时间点都以 UTC 写出:无论原有偏移量是多少,都是同一时刻。
报告记录: moments_as_utc
JSON (21c), and CLOB holding JSON
TEXT
JSON 值相同;导出写为 'null' 的 SQL NULL 仍为 NULL。
BLOB, RAW(n), LONG RAW
BLOB
字节仍然是字节。
ROWID, UROWID, XMLTYPE, SDO_GEOMETRY
TEXT
Oracle 自有的类型没有对应类型;其值保留文本,包括 ROWID 值,尽管它们离开 Oracle 就没有意义。
报告记录: type_replaced
collations that ignore case (BINARY_CI)
精确比较
除非另有指定,SQLite 会精确比较文本,其 NOCASE 也只对 ASCII 字母忽略大小写。
报告记录: case_insensitive_collation
identity columns, and a sequence a BEFORE INSERT trigger assigns
INTEGER PRIMARY KEY AUTOINCREMENT,从最大的 id 之后继续
复制的 id 按原样导入,计数器从最大的 id 之后继续。由触发器从序列取值填充的列(12c 之前的做法)也会成为标识列。
identity columns the target can't count
INTEGER,没有计数器
SQLite 只为构成完整主键的列计数,因此该列保留其值,新行需要自行提供值。
报告记录: counter_dropped
CREATE SEQUENCE
不创建
导出会把序列当前到达的位置写为其 START WITH,因此序列从那里继续。
报告记录: sequence_not_converted
virtual columns (GENERATED ALWAYS AS ... VIRTUAL)
GENERATED ALWAYS AS,PERSISTED 时为 STORED,否则为 VIRTUAL
SQLite 用相同的公式计算它们;导出为它们写出的值会被省略。
virtual columns with functions IntoSQL doesn't write, and the || operator
普通列
无法为 SQLite 写出的公式会留下一个普通列和一条报告记录;导出为虚拟列写出的值会被省略,SQLite 也没有可计算的值。
报告记录: generated_not_translated
defaults with functions IntoSQL doesn't write (SYS_GUID(), ||)
无默认值
无法写出的默认值会被省略,并在报告中列出。
报告记录: default_not_translated
CHECK constraints
已转换
检查约束相同,在导入每一行时检查。
CHECK constraints with functions IntoSQL doesn't write
不创建
无法写出的检查约束会被省略,并在报告中列出。
报告记录: check_skipped
CHECK constraints that are DISABLE or ENABLE NOVALIDATE
不创建
Oracle 不对已有的行执行这些检查约束,因此行可能违反它们。
报告记录: check_not_enforced
function-based, bitmap and domain indexes
不创建
IntoSQL 在整列上写出 b-tree 索引;其他索引请在导入后重新创建。
报告记录: index_skipped
foreign keys
在 CREATE TABLE 中,不检查地导入,然后用 PRAGMA foreign_key_check 列出
SQLite 只接受 CREATE TABLE 中的外键,且只在 PRAGMA foreign_keys 开启时检查。行在不检查的情况下导入,脚本最后列出所有没有父行的行。
foreign keys to tables the export doesn't create, and DISABLE or NOVALIDATE ones
不创建
外键无法引用不存在的表,而 Oracle 不检查的外键可能存在没有父行的行。
报告记录: foreign_key_skipped
partitioned tables
单个表,包含每个分区的行
行保持不变;如有需要,请在 SQLite 中重新对该表分区。
报告记录: partitions_dropped
several schemas in one export
单个文件,每个表名前加上其 schema 名
一个 SQLite 文件就是一个数据库,因此用 schema 名区分同名的表;只含一个 schema 的导出保留其表名。
报告记录: schemas_merged
NOT NULL columns with values that become NULL
去除 NOT NULL
值必须变为 NULL 的列无法保留 NOT NULL,否则导入会中止。
报告记录: not_null_relaxed
views, synonyms, types, packages, procedures, functions and other triggers
在报告中列出
它们的代码用 PL/SQL 编写,因此会列出来,由你重新创建。
报告记录: not_converted_objects
exports without CREATE TABLE (data only)
根据值推断类型
只含数据的导出只有行,因此类型来自值。
报告记录: no_schema
expressions in INSERT values other than the ones exports write
NULL
不运行数据库的转换器无法对它们求值;导出写出的 to_date、to_timestamp、TO_CLOB、HEXTORAW 等会被读取。
报告记录: expression_value
types IntoSQL doesn't know, and object types
TEXT
文本可以容纳任何值;请在导入后更改类型。
报告记录: unknown_type
dates before year 1 and time zones given as region names
NULL
不是日期的值变为 NULL,报告会统计其数量。
报告记录: date_out_of_range
NaN and Infinity in BINARY_FLOAT and BINARY_DOUBLE
Infinity 为 9e999;NaN 为 NULL
SQLite 会将 9e999 读回为 infinity,且没有 NaN。
NUL characters in text
保留
SQLite 的 text 可以存储 NUL 字符,因此值按原样复制。
text that isn't valid in its encoding
错误的字节变为替换字符
脚本是 UTF-8,每个值都必须是有效文本。
报告记录: invalid_utf8_replaced
text decoded twice (ñ)
按原样复制
脚本中存储的正是这些字符,因此按原样复制;报告会指出它们。
报告记录: mojibake_suspected
| 在 Oracle 中 | 在 SQLite 中 | 报告记录 |
|---|---|---|
| BOOLEAN (23ai) | INTEGER 0 或 1,并带有 CHECKSQLite 没有布尔列,因此 TRUE 和 FALSE 为 1 和 0。 | |
| VARCHAR2(n BYTE|CHAR), NVARCHAR2(n), CHAR(n), NCHAR(n), CLOB, NCLOB, LONG | TEXT无论 Oracle 按字节还是按字符计数,长度都按字符计算,因此每个值都能容纳。 | |
| NUMBER, NUMBER(p,s), FLOAT(b) | INTEGER,或超过 15 位时以文本精确保存的 NUMERICNUMBER 保留每一位数字;没有精度的 NUMBER 若所有值都是不超过 18 位的整数,则为 64 位整数;负的小数位数会在小数点前保留同样多的位数。 | decimal_as_text |
| INTERVAL YEAR TO MONTH, INTERVAL DAY TO SECOND | TEXT,存放 Oracle 的文本,例如 +01-06SQLite 没有 interval 类型;文本保留每个部分。 | type_replaced |
| DATE, TIMESTAMP(p) | DATETIME,以 ISO 8601 文本存储,保留每一位Oracle 的 DATE 包含精确到秒的时间,因此是日期和时间。在美式或德式会话中导出时,日期不含时间和世纪(DD-MON-RR);请在 ISO 会话(SYYYY-MM-DD HH24:MI:SS)中导出以保留它们。 | |
| TIMESTAMP WITH TIME ZONE, TIMESTAMP WITH LOCAL TIME ZONE | TIMESTAMP,存为 UTC 的 ISO 8601 文本SQLite 没有能保留偏移量的类型,因此每个时间点都以 UTC 写出:无论原有偏移量是多少,都是同一时刻。 | moments_as_utc |
| JSON (21c), and CLOB holding JSON | TEXTJSON 值相同;导出写为 'null' 的 SQL NULL 仍为 NULL。 | |
| BLOB, RAW(n), LONG RAW | BLOB字节仍然是字节。 | |
| ROWID, UROWID, XMLTYPE, SDO_GEOMETRY | TEXTOracle 自有的类型没有对应类型;其值保留文本,包括 ROWID 值,尽管它们离开 Oracle 就没有意义。 | type_replaced |
| collations that ignore case (BINARY_CI) | 精确比较除非另有指定,SQLite 会精确比较文本,其 NOCASE 也只对 ASCII 字母忽略大小写。 | case_insensitive_collation |
| identity columns, and a sequence a BEFORE INSERT trigger assigns | INTEGER PRIMARY KEY AUTOINCREMENT,从最大的 id 之后继续复制的 id 按原样导入,计数器从最大的 id 之后继续。由触发器从序列取值填充的列(12c 之前的做法)也会成为标识列。 | |
| identity columns the target can't count | INTEGER,没有计数器SQLite 只为构成完整主键的列计数,因此该列保留其值,新行需要自行提供值。 | counter_dropped |
| CREATE SEQUENCE | 不创建导出会把序列当前到达的位置写为其 START WITH,因此序列从那里继续。 | sequence_not_converted |
| virtual columns (GENERATED ALWAYS AS ... VIRTUAL) | GENERATED ALWAYS AS,PERSISTED 时为 STORED,否则为 VIRTUALSQLite 用相同的公式计算它们;导出为它们写出的值会被省略。 | |
| virtual columns with functions IntoSQL doesn't write, and the || operator | 普通列无法为 SQLite 写出的公式会留下一个普通列和一条报告记录;导出为虚拟列写出的值会被省略,SQLite 也没有可计算的值。 | generated_not_translated |
| defaults with functions IntoSQL doesn't write (SYS_GUID(), ||) | 无默认值无法写出的默认值会被省略,并在报告中列出。 | default_not_translated |
| CHECK constraints | 已转换检查约束相同,在导入每一行时检查。 | |
| CHECK constraints with functions IntoSQL doesn't write | 不创建无法写出的检查约束会被省略,并在报告中列出。 | check_skipped |
| CHECK constraints that are DISABLE or ENABLE NOVALIDATE | 不创建Oracle 不对已有的行执行这些检查约束,因此行可能违反它们。 | check_not_enforced |
| function-based, bitmap and domain indexes | 不创建IntoSQL 在整列上写出 b-tree 索引;其他索引请在导入后重新创建。 | index_skipped |
| foreign keys | 在 CREATE TABLE 中,不检查地导入,然后用 PRAGMA foreign_key_check 列出SQLite 只接受 CREATE TABLE 中的外键,且只在 PRAGMA foreign_keys 开启时检查。行在不检查的情况下导入,脚本最后列出所有没有父行的行。 | |
| foreign keys to tables the export doesn't create, and DISABLE or NOVALIDATE ones | 不创建外键无法引用不存在的表,而 Oracle 不检查的外键可能存在没有父行的行。 | foreign_key_skipped |
| partitioned tables | 单个表,包含每个分区的行行保持不变;如有需要,请在 SQLite 中重新对该表分区。 | partitions_dropped |
| several schemas in one export | 单个文件,每个表名前加上其 schema 名一个 SQLite 文件就是一个数据库,因此用 schema 名区分同名的表;只含一个 schema 的导出保留其表名。 | schemas_merged |
| NOT NULL columns with values that become NULL | 去除 NOT NULL值必须变为 NULL 的列无法保留 NOT NULL,否则导入会中止。 | not_null_relaxed |
| views, synonyms, types, packages, procedures, functions and other triggers | 在报告中列出它们的代码用 PL/SQL 编写,因此会列出来,由你重新创建。 | not_converted_objects |
| exports without CREATE TABLE (data only) | 根据值推断类型只含数据的导出只有行,因此类型来自值。 | no_schema |
| expressions in INSERT values other than the ones exports write | NULL不运行数据库的转换器无法对它们求值;导出写出的 to_date、to_timestamp、TO_CLOB、HEXTORAW 等会被读取。 | expression_value |
| types IntoSQL doesn't know, and object types | TEXT文本可以容纳任何值;请在导入后更改类型。 | unknown_type |
| dates before year 1 and time zones given as region names | NULL不是日期的值变为 NULL,报告会统计其数量。 | date_out_of_range |
| NaN and Infinity in BINARY_FLOAT and BINARY_DOUBLE | Infinity 为 9e999;NaN 为 NULLSQLite 会将 9e999 读回为 infinity,且没有 NaN。 | |
| NUL characters in text | 保留SQLite 的 text 可以存储 NUL 字符,因此值按原样复制。 | |
| text that isn't valid in its encoding | 错误的字节变为替换字符脚本是 UTF-8,每个值都必须是有效文本。 | invalid_utf8_replaced |
| text decoded twice (ñ) | 按原样复制脚本中存储的正是这些字符,因此按原样复制;报告会指出它们。 | mojibake_suspected |
将脚本导入 SQLite
脚本先创建表、复制行,再添加键、索引和外键,因此导入速度快,并会在遇到第一个错误时停止。
sqlite3 -bail mydb.sqlite < oracle.sqlite.sql外键在每个表中声明,行在关闭外键检查的情况下导入。随后脚本会列出所有指向不存在的行的行,而不是中途失败。
对于较大的转储,请导入到本地磁盘上的新文件中。脚本在关闭同步的单个事务中导入全部内容,因此以磁盘速度运行,中途停止的导入也不会留下不完整的表。
命令行可将文件直接导入 SQLite 数据库,无需生成脚本,而且免费。
如何转储 Oracle 以获得最佳结果
转换器读取转储中的内容。以下选项能让转储保留更多数据:
- 在 SQL Developer 中选择 Tools、Database Export,并选择 DDL 和 Insert 数据格式。SQLcl 使用 SET SQLFORMAT INSERT 也会写出相同内容。
- 导出前请执行 ALTER SESSION SET NLS_DATE_FORMAT = 'SYYYY-MM-DD HH24:MI:SS':默认格式写出的日期不含时间和世纪。
- exp 或 expdp 生成的 .dmp 文件是二进制的:请将其导入 Oracle 数据库(例如 Docker 中的 Oracle Database Free),再用 SQL Developer 导出。
哪些内容不会转换
视图、包、存储过程、函数、触发器、类型和同义词都是用 PL/SQL 编写的。它们会按名称在报告中列出,绝不会被悄悄丢弃,以便你为 SQLite 重写。
关于 Oracle 转 SQLite 的问题
这里没有你要的答案?请通过联系页面给我们留言,会有专人回复。 联系页面
我的转储会被上传吗?
不会。转换器在你的浏览器中运行,分块从磁盘读取转储,因此转储不会离开你的电脑。桌面应用和命令行也在你的电脑上转换。
转储可以多大?
转换器从不把整个转储放进内存:它按范围读取文件两次,边读边写出脚本。几 GB 的转储可以在浏览器、桌面应用和命令行中转换。
可以转换 exp 或 expdp 生成的 .dmp 文件吗?
不能直接转换:Data Pump 和原始的 Export 写出的是只有 Oracle 能读取的二进制格式。请将其导入任意 Oracle 数据库(Oracle Database Free 可在 Docker 中运行),再用 SQL Developer 的 Database Export 或 SQLcl 导出。转换器收到 .dmp 文件时会给出提示。
导出可以来自哪些 Oracle 版本?
由 SQL Developer 和 SQLcl 从 Oracle 11g 及更高版本写出、带有 DBMS_METADATA 表定义的导出。每个测试导出都来自 Oracle 21c 和 23ai,涵盖美式、德式和 ISO 会话,并与其源数据逐个单元格比较。
NUMBER、DATE 和其他 Oracle 类型会怎样?
NUMBER 为整数时变为 INTEGER,否则保留每一位数字;DATE 变为带时间的 DATETIME 文本;CLOB 变为 TEXT,BLOB 和 RAW 变为 BLOB。Infinity 会保留;NaN 变为 NULL。
标识列和序列会保留吗?
构成表的完整主键的标识列变为 INTEGER PRIMARY KEY AUTOINCREMENT,并从最大的 id 之后继续。SQLite 没有序列,因此序列会在报告中列出。
PL/SQL 包、存储过程和触发器怎么处理?
它们会按名称在报告中列出,但不会转换,因为每种数据库都用自己的语言编写它们。
脚本可以导入哪些 SQLite 版本?
SQLite 3.31 及更高版本。每个测试导出都能在 3.31 和 3.54 上导入,如有问题会在第一个错误处停止。