本文介绍 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 支持的所有隐式转换。