Sqoop2Intermediate representation
在Sqoop2的connector中提供了自己的map处理,map用于导入数据到HDFS。因为这段代码将完全被connector维护,所以,我们需要找到一个适用所有connector和所有情况的中间格式(map output)。本文的目标是比较不同的中间数据格式(intermediate representation),以使我们为Sqoop2选择一个合适的。
Current solutions
我们已经找到的一些方法。不是重新发明轮子,本文包括已经存在的数据表示的方法的概要。
MySQL‘s mysqldump format
值的逗号分隔的列表出现在一行文本中。不同的数据类型像下面这样编码:
Data type
|
Serialized as
|
DATETIME
|
String with format YYYY-MM-DD HH:MM:DD (2012-01-01 09:09:09)
|
TIMESTAMP
|
String with format YYYY-MM-DD HH:MM:DD (2012-01-01 09:09:09)
|
DATE
|
String with format YYYY-MM-DD (2012-01-01)
|
TIME
|
String with format HH:MM:DD (09:09:09)
|
ENUM
|
String with enumerated value
|
SET
|
String with comma separated enumerated values
|
BIT
|
String (array of bites rounded up to 1 byte, 20 bits are rounded to 24 bits/3 bytes)
|
CHAR(varchar, text, blob)
|
String
|
FLOAT (double, ...)
|
Direct value, might be in scientific notation (666.6, 5.5e-39). MySQL is not supporting NaN and +/- Inf.
|
INT(small, big, ...)
|
Direct value (666)
|
DECIMAL(fixed, ...)
|
Direct value (66.6)
|
BOOL
|
Direct number (1 or 0)
|
DATE和DATETIME类型返回相同的内容(没有时区的转换),但是TIMESTAMP总是以UTC方式保存,自动转换为相关的时区。明确的时区描述似乎不是输出的一部分。
丢失的值用NULL常量代替(NULL不是一个字符串常量,因此不能被引用)。字符串有非常简单的编码方式,除了下面的byte,大多数字符直接打印:
Byte
|
Written as
|
0x00
|
\0
|
0x0A
|
\n
|
0x0D
|
\r
|
0x1A
|
\Z
|
0x22
|
\"
|
0x27
|
\‘
|
0x5C
|
\ \ (no space)
|
例如:
0,‘Hello world‘,‘Jarcec\‘s notes‘,NULL,66.6,‘2012-06-06 06:06:06‘
PostgreSQL‘s pg_dump format
与MySql dump格式的情况类似,数据被一行文本实例代表,多个列将被逗号分隔。字符串用单引号(例如‘String’)。所有的字符直接打印,除了单引号翻倍的时候,例如两个单引号代表,一个单引号在字符串内,并且字符串没有结束(例如:’Jarcec’’s notes’)。一个单引号需要用4个单引号表示,’’’’只代表一个’。Null(0x00)不允许在字符串常量内部。二进制常量也可在单引号被引用,但是会被转换为16就进制,带有\x前缀,例如’\x4d7953514c’代表字符串’MySQL’(被保存在二进制列)。
Data type
|
Serialized as
|
INT (and all variants)
|
Direct value (666)
|
NUMERIC
|
Direct value (66.60)
|
REAL(and all variants)
|
Direct value (66.5999985, 55e55) or string constant for special cases (‘Infinity‘, ‘-Infinity‘, ‘NaN‘)
|
VARCHAR(text, ...)
|
String
|
CHAR
|
String, unused positions at the end are filled with spaces
|
TIMESTAMP(date, time, ...)
|
String in format YYYY-MM-DD HH:MM:SS.ZZZZZZ (Date and hour part)
|
TIMESTAMP with time zone (and others)
|
String in format YYY-MM-DD HH:MM:SS.ZZZZZZ[+-]XX (‘2012-07-03 14:07:11.876239+02‘)
|
BOOLEAN
|
Constants true and false (not quoted as a String)
|
ENUM
|
String
|
ARRAY
|
String that contains special structure - ‘{ITEM1, ITEM2, ITEM3}‘, ITEMX itself might be in separate quotes if needed.
|
编码示例(一行数据):
666,
66.60,
‘jarcec‘,
‘Jarcec‘‘snotes‘,
‘2012-07-0314:07:11.876239‘,
true,
‘{1,2,
3}‘, NULL,
‘\x4d7953514c‘
Microsoft SQL Server‘s bcp utility
SQL Server bcp utility 默认产生二进制输出,这将使输出非常难理解。幸运的是,它可以被强制产生字符输出用命令行切换”-c“。在这种情况下,bcp工具将产生CSV文件,行分隔符可以用命令行’-t‘参数指定(默认是tab),类似地,可以使用”-r”指定行分隔符(默认是new line)。
下面是不同数据类型的概述:
Data type
|
Serialized as
|
VARCHAR(nvarchar, char,... )
|
Directly as it without any encoding, empty string is represented as zero byte
|
TIME
|
Constant in format HH:MM:DD.ZZZZZZ (01:01:01.0000000)
|
NUMERIC (decimal, ...)
|
Direct value (666.66)
|
NULL
|
Empty or missing value (for example when using comma as separator - ,,)
|
INT (and it‘s variants)
|
Direct value (666)
|
FLOAT(real, ...)
|
Direct value(33.299999999999997)
|
DATETIME
|
Constant in format YYYY-MM-DD HH:MM:DD.ZZZ (2012-06-06 01:01:01.000)
|
DATE
|
Constant in format YYYY-MM-DD (2012-01-01)
|
注意:字符串的列不允许包含行和列分隔符,这其实相当复杂的。
编码示例(这是一行数据):
35,15.20,33.299999999999997,2012-06-06,2012-06-06
01:01:01.000,01:01:01.0000000,jarcec‘scomment with, comma
AVRO
我们也可以使用AVRO作为中间数据的格式。Avro只支持有限的数据类型,所以我们必须自己编码一些类型(例如,我们可能用上边提到的类似的格式将Date类型编码成String类型)。Avro支持的格式可在下面的网址中查到:http://avro.apache.org/docs/current/spec.html#schema_primitive。Connector中mapper代码的示例将会是:
GenericRecordBuilderbuilder = new GenericRecordBuilder(getSchemaSomehow());
builder.set("column1",value1);
builder.set("columnX",valueX);
context.write(new AvroKey(builder.build()), NullWritable.get());
Netezza
我没有发现任何特别的数据导出工具。推荐使用nzsqp,保存输出到一个文件,也就是生成一个类似于mysql client标准输出的表格。
示例输出:
ID| TXT
----+------
2 | cau
1 | ahoj
(2 rows)
Teradata
Fast export utility compatibility
我们也研究了不同类型的快速导出工具的兼容性。
mysqldump –compatible
mysqldump工具包含一个参数 –compatible,接受参数”postgresql“。但是这个参数看起来不是有效的,因为使用此参数跟不使用时输出几乎一样。
1. 二进制常量很可能失败
2. 带时区信息的DataTime列将会获取服务器的默认时区
Sqoop2 Intermediate representation