一 Sqoop简介
Apache Sqoop(TM) 于 2012 年 3 月孵化出来,现在是一个顶级的 Apache 项目。是一种旨在有效地在 Apache Hadoop 和诸如关系数据库等结构化数据存储之间传输大量数据的工具。最新的稳定版本是 1.4.7。Sqoop2 的最新版本是 1.99.7。请注意,1.99.7 与 1.4.7 不兼容,且没有特征不完整,它并不打算用于生产部署。
二 Sqoop原理
将导入或导出命令翻译成 mapreduce 程序来实现。在翻译出的 mapreduce 中主要是对 inputformat 和 outputformat 进行定制。
三 Sqoop安装
安装 Sqoop 的前提是已经具备 Java 和 Hadoop 的环境。
3.1 下载并解压
1) 最新版下载地址:http://mirrors.hust.edu.cn/apache/sqoop/1.4.7/
用户指南:http://sqoop.apache.org/docs/1.4.7/SqoopUserGuide.html
2) 上传安装包sqoop-1.4.7.bin__hadoop-2.6.0.tar.gz到虚拟机中,
如我的上传目录是:/opt/software
3) 解压 sqoop 安装包到指定目录,如:
[admin@node21 software]$ tar zxvf sqoop-1.4.7.bin__hadoop-2.6.0.tar.gz -C /opt/module/ [admin@node21 module]$ mv sqoop-1.4.7.bin__hadoop-2.6.0 sqoop-1.4.7
3.2 修改配置文件
Sqoop 的配置文件与大多数大数据框架类似,在 sqoop 根目录下的 conf 目录中。
1) 重命名配置文件
[admin@node21 conf]$ cp sqoop-env-template.sh sqoop-env.sh
在conf目录下,有两个文件sqoop-site.xml和sqoop-site-template.xml内容是完全一样的,不必在意,我们只关心sqoop-site.xml即可。
1) 修改配置文件
sqoop-env.sh
export HADOOP_COMMON_HOME=/opt/module/hadoop-2.7.6 export HADOOP_MAPRED_HOME=/opt/module/hadoop-2.7.6 export HBASE_HOME=/opt/module/hbase-1.2.6 export HIVE_HOME=/opt/module/hive-2.3.3 export ZOOCFGDIR=/opt/module/zookeeper-3.4.12
3.3 拷贝JDBC驱动
[admin@node21 conf]$ cp /opt/software/mysql-connector-java-5.1.9.jar /opt/module/sqoop-1.4.7/lib/
3.4 配置环境变量
export SQOOP_HOME=/opt/module/sqoop-1.4.7 export PATH=$PATH:$SQOOP_HOME/bin
source /etc/profile
3.4 验证Sqoop
我们可以通过某一个 command 来验证 sqoop 配置是否正确:
[admin@node21 sqoop-1.4.7]$ sqoop help Warning: /opt/module/sqoop-1.4.7/../hcatalog does not exist! HCatalog jobs will fail. Please set $HCAT_HOME to the root of your HCatalog installation. Warning: /opt/module/sqoop-1.4.7/../accumulo does not exist! Accumulo imports will fail. Please set $ACCUMULO_HOME to the root of your Accumulo installation. 18/06/03 23:27:27 INFO sqoop.Sqoop: Running Sqoop version: 1.4.7 usage: sqoop COMMAND [ARGS] Available commands: codegen Generate code to interact with database records create-hive-table Import a table definition into Hive eval Evaluate a SQL statement and display the results export Export an HDFS directory to a database table help List available commands import Import a table from a database to HDFS import-all-tables Import tables from a database to HDFS import-mainframe Import datasets from a mainframe server to HDFS job Work with saved jobs list-databases List available databases on a server list-tables List available tables in a database merge Merge results of incremental imports metastore Run a standalone Sqoop metastore version Display version information See 'sqoop help COMMAND' for information on a specific command.
3.5 测试Sqoop是否能够成功连接数据库
$ bin/sqoop list-databases --connect jdbc:mysql://node21:3306/ --username root --password 123456 出现如下输出: information_schema hive mysql performance_schema sys
四 Sqoop的简单使用案例
4.1 导入数据
在 Sqoop 中,“导入”概念指:从非大数据集群(RDBMS)向大数据集群(HDFS,HIVE,HBASE)中传输数据,叫做:导入,即使用 import 关键字。
4.1.1 RDBMS到HDFS
1) 确定 Mysql 服务开启正常
2) 在 Mysql 中新建一张表并插入一些数据
$ mysql -uroot -p123456 mysql> create database company; mysql> create table company.staff(id int(4) primary key not null auto_increment, name varchar(255), sex varchar(255)); mysql> insert into company.staff(name, sex) values('Thomas', 'Male'); mysql> insert into company.staff(name, sex) values('Catalina', 'FeMale');
1) 导入数据
(1)全部导入
命令行方式:
$ bin/sqoop import --connect jdbc:mysql://node21:3306/company --username root --password 123456 --table staff --target-dir /sqoop/data --delete-target-dir --num-mappers 1 --fields-terminated-by " "
脚本方式:
在/opt/module/datas下创建一个sqoop1,txt(文件名自定义),内容如下
import --connect 'jdbc:mysql://node21:3306/company' --username root --password 123456 --table staff --target-dir /sqoop/data --num-mappers 1 --fields-terminated-by " "
然后在窗口执行命令 sqoop --options-file /opt/module/datas/sqoop1.txt
(2)查询导入
$ bin/sqoop import --connect jdbc:mysql://node21:3306/company --username root --password 123456 --target-dir /sqoop/data --delete-target-dir --num-mappers 1 --fields-terminated-by " " --query 'select name,sex from staff where id <=1 and $CONDITIONS;'
尖叫提示:must contain '$CONDITIONS' in WHERE clause.
尖叫提示:如果 query 后使用的是双引号,则$CONDITIONS 前必须加转移符,防止 shell 识别为自己的变量。
尖叫提示:--query 选项,不能同时与--table 选项使用
(3)导入指定列
$ bin/sqoop import --connect jdbc:mysql://node21:3306/company --username root --password 123456 --target-dir /sqoop/data --delete-target-dir --num-mappers 1 --fields-terminated-by " " --columns id,sex --table staff
尖叫提示:columns 中如果涉及到多列,用逗号分隔,分隔时不要添加空格
(4)使用 sqoop 关键字筛选查询导入数据
$ bin/sqoop import --connect jdbc:mysql://node21:3306/company --username root --password 123456 --target-dir /sqoop/data --delete-target-dir --num-mappers 1 --fields-terminated-by " " --table staff --where "id=1"
尖叫提示:在 Sqoop 中可以使用 sqoop import -D property.name=property.value 这样的方式加
入执行任务的参数,多个参数用空格隔开。
4.1.2 RDBMS到Hive
$ bin/sqoop import --connect jdbc:mysql://node21:3306/company --username root --password 123456 --table staff --num-mappers 1 --hive-import --fields-terminated-by " " --hive-overwrite --hive-table staff_hive
尖叫提示:该过程分为两步,第一步将数据导入到 HDFS,第二步将导入到 HDFS 的数据迁移到 Hive 仓库
尖叫提示:第一步默认的临时目录是/user/admin/表名
4.2 导出数据
在 Sqoop 中,“导出”概念指:从大数据集群(HDFS,HIVE,HBASE)向非大数据集群(RDBMS)中传输数据,叫做:导出,即使用 export 关键字。
4.2.1、HIVE/HDFS 到 RDBMS
$ bin/sqoop export --connect jdbc:mysql://node21:3306/company --username root --password 123456 --table staff --num-mappers 1 --export-dir /user/hive/warehouse/staff_hive --input-fields-terminated-by " "
尖叫提示:Mysql 中如果表不存在,不会自动创建
思考:数据是覆盖还是追加
4.3 脚本打包
使用 opt 格式的文件打包 sqoop 命令,然后执行
1) 创建一个.opt 文件
$ mkdir opt
$ touch opt/job_HDFS2RDBMS.opt
2) 编写 sqoop 脚本
$ vi opt/job_HDFS2RDBMS.opt export --connect jdbc:mysql://node21:3306/company --username root --password 123456 --table staff --num-mappers 1 --export-dir /user/hive/warehouse/staff_hive --input-fields-terminated-by " "
3) 执行该脚本
$ bin/sqoop --options-file opt/job_HDFS2RDBMS.opt
五 Sqoop一些常用命令参数
5.1 常用命令列举
这里给大家列出来了一部分 Sqoop 操作时的常用参数,以供参考,需要深入学习的可以参看对应类的源代码。
序号 |
命令 |
类 |
说明 |
1 |
import |
ImportTool |
将数据导入到集群 |
2 |
export |
ExportTool |
将集群数据导出 |
3 |
codegen |
CodeGenTool |
获取数据库中某张表数据生成Java 并打包Jar |
4 |
create-hive-table |
CreateHiveTableTool |
创建 Hive 表 |
5 |
eval |
EvalSqlTool |
查看 SQL 执行结果 |
6 |
import-all-tables |
ImportAllTablesTool |
导入某个数据库下所有表到 HDFS 中 |
7 |
job |
JobTool |
用来生成一个 sqoop的任务,生成后,该任务并不执行,除非使用命令执行该任务。 |
8 |
list-databases |
ListDatabasesTool |
列出所有数据库名 |
9 |
list-tables |
ListTablesTool |
列出某个数据库下所有表 |
10 |
merge |
MergeTool |
将 HDFS 中不同目录下面的数据合在一起,并存放在指定的目录中 |
11 |
metastore |
MetastoreTool |
记 录 sqoop job 的 元数据信息,如果不启动 metastore 实例,则默认的元数据存储目录为:~/.sqoop,如果要更改存储目录,可以 在 配 置 文 件sqoop-site.xml 中进行更改。 |
12 |
help |
HelpTool |
打印 sqoop 帮助信息 |
13 |
version |
VersionTool |
打印 sqoop 版本信息 |
5.2 命令&参数详解
刚才列举了一些 Sqoop 的常用命令,对于不同的命令,有不同的参数,让我们来一一列举说明。
首先来我们来介绍一下公用的参数,所谓公用参数,就是大多数命令都支持的参数。
5.2.1 公用参数:数据库连接
序号 |
参数 |
说明 |
1 |
--connect |
连接关系型数据库的 URL |
2 |
--connection-manager |
指定要使用的连接管理类 |
3 |
--driver |
JDBC 的 driver class |
4 |
--help |
打印帮助信息 |
5 |
--password |
连接数据库的密码 |
6 |
--username |
连接数据库的用户名 |
7 |
--verbose |
在控制台打印出详细信息 |
5.2.2 公用参数:import
序号 |
参数 |
说明 |
1 |
--enclosed-by <char> |
给字段值前后加上指定的字 符 |
2 |
--escaped-by <char> |
对字段中的双引号加转义符 |
3 |
--fields-terminated-by <char> |
设定每个字段是以什么符号 作为结束,默认为逗号 |
4 |
--lines-terminated-by <char> |
设定每行记录之间的分隔符, 默认是 |
5 |
--mysql-delimiters |
Mysql 默认的分隔符设置,字 段之间以逗号分隔,行之间以 分隔,默认转义符是,字 段值以单引号包裹。 |
6 |
--optionally-enclosed-by <char> |
给带有双引号或单引号的字 段值前后加上指定字符。 |
5.2.3 公用参数:export
序号 |
参数 |
说明 |
1 |
--input-enclosed-by <char> |
对字段值前后加上指定字符 |
2 |
--input-escaped-by <char> |
对含有转移符的字段做转义处理 |
3 |
--input-fields-terminated-by <char> |
字段之间的分隔符 |
4 |
--input-lines-terminated-by <char> |
行之间的分隔符 |
5 |
--input-optionally-enclosed-by <char> |
给带有双引号或单引号的字 段前后加上指定字符 |
5.2.4 公用参数:hive
序号 |
参数 |
说明 |
1 |
--hive-delims-replacement
<arg> |
用自定义的字符串替换掉数 据中的 和 |