解决countries-states-cities-database项目中MySQL到SQL Server的迁移问题

在开源项目countries-states-cities-database的使用过程中，许多开发者遇到了将MySQL脚本迁移到SQL Server时的兼容性问题。本文将深入分析这些问题的根源，并提供详细的解决方案。

问题背景分析

countries-states-cities-database项目提供了全球国家、州/省和城市数据的SQL脚本，这些脚本最初是为MySQL设计的。当开发者尝试在Microsoft SQL Server Management Studio中执行这些脚本时，会遇到多种语法错误，主要包括：

1. 反引号(`)标识符语法不兼容
2. 数据类型定义差异
3. 自增字段语法不同
4. 默认值设置方式不一致
5. 特殊字符处理方式不同

主要兼容性问题详解

1. 标识符引用方式差异

MySQL使用反引号(`)来引用标识符，而SQL Server使用方括号([])。这是最常见的兼容性问题之一。

MySQL语法示例：

CREATE TABLE `countries` (
  `id` int NOT NULL AUTO_INCREMENT,
  `name` varchar(100) NOT NULL
);

SQL Server等效语法：

CREATE TABLE [countries] (
  [id] int IDENTITY(1,1) NOT NULL,
  [name] varchar(100) NOT NULL
);

2. 自增字段语法差异

MySQL使用AUTO_INCREMENT关键字，而SQL Server使用IDENTITY属性。

转换示例：

-- MySQL
id int NOT NULL AUTO_INCREMENT PRIMARY KEY

-- SQL Server
id int IDENTITY(1,1) PRIMARY KEY

3. 数据类型差异

两种数据库系统在数据类型上存在一些重要差异：

• MySQL的TEXT类型在SQL Server中通常转换为VARCHAR(MAX)
• MySQL的DATETIME在SQL Server中可转换为DATETIME2
• MySQL的TINYINT(1)通常转换为SQL Server的BIT或TINYINT

4. 默认值处理

MySQL允许更灵活的默认值表达式，而SQL Server有更严格的限制：

问题示例：

-- MySQL
flag tinyint NOT NULL DEFAULT '1'

-- SQL Server
flag tinyint NOT NULL DEFAULT 1

注意SQL Server中数字默认值不应使用引号。

完整迁移方案

表结构迁移

以下是countries表的完整SQL Server创建语句：

CREATE TABLE countries (
  id int IDENTITY(1,1) PRIMARY KEY,
  name varchar(100) NOT NULL,
  iso3 char(3) NULL,
  numeric_code char(3) NULL,
  iso2 char(2) NULL,
  phonecode varchar(255) NULL,
  capital varchar(255) NULL,
  currency varchar(255) NULL,
  currency_name varchar(255) NULL,
  currency_symbol varchar(255) NULL,
  tld varchar(255) NULL,
  [native] varchar(255) NULL,
  region varchar(255) NULL,
  region_id int NULL,
  subregion varchar(255) NULL,
  subregion_id int NULL,
  nationality varchar(255) NULL,
  timezones varchar(MAX),
  translations varchar(MAX),
  latitude decimal(10,8) NULL,
  longitude decimal(11,8) NULL,
  emoji varchar(191) NULL,
  emojiU varchar(191) NULL,
  created_at datetime2 NULL,
  updated_at datetime2 NOT NULL,
  flag tinyint NOT NULL DEFAULT 1,
  wikiDataId varchar(255) NULL
);

数据插入语句转换

原始MySQL的INSERT语句需要做以下修改：

1. 移除反引号
2. 调整日期时间格式
3. 处理特殊字符转义

转换示例：

-- MySQL原始语句
INSERT INTO `countries` VALUES (1,'CountryA','ABC','001','AB','1','CapitalA','ABC','Currency A','$','.ab','NativeA','RegionA',1,'SubregionA',1,'NationalityA','[{\"zoneName\":\"Region\\/CapitalA\",\"gmtOffset\":0,\"gmtOffsetName\":\"UTC+0\",\"abbreviation\":\"ABC\",\"tzName\":\"Time Zone A\"}]','{\"kr\":\"국가 A\",\"br\":\"País A\",\"pt\":\"País A\",\"nl\":\"Land A\",\"hr\":\"Zemlja A\",\"fa\":\"کشور الف\",\"de\":\"Land A\",\"es\":\"País A\",\"fr\":\"Pays A\",\"ja\":\"国A\",\"it\":\"Paese A\",\"cn\":\"国家A\"}',0.00000000,0.00000000,'🇦','U+1F1E6','2018-07-21 09:11:03','2023-08-08 23:04:58',1,'Q001');

-- SQL Server转换后
INSERT INTO countries VALUES (1,'CountryA','ABC','001','AB','1','CapitalA','ABC','Currency A','$','.ab','NativeA','RegionA',1,'SubregionA',1,'NationalityA','[{\"zoneName\":\"Region\\/CapitalA\",\"gmtOffset\":0,\"gmtOffsetName\":\"UTC+0\",\"abbreviation\":\"ABC\",\"tzName\":\"Time Zone A\"}]','{\"kr\":\"국가 A\",\"br\":\"País A\",\"pt\":\"País A\",\"nl\":\"Land A\",\"hr\":\"Zemlja A\",\"fa\":\"کشور الف\",\"de\":\"Land A\",\"es\":\"País A\",\"fr\":\"Pays A\",\"ja\":\"国A\",\"it\":\"Paese A\",\"cn\":\"国家A\"}',0.00000000,0.00000000,'🇦','U+1F1E6','2018-07-21 09:11:03','2023-08-08 23:04:58',1,'Q001');

迁移工具建议

对于大型数据库迁移项目，可以考虑以下方法：

1. 使用SQL Server导入导出向导
2. 利用SSMA(SQL Server Migration Assistant)工具
3. 编写转换脚本自动化处理常见模式

常见问题解决方案

1. 标识符过长错误：SQL Server对标识符长度有限制(128字符)，需要缩短表名或列名
2. 特殊字符处理：确保JSON数据中的特殊字符正确转义
3. 时区数据格式：验证时区信息的JSON格式是否符合SQL Server要求
4. emoji处理：确保数据库排序规则支持UTF-8字符

总结

将countries-states-cities-database项目的MySQL脚本迁移到SQL Server需要仔细处理语法差异和数据类型转换。通过系统性地解决标识符引用、自增字段、数据类型和默认值等问题，可以成功实现数据库迁移。对于大型项目，建议使用专门的迁移工具或编写转换脚本以提高效率。