CSV 转 SQL 数据导入：数据库迁移的边界

CSV 文件是无类型的。单元格包含 30，导入器必须决定：这是整数、字符串、小数还是其他？不同的数据库系统以不同的方式解析，此边界处的错误会导致：

1. 类型不匹配错误 — 整数列接收字符串数据
2. 无声数据丢失 — 数值精度被截断
3. 编码问题 — 特殊字符在导入过程中损坏
4. 方言特定故障 — MySQL 中工作的 SQL 在 PostgreSQL 中被破坏
5. 转义序列错误 — 单引号或反斜杠导致解析失败

CSV 转 SQL 的边界是关于数据结构的假设与数据库要求碰撞的地方。

CSV 边界处的类型检测是基于启发式的。转换器检查示例行并进行有根据的猜测：

检测规则：

• 整数：123、-45、0
• 小数：12.34、3.14159
• 日期：2024-01-15、2024/01/15 (识别 ISO 格式)
• 布尔值：true、false、yes、no
• 文本：其他所有内容

方言特定映射：

相同的逻辑类型映射到不同的 SQL 类型：

• MySQL：INT、VARCHAR(255)、TEXT
• PostgreSQL：INTEGER、VARCHAR、TEXT
• SQLite：INTEGER、TEXT（所有值都是 TEXT）
• T-SQL：INT、NVARCHAR(255)、NVARCHAR(MAX)

此工具会自动检测并正确映射。但是当检测不确定时（一列中混合类型），手动验证至关重要。

包含特殊字符（引号、反斜杠、换行）的 CSV 值需要正确转义，以防止 SQL 解析错误或注入漏洞。

常见转义错误：

-- ❌ 错误：未转义的单引号
INSERT INTO users (name) VALUES ('John O'Brien');

-- ✅ 正确：转义的引号
INSERT INTO users (name) VALUES ('John O''Brien');

-- ❌ 错误：不带引号的包含空格的值
INSERT INTO users (city) VALUES (New York);

-- ✅ 正确：带引号的包含空格的值
INSERT INTO users (city) VALUES ('New York');

此工具自动处理：

• 单引号转义（加倍）
• 包含空格的字符串值引用
• 换行符和制表符
• NULL 处理
• SQL 注入防护

但了解该工具的功能可以防止配置错误。

将相同的 CSV 导入 MySQL 与 PostgreSQL 需要不同的 SQL 语法：

标识符引用：

• MySQL：反引号 — INSERT INTO \users` (`name`) VALUES (...)`
• PostgreSQL：双引号 — INSERT INTO "users" ("name") VALUES (...)
• SQL Server：方括号 — INSERT INTO [users] ([name]) VALUES (...)

数据类型：

• MySQL：字符串用 VARCHAR(255)、整数用 INT
• PostgreSQL：VARCHAR 或 TEXT、INTEGER
• SQLite：倾向于所有类型用 TEXT（所有类型强制转换为 TEXT）

NULL 处理：

• 大多数方言：缺失值用 NULL
• 某些工具：空字符串或字面 NULL 字符串

此工具自动将 SQL 生成适应每种方言。

1. 导入前验证 — 使用 CSV 转 SQL 转换器在执行前预览生成的 SQL。

2. 显式类型指定 — 不要仅依赖自动检测。检查推断的类型并在必要时更正它们。

3. 在开发环境中首先测试 — 导入到测试数据库，验证记录数和示例值，然后推广到生产环境。

4. 大规模导入前备份 — 在大量导入前始终有数据库备份。

5. 显式处理边界情况 — 空字符串、特殊字符和混合类型需要手动审查。

6. 如果可用，使用 CREATE TABLE — 插入到新创建的表比追加到具有未知架构的现有表更安全。

7. 导入后验证 — 计数行、检查 NULL 不匹配，并在导入完成后点检值。

CSV 转 SQL 的边界是人工监督和工具自动化必须协同工作的地方。