dwloader 的数据类型转换规则 - 分析平台服务(PDW)

本文介绍 dwloader Command-Line Loader 将数据加载到 PDW 时支持的输入数据格式和隐式数据类型转换。 当输入数据与 SQL Server PDW 目标表中的数据类型不匹配时,会发生隐式数据转换。 在设计加载过程时使用此信息,以确保数据将成功加载到 SQL Server PDW 中。

将文本插入二进制类型

下表定义了接受的文本类型、格式和转换规则,用于将文本值加载到 二进制 (n)或 varbinary(n)的 SQL Server PDW 列中。

输入数据类型 输入数据示例 转换为二进制或 varbinary 数据类型
二进制文本 [0x]hexidecimal_string

示例:12Ef 或 0x12Ef
0x 前缀是可选的。

数据源长度不能超过为数据类型指定的字节数。

如果数据源长度小于二进制数据类型的大小,则通过在右侧用零进行填充来达到数据类型的大小。

在日期和时间类型中添加文字

日期和时间文本使用特定格式的字符串文本表示,用单引号括起来。 下表定义了允许的文本类型、格式和转换规则,用于将日期或时间文本加载到 datetime、 smalldatetime、 date、 time、 datetimeoffset 或 datetime2 类型的列中。 这些表定义给定数据类型的默认格式。 可以在 Datetime 格式部分定义可指定的其他格式。 日期和时间文字不能包含前导或尾随空格。 日期、 smalldatetime 和 null 值不能在固定宽度模式下加载。

datetime 数据类型

下表定义了将文本值加载到 日期时间类型的列中的默认格式和规则。 空字符串 ('') 转换为默认值“1900-01-01 12:00:00.000”。 仅包含空白的字符串 (' ') 将生成错误。

输入数据类型 输入数据示例 转换为日期/时间数据类型
日期/时间格式的字符串文本 'yyyy-MM-dd hh:mm:ss[.fff]'

示例:“2007-05-08 12:35:29.123”
插入值时,缺少的小数位数设置为 0。 例如,文本“2007-05-08 12:35”插入为“2007-05-08 12:35:00.000”。
smalldatetime 格式的字符串文本 'yyyy-MM-dd hh:mm'

示例:“2007-05-08 12:35”
插入值时,秒数和剩余的小数位数设置为 0。
日期格式的字符串文本 'yyyy-MM-dd'

示例:“2007-05-08”
插入值时,时间值(小时、分钟、秒和分数)设置为 12:00:00.000。
datetime2 格式的字符串文本 'yyyy-MM-dd hh:mm:ss.fffffff'

示例:“2007-05-08 12:35:29.1234567”
源数据不能超过三个小数位数。 例如,将插入文本“2007-05-08 12:35:29.123”,但值“2007-05-8 12:35:29.1234567”将生成错误。

smalldatetime 数据类型

下表定义了将文本值加载到 smalldatetime 类型的列中的默认格式和规则。 空字符串 ('') 转换为默认值“1900-01-01 12:00”。 仅包含空白的字符串 (' ') 将生成错误。

输入数据类型 输入数据示例 转换为 smalldatetime 数据类型
smalldatetime 格式的字符串文本 'yyyy-MM-dd hh:mm' 或 'yyyy-MM-dd hh:mm:ss'

示例:“2007-05-08 12:00”或“2007-05-08 12:00:15”
源数据必须具有年份、月、日期、小时和分钟的值。 秒是可选的,如果存在,则必须设置为值 00。 任何其他值都生成错误。

秒是可选的。 加载到 smalldatetime 列时,dwloader 将秒和小数秒向上舍入。 例如,1999-01-05 20:10:35.123 将加载为 01-05 20:11。
日期格式的字符串文本 'yyyy-MM-dd'

示例:“2007-05-08”
插入值时,时间值(小时、分钟、秒和分数)设置为 0。

date 数据类型

下表定义了将文本值加载到 日期类型的列中的默认格式和规则。 空字符串 ('') 转换为默认值“1900-01-01”。 仅包含空白的字符串 (' ') 将生成错误。

输入数据类型 输入数据示例 转换为日期数据类型
日期格式的字符串文本 'yyyy-MM-dd'

示例:“2007-05-08”

时间数据类型

下表定义了将文本值加载到类型 时间列中的默认格式和规则。 空字符串 ('') 转换为默认值“00:00:00.0000”。 仅包含空白的字符串 (' ') 将生成错误。

输入数据类型 输入数据示例 时间数据类型转换
时间格式的字符串文本 'hh:mm:ss.fffffff'

