前言：一个关于"搬砖"的故事

在大数据的世界里，有一个永恒的问题：

"MySQL里有10亿条数据，怎么弄到Hadoop里？"

如果你是个愣头青，可能会说："写个Python脚本，一条一条读出来，再一条一条写进去呗！"

然后你就会发现——跑了三天三夜，进度条还在1%。

如果你稍微有点经验，可能会说："用JDBC批量读取，多线程并行写入！"

然后你就会发现——MySQL被你的并发查询搞崩了，DBA提着刀来找你。

这时候，一个叫Sqoop的工具出现了。它的名字来源于SQL-to-Hadoop，使命就是在关系型数据库和Hadoop之间搬砖。

今天，让我们快速了解这个曾经的"数据搬运之王"，以及它为什么正在被时代淘汰。

一、Sqoop是什么？

1.1 一句话定义

Sqoop = SQL to Hadoop，是Apache旗下的一个工具，用于在关系型数据库（MySQL、Oracle、PostgreSQL等）和Hadoop生态（HDFS、Hive、HBase）之间高效传输数据。

1.2 Sqoop的两大核心功能

简单来说，Sqoop就是个数据搬运工：

• Import = 从数据库搬到Hadoop
• Export = 从Hadoop搬回数据库

1.3 Sqoop的版本

🪦 讣告：Apache Sqoop于2021年正式退役，进入Apache Attic。这意味着官方不再维护，虽然你还能用，但出了问题没人管了。

二、Sqoop的工作原理

2.1 核心原理：把导入导出变成MapReduce任务

Sqoop的核心思想很简单：把数据传输任务转换成MapReduce任务，利用Hadoop集群的并行能力来加速数据传输。

关键点：

1. Sqoop根据--split-by指定的列（通常是主键）来分片
2. 每个Mapper负责一个数据范围的查询
3. 默认4个Mapper并行执行
4. 没有Reducer，Mapper直接输出到HDFS

2.2 数据分片策略

⚠️ 分片的坑：

• 如果split-by列分布不均匀，会导致数据倾斜
• 如果split-by列有大量NULL值，可能丢数据
• 如果split-by列不是数字类型，需要特殊处理

三、Sqoop实战命令

3.1 Import：从数据库导入到Hadoop

基础导入到HDFS

sqoop import \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table user_info \
  --target-dir /user/hive/warehouse/user_info \
  --delete-target-dir \
  --num-mappers 4 \
  --split-by id

导入到Hive表

sqoop import \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table user_info \
  --hive-import \
  --hive-database mydb \
  --hive-table user_info \
  --hive-overwrite \
  --num-mappers 4 \
  --split-by id

增量导入（Append模式）

sqoop import \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table orders \
  --target-dir /user/hive/warehouse/orders \
  --incremental append \
  --check-column id \
  --last-value 1000000 \
  --num-mappers 4

增量导入（LastModified模式）

sqoop import \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table orders \
  --target-dir /user/hive/warehouse/orders \
  --incremental lastmodified \
  --check-column update_time \
  --last-value "2024-01-01 00:00:00" \
  --num-mappers 4 \
  --merge-key id

3.2 Export：从Hadoop导出到数据库

sqoop export \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table user_result \
  --export-dir /user/hive/warehouse/user_result \
  --input-fields-terminated-by '\001' \
  --num-mappers 4 \
  --update-key id \
  --update-mode allowinsert

3.3 常用参数速查表

四、Sqoop的合并与压缩

这是Sqoop使用中非常重要但经常被忽略的话题。

4.1 小文件问题（又是它！）

Sqoop默认每个Mapper输出一个文件，如果你设置了4个Mapper，就会产生4个文件。看起来没问题对吧？

但是，考虑这个场景：

4.2 解决方案一：减少Mapper数量

# 如果数据量不大，用1个Mapper
sqoop import \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table small_table \
  --target-dir /user/hive/warehouse/small_table \
  --num-mappers 1  # 只用1个Mapper

问题：数据量大时，单Mapper太慢。

4.3 解决方案二：使用压缩

压缩不仅能减少存储空间，还能减少网络传输，提升性能。

# 使用Snappy压缩（推荐，压缩/解压快）
sqoop import \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table user_info \
  --target-dir /user/hive/warehouse/user_info \
  --compress \
  --compression-codec org.apache.hadoop.io.compress.SnappyCodec \
  --num-mappers 4

# 使用Gzip压缩（压缩比高，但解压慢）
sqoop import \
  ... \
  --compress \
  --compression-codec org.apache.hadoop.io.compress.GzipCodec

# 使用LZO压缩（可分片，适合大文件）
sqoop import \
  ... \
  --compress \
  --compression-codec com.hadoop.compression.lzo.LzopCodec

压缩格式对比：

4.4 解决方案三：使用Parquet/ORC格式

这是最推荐的方案，直接导入为列式存储格式。

# 导入为Parquet格式
sqoop import \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table user_info \
  --target-dir /user/hive/warehouse/user_info \
  --as-parquetfile \
  --parquet-configurator-implementation org.apache.sqoop.parquet.hadoop.HadoopParquetImportConfigurator \
  --num-mappers 4

# Parquet自带压缩，也可以指定
sqoop import \
  ... \
  --as-parquetfile \
  --compress \
  --compression-codec snappy

4.5 解决方案四：后置合并

如果Sqoop导入产生了小文件，可以在导入后手动合并。

Hive CONCATENATE示例：

-- 仅适用于ORC格式的表
ALTER TABLE user_info PARTITION(dt='2024-01-01') CONCATENATE;

Spark合并示例：

# 读取Sqoop导入的数据
df = spark.read.parquet("/user/hive/warehouse/user_info")

# 合并后重新写入
df.coalesce(1).write.mode("overwrite").parquet("/user/hive/warehouse/user_info_merged")

4.6 解决方案五：导入到Hive时自动合并

# Sqoop导入到Hive时，设置Hive的合并参数
sqoop import \
  --connect jdbc:mysql://localhost:3306/mydb \
  --username root \
  --password 123456 \
  --table user_info \
  --hive-import \
  --hive-database mydb \
  --hive-table user_info \
  --num-mappers 4 \
  -- --hive.merge.mapfiles=true \
  -- --hive.merge.mapredfiles=true \
  -- --hive.merge.size.per.task=256000000

4.7 最佳实践：完整的Sqoop导入脚本

#!/bin/bash
# Sqoop导入最佳实践脚本

# 变量定义
DB_HOST="mysql.example.com"
DB_PORT="3306"
DB_NAME="mydb"
DB_USER="sqoop_user"
DB_PWD_FILE="/etc/sqoop/mysql.pwd"
TABLE_NAME="user_info"
HIVE_DB="dw"
HIVE_TABLE="ods_user_info"
DT=$(date +%Y-%m-%d)
NUM_MAPPERS=4

# 导入命令
sqoop import \
  --connect "jdbc:mysql://${DB_HOST}:${DB_PORT}/${DB_NAME}?useSSL=false&characterEncoding=UTF-8" \
  --username ${DB_USER} \
  --password-file ${DB_PWD_FILE} \
  --table ${TABLE_NAME} \
  --hive-import \
  --hive-database ${HIVE_DB} \
  --hive-table ${HIVE_TABLE} \
  --hive-partition-key dt \
  --hive-partition-value ${DT} \
  --hive-overwrite \
  --as-parquetfile \
  --compress \
  --compression-codec snappy \
  --num-mappers ${NUM_MAPPERS} \
  --split-by id \
  --null-string '\\N' \
  --null-non-string '\\N' \
  --fetch-size 10000

# 检查执行结果
if [ $? -eq 0 ]; then
    echo "✅ Sqoop导入成功: ${TABLE_NAME} -> ${HIVE_DB}.${HIVE_TABLE}, 分区: dt=${DT}"
    
    # 合并小文件（如果是ORC格式）
    # hive -e "ALTER TABLE ${HIVE_DB}.${HIVE_TABLE} PARTITION(dt='${DT}') CONCATENATE;"
    
else
    echo "❌ Sqoop导入失败!"
    exit 1
fi

五、Sqoop的痛点与局限

说了这么多，现在让我们来吐槽一下Sqoop的问题。

5.1 Sqoop的七宗罪

5.2 详细分析

问题1：依赖MapReduce，启动开销大

真实场景：导入1MB数据，启动MR花了2分钟，实际传输只要3秒。

问题2：不支持实时/CDC

问题3：对源数据库压力大

六、为什么Sqoop被淘汰？

6.1 时代变了

6.2 替代方案对比

6.3 详细对比表

6.4 替代方案介绍

DataX：阿里开源的数据同步工具

DataX优势：

• 插件化架构，支持多种数据源
• 单机运行，启动快
• 配置简单，JSON格式
• 阿里大规模使用验证

DataX配置示例：

{
  "job": {
    "content": [{
      "reader": {
        "name": "mysqlreader",
        "parameter": {
          "connection": [{
            "jdbcUrl": ["jdbc:mysql://localhost:3306/mydb"],
            "table": ["user_info"]
          }],
          "username": "root",
          "password": "123456",
          "column": ["id", "name", "age"]
        }
      },
      "writer": {
        "name": "hdfswriter",
        "parameter": {
          "path": "/user/hive/warehouse/user_info",
          "fileName": "user_info",
          "column": [
            {"name": "id", "type": "bigint"},
            {"name": "name", "type": "string"},
            {"name": "age", "type": "int"}
          ],
          "fileType": "parquet",
          "compress": "snappy"
        }
      }
    }],
    "setting": {
      "speed": {"channel": 4}
    }
  }
}

Flink CDC：实时数据同步神器

Flink CDC示例：

-- 创建CDC源表
CREATE TABLE mysql_users (
    id BIGINT,
    name STRING,
    age INT,
    update_time TIMESTAMP(3),
    PRIMARY KEY (id) NOT ENFORCED
) WITH (
    'connector' = 'mysql-cdc',
    'hostname' = 'localhost',
    'port' = '3306',
    'username' = 'root',
    'password' = '123456',
    'database-name' = 'mydb',
    'table-name' = 'user_info'
);

-- 创建目标表
CREATE TABLE hive_users (
    id BIGINT,
    name STRING,
    age INT,
    update_time TIMESTAMP(3)
) WITH (
    'connector' = 'hive',
    ...
);

-- 实时同步
INSERT INTO hive_users SELECT * FROM mysql_users;

七、迁移指南：从Sqoop到新方案

7.1 迁移决策树

7.2 Sqoop命令迁移对照表

八、总结

8.1 Sqoop的历史地位

8.2 一句话总结

Sqoop是大数据时代的开拓者，它完成了历史使命，现在是时候说再见了。

如果你是新项目，不要再用Sqoop了，直接上DataX或Flink CDC。

如果你有历史项目在用Sqoop，建议尽快规划迁移，因为：

1. 官方不再维护，安全漏洞没人修
2. 新版本Hadoop/Hive可能兼容性问题
3. 更好的工具已经成熟

8.3 技术选型建议

九、写在最后

写这篇文章的时候，我有点感慨。

Sqoop是我入门大数据时学的第一个工具。当年为了搞懂它的参数，我把官方文档翻了不下十遍，踩了无数的坑：

• 忘记加--null-string，导入的NULL变成了字符串"null"
• split-by选了个分布不均匀的列，一个Mapper跑了2小时，其他3个1分钟就完事
• 导出时主键冲突，整个任务失败从头来
• ......

但正是这些坑，让我真正理解了数据同步的复杂性。

技术在进步，工具在迭代，Sqoop退役了，但它教会我们的东西不会过时：

数据同步的核心挑战永远是：如何在保证数据一致性的前提下，高效、稳定地把数据从A搬到B。

不管是Sqoop、DataX还是Flink CDC，解决的都是这个问题。

好了，Sqoop，再见了老伙计！👋

本文作者：一个曾经和Sqoop相爱相杀的程序员

最惨经历：Sqoop导出时忘记设update-mode，把线上表的数据全删了

铭记历史，面向未来！🐘

附录：Sqoop常见问题与面试题

常见问题

Q1: Sqoop导入时报"No primary key could be found"怎么办？

表没有主键时，Sqoop无法自动分片。解决方案：

1. 使用--split-by指定一个合适的列
2. 或使用-m 1单Mapper运行

Q2: Sqoop导入中文乱码怎么办？

在连接串中添加字符集参数：
jdbc:mysql://host:3306/db?useUnicode=true&characterEncoding=UTF-8

Q3: Sqoop导入NULL值变成"null"字符串怎么办？

添加参数：
--null-string '\\N' --null-non-string '\\N'

面试题

1. Sqoop的工作原理是什么？

   Sqoop将数据导入/导出任务转换为MapReduce任务，利用Hadoop集群的并行能力进行数据传输。每个Mapper负责一个数据分片的读取/写入。

2. Sqoop如何实现增量导入？

   两种模式：

   • Append：基于自增列，只导入新增数据
   • LastModified：基于时间戳列，导入新增和修改的数据

3. Sqoop的split-by有什么要求？

   split-by列应该：数值型、分布均匀、有索引。如果不满足这些条件，可能导致数据倾斜或性能问题。

4. 为什么Sqoop被淘汰了？

   依赖MapReduce启动慢、不支持CDC实时同步、对源数据库压力大、已停止维护。被DataX（批量）和Flink CDC（实时）等新工具取代。

5. 从Sqoop迁移到新方案，你会怎么选择？

   批量场景选DataX/SeaTunnel，实时场景选Flink CDC/Canal，根据数据量和技术栈综合考虑。