示例:“12:35:29.1234567”
如果数据源的精度(小数位数)小于或等于 时间 数据类型的精度(小数位数),则数据在右侧用零填充。 例如,文本值“12:35:29.123”插入为“12:35:29.1230000”。

datetimeoffset 数据类型

下表定义了将文本值加载到 datetimeoffset 类型的列中的默认格式和规则(n)。 默认格式为“yyyy-MM-dd hh:mm:ss.fffffff {+|-}hh:mm”。 空字符串 ('') 转换为默认值“1900-01-01 12:00:00.0000000 +00:00”。 仅包含空白的字符串 (' ') 将生成错误。 小数位数的数量取决于列定义。 例如,定义为 datetimeoffset (2) 的列将具有两个小数位数。

输入数据类型 输入数据示例 转换为 datetimeoffset 数据类型
日期/时间格式的字符串文本 'yyyy-MM-dd hh:mm:ss[.fff]'

示例:“2007-05-08 12:35:29.123”
插入值时,缺少的小数位数和偏移值会被设置为 0。 例如,文本“2007-05-08 12:35:29.123”插入为“2007-05-08 12:35:29.1230000 +00:00”。
smalldatetime 格式的字符串文本 'yyyy-MM-dd hh:mm'

示例:“2007-05-08 12:35”
插入值时,秒、剩余的小数位数和时间偏移都设置为 0。
日期格式的字符串文本 'yyyy-MM-dd'

示例:“2007-05-08”
插入值时,时间值(小时、分钟、秒和分数)设置为 0。 例如,文本“2007-05-08”插入为“2007-05-08 00:00:00.0000000 +00:00”。
datetime2 格式的字符串文本 'yyyy-MM-dd hh:mm:ss.fffffff'

示例:“2007-05-08 12:35:29.1234567”
源数据不能超过 datetimeoffset 列中指定的小数秒数。 如果数据源的小数秒数较少或等于规定的小数秒数,则在右侧用零填充。 例如,如果数据类型为 datetimeoffset (5),则文本值“2007-05-08 12:35:29.123 +12:15”插入为“12:35:29.12300 +12:15”。
datetimeoffset 格式的字符串文本 'yyyy-MM-dd hh:mm:ss.fffffff {+|-} hh:mm'

示例:“2007-05-08 12:35:29.1234567 +12:15”
源数据不能超过 datetimeoffset 列中指定的小数秒数。 如果数据源的小数秒数较少或等于规定的小数秒数,则在右侧用零填充。 例如,如果数据类型为 datetimeoffset (5),则文本值“2007-05-08 12:35:29.123 +12:15”插入为“12:35:29.12300 +12:15”。

datetime2 数据类型

下表定义了将文本值加载到 datetime2 类型的列中的默认格式和规则(n)。 默认格式为“yyyy-MM-dd hh:mm:ss.fffffff”。 空字符串 ('') 转换为默认值“1900-01-01 12:00:00”。 仅包含空白的字符串 (' ') 将生成错误。 小数位数的数量取决于列定义。 例如,定义为 datetime2(2 )的列将具有两个小数位数。

输入数据类型 输入数据示例 转换为 datetime2 数据类型
日期/时间格式的字符串文本 'yyyy-MM-dd hh:mm:ss[.fff]'

示例:“2007-05-08 12:35:29.123”
小数秒是可选的,在插入值时设置为 0。
smalldatetime 格式的字符串文本 'yyyy-MM-dd hh:mm'

示例:“2007-05-08 12”
插入值时,可选秒数和剩余的小数位数设置为 0。
日期格式的字符串文本 'yyyy-MM-dd'

示例:“2007-05-08”
插入值时,时间值(小时、分钟、秒和分数)设置为 0。 例如,文本“2007-05-08”插入为“2007-05-08 12:00:00.0000000”。
datetime2 格式的字符串文本 'yyyy-MM-dd hh:mm:ss:fffffff'

示例:“2007-05-08 12:35:29.1234567”
如果数据源包含小于或等于 datetime2(n)中指定的值的数据和时间组件,则插入数据;否则将生成错误。

日期时间格式

Dwloader 支持以下数据格式用于将输入数据加载到 SQL Server PDW。 表后面列出了更多详细信息。

日期/时间 smalldatetime 日期 datetime2 datetimeoffset
[M[M]]M-[d]d-[yy]yy HH:mm:ss[.fff] [M[M]]M-[d]d-[yy]yy HH:mm[:00] [M[M]]M-[d]d-[yy]yy [M[M]]M-[d]d-[yy]yy HH:mm:ss[.fffffff] [M[M]]M-[d]d-[yy]yy HH:mm:ss[.fffffff] zzz
[M[M]]M-[d]d-[yy]yy hh:mm:ss[.fff][tt] [M[M]]M-[d]d-[yy]yy hh:mm[:00][tt] [M[M]]M-[d]d-[yy]yy hh:mm:ss[.fffffff][tt] [M[M]]M-[d]d-[yy]yy hh:mm:ss[.fffffff][tt] zzz
[M[M]]M-[yy]yy-[d]d HH:mm:ss[.fff] [M[M]]M-[yy]yy-[d]d HH:mm[:00] [M[M]]M-[yy]yy-[d]d [M[M]]M-[yy]yy-[d]d HH:mm:ss[.fffffff] [M[M]]M-[yy]yy-[d]d HH:mm:ss[.fffffff] zzz
[M[M]]M-[yy]yy-[d]d hh:mm:ss[.fff][tt] [M[M]]M-[yy]yy-[d]d hh:mm[:00][tt] [M[M]]M-[yy]yy-[d]d hh:mm:ss[.fffffff][tt] [M[M]]M-[yy]yy-[d]d hh:mm:ss[.fffffff][tt] zzz
[yy]yy-[M[M]]M-[d]d HH:mm:ss[.fff] [yy]yy-[M[M]]M-[d]d HH:mm[:00] [yy]yy-[M[M]]M-[d]d [yy]yy-[M[M]]M-[d]d HH:mm:ss[.fffffff] [yy]yy-[M[M]]M-[d]d HH:mm:ss[.fffffff] zzz
[yy]yy-[M[M]]M-[d]d hh:mm:ss[.fff][tt] [yy]yy-[M[M]]M-[d]d hh:mm[:00][tt] [yy]yy-[M[M]]M-[d]d hh:mm:ss[.fffffff][tt] [yy]yy-[M[M]]M-[d]d hh:mm:ss[.fffffff][tt] zzz
[yy]yy-[d]d-[M[M]]M HH:mm:ss[.fff] [yy]yy-[d]d-[M[M]]M HH:mm[:00] [yy]yy-[d]d-[M[M]]M [yy]yy-[d]d-[M[M]]M HH:mm:ss[.fffffff] [yy]yy-[d]d-[M[M]]M HH:mm:ss[.fffffff] zzz
[yy]yy-[d]d-[M[M]]M hh:mm:ss[.fff][tt] [yy]yy-[d]d-[M[M]]M hh:mm[:00][tt] [yy]yy-[d]d-[M[M]]M hh:mm:ss[.fffffff][tt] [yy]yy-[d]d-[M[M]]M hh:mm:ss[.fffffff][tt] zzz
[d]d-[M[M]]M-[yy]yy HH:mm:ss[.fff] [d]d-[M[M]]M-[yy]yy HH:mm[:00] [d]d-[M[M]]M-[yy]yy [d]d-[M[M]]M-[yy]yy HH:mm:ss[.fffffff] [d]d-[M[M]]M-[yy]yy HH:mm:ss[.fffffff] zzz
[d]d-[M[M]]M-[yy]yy hh:mm:ss[.fff][tt] [d]d-[M[M]]M-[yy]yy hh:mm[:00][tt] [d]d-[M[M]]M-[yy]yy hh:mm:ss[.fffffff][tt] [d]d-[M[M]]M-[yy]yy hh:mm:ss[.fffffff][tt] zzz
[d]d-[yy]yy-[M[M]]M HH:mm:ss[.fff] [d]d-[yy]yy-[M[M]]M HH:mm[:00] [d]d-[yy]yy-[M[M]]M [d]d-[yy]yy-[M[M]]M HH:mm:ss[.fffffff] [d]d-[yy]yy-[M[M]]M HH:mm:ss[.fffffff] zzz
[d]d-[yy]yy-[M[M]]M hh:mm:ss[.fff][tt] [d]d-[yy]yy-[M[M]]M hh:mm[:00][tt] [d]d-[yy]yy-[M[M]]M hh:mm:ss[.fffffff][tt] [d]d-[yy]yy-[M[M]]M hh:mm:ss[.fffffff][tt] zzz

Details:

  • 若要分隔月份、日和年值,可以使用“-”、“/”或“ 。 '. 为简单起见,该表仅使用 '- ' 分隔符。

  • 若要将月份指定为文本,请使用三个或多个字符。 包含 1 或 2 个字符的月份将解释为数字。

  • 若要分隔时间值,请使用 “: ' 符号。

  • 括在方括号中的字母是可选的。

  • 字母“tt”指定 AM|PM|am|pm。 AM 是默认值。 指定“tt”时,小时值 (hh) 必须介于 0 到 12 的范围内。

  • 字母“zzz”以格式 {+|-}HH:ss]指定系统的当前时区的时区偏移量。

将文本插入数值类型

下表定义了用于将文本值加载到使用数值类型的 SQL Server PDW 列的默认格式和转换规则。

位数据类型

下表定义了将文本值加载到类型 位列中的默认格式和规则。 空字符串 ('') 或仅包含空白的字符串 (' ') 转换为 0。

输入数据类型 输入数据示例 转换为位数据类型
整数格式的字符串文本 “ffffffffff”

示例:“1”或“321”
格式化为字符串文本的整数值不能包含负值。 例如,值“-123”生成错误。

大于 1 的值转换为 1。 例如,值“123”转换为 1。
字符串字面量 “TRUE”或“FALSE”

示例:“true”
值“TRUE”转换为 1;值“FALSE”转换为 0。
整数文本 fffffffn

示例:1 或 321
大于 1 或小于 0 的值转换为 1。 例如,值 123 和 -123 转换为 1。
十进制文本 fffnn.fffn

示例:1234.5678
大于 1 或小于 0 的值转换为 1。 例如,值 123.45 和 -123.45 转换为 1。

十进制数据类型

下表定义了将文本值加载到 小数 类型的列中的规则(p,s)。 数据转换规则与 SQL Server 相同。 有关详细信息,请参阅 MSDN 上的 数据类型转换(数据库引擎 )。

输入数据类型 输入数据示例
整数文本 321312313123
十进制文本 123344.34455

float 和 real 数据类型

下表定义了将文本值加载到 float 或 real 类型的列中的规则。 数据转换规则与 SQL Server 相同。 有关详细信息,请参阅 MSDN 上的 数据类型转换(数据库引擎 )。

输入数据类型 输入数据示例
整数文本 321312313123
十进制文本 123344.34455
浮点文本 3.12323E+14

int、bigint、tinyint、smallint 数据类型

下表定义了将文本值加载到 int、bigint、tinyint 或 smallint 类型的列中的规则。 数据源不能超过给定数据类型允许的范围。 例如,tinyint 的范围为 0 到 255,int 的范围为 -2,147,483,648 到 2,147,483,647。

输入数据类型 输入数据示例 转换为整数数据类型
整数文本 321312313123
十进制文本 123344.34455 小数点右侧的值将被截断。

money 和 smallmoney 数据类型

货币文本值表示为具有可选小数点的数字字符串,以及作为前缀的可选货币符号。 数据源不能超过给定数据类型允许的范围。 例如, smallmoney 的范围是 -214,748.3648 到 214,748.3647, 货币 的范围是 -922,3 37,203,685,477.5808 到 922,337,203,685,477.5807。 下表定义了将文本值加载到 货币 或 smallmoney 类型的列中的规则。

输入数据类型 输入数据示例 转换为 money 或 smallmoney 数据类型
整数文本 321312 插入值时,小数点后面的缺失数字设置为 0。 例如,数字 12345 插入为 12345.0000
十进制文本 123344.34455 如果小数点后的位数超过 4,则该值向上舍入为最接近的值。 例如,值 123344.34455 作为 123344.3446 插入。
货币字面量 $123456.7890 货币符号未插入该值。

如果小数点后的位数超过 4,则该值向上舍入为最接近的值。

将字面值插入到字符串类型中

下表定义了用于将文本值加载到使用字符串类型的 SQL Server PDW 列的默认格式和转换规则。

char、varchar、nchar 和 nvarchar 数据类型

下表定义了将文本值加载到 char、varchar、nchar 和 nvarchar 类型的列中的默认格式和规则。 数据源长度不能超过为数据类型指定的大小。 如果数据源长度小于 char 或 nchar 数据类型的大小,则用空格填充到右侧,以达到数据类型大小。

输入数据类型 输入数据示例 转换为字符数据类型
字符串字面量 格式:“字符串”

示例:“abc”
暂无
Unicode 字符串文本 格式:N'字符串'

示例:N'abc'
暂无
整数文本 格式:ffffffffffn

示例:321312313123
暂无
十进制文本 格式:ffffff.fffffff

示例:12344.34455
暂无
货币字面量 格式:$ffffff.fffnn

示例:$123456.99
可选货币符号未随值一起插入。 若要插入货币符号,请将值作为字符串文本插入。 这将匹配加载程序的格式,它将每个文本视为字符串文本。

不允许使用逗号。

如果小数点后的位数超过 2,则该值向上舍入为最接近的值。 例如,值 123.946789 插入为 123.95。

使用 CONVERT 函数插入货币文本时,仅允许默认样式 0(小数点后没有逗号和 2 位数字)。

一般备注

dwloader 执行 SMP SQL Server 执行的同一隐式转换,但不支持 SMP SQL Server 支持的所有隐式转换。