使用 bcp 指定字段长度 (SQL Server)

适用于:SQL Server Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)

字段长度指示以字符格式表示数据时所要求的最大字符数。 如果数据以本机格式存储,则字段长度就是已知的,例如, int 数据类型占 4 个字节。 如果指示前缀长度为 0,则 bcp 命令会提示输入字段长度、默认字段长度以及字段长度对包含 char 数据的数据文件中数据存储的影响。

bcp 提示输入字段长度

如果某个交互式 bcp 命令包含不带格式化文件开关 ( -f) 或数据格式开关( -n-c-w-N)的 inout 选项,则该命令会提示输入每个数据字段的字段长度,如下所示:

Enter length of field <field_name> [<default>]:

有关在上下文中显示此提示符的示例,请参阅在使用 bcp 时指定数据格式以获得兼容性 (SQL Server)

注意

在你以交互方式指定 bcp 命令中的所有字段后,该命令会提示你将自己对每个字段的响应保存到一个非 XML 格式化文件中。 有关非 XML 格式文件的详细信息,请参阅非 XML 格式化文件 (SQL Server)

bcp 命令是否提示输入字段长度取决于若干因素,如下所示:

  • 当复制非固定长度的数据类型并指定前缀长度为 0 时, bcp 命令会提示输入字段长度。

  • 当将非字符数据转换为字符数据时, bcp 会建议一个足以存储该数据的默认字段长度。

  • 如果文件存储类型为非字符类型,则 bcp 命令不会提示输入字段长度。 数据将以 Microsoft SQL Server 本机数据表示形式(本机格式)存储。

使用默认字段长度

通常, Microsoft 会建议你接受 bcp建议的默认字段长度值。 如果已创建了字符模式数据文件,则使用默认字段长度可确保数据不会被截断,并且不会发生数字溢出错误。

如果指定的字段长度不正确,可能会发生问题。 例如,当复制数字数据并且为该数据指定的字段长度过短时, bcp 实用工具将显示一条溢出消息而不复制数据。 另外,当导出 datetime 数据并且为该字符串指定的字段长度少于 26 个字节时, bcp 实用工具将截断数据而不显示任何错误消息。

重要

使用默认大小选项时, SQL Server 需要读取整个字符串。 在某些情况下,使用默认字段长度可能导致“意外的文件结尾”错误。 通常情况下,当使用 moneydatetime 数据类型而数据文件中只出现了所需字段的一部分时,就会发生此类错误;例如指定了 mm dd yy/格式中的/datetime 值而没有指定时间部分,因而该值少于以 char 格式表示 datetime 值所需的 24 个字符。 若要避免此类错误,请使用字段终止符或具有固定长度的数据字段,或者通过指定其他值来更改默认字段长度。

字符文件存储的默认字段长度

下表列出了要存储为字符文件存储类型的数据的默认字段长度。 可为空值的数据与非空数据的长度相同。

数据类型 默认长度(字符数)
char 定义的列长度
varchar 定义的列长度
nchar 定义的列长度的两倍
nvarchar 定义的列长度的两倍
Text 0
ntext 0
bit 1
binary 定义的列长度的两倍 + 1
varbinary 定义的列长度的两倍 + 1
图像 0
datetime 24
smalldatetime 24
float 30
real 30
int 12
bigint 19
smallint 7
tinyint 5
money 30
smallmoney 30
decimal 41*
numeric 41*
uniqueidentifier 37
timestamp 17
varchar(max) 0
varbinary(max) 0
nvarchar(max) 0
UDT 用户定义的字词 (UDT) 列长度
XML 0

*有关 decimal 和 numeric 数据类型的详细信息,请参阅 decimal 和 numeric (Transact-SQL)

注意

类型为 tinyint 的列的值介于 0 到 255 之间;表示该范围内的任意数值所需的最大字符数是三(用于表示 100 到 255 之间的值)。

本机文件存储的默认字段长度

下表列出了要存储为本机文件存储类型的数据的默认字段长度。 可为空值的数据与非空数据的长度相同,并且字符数据始终以字符格式存储。

数据类型 默认长度(字符数)
bit 1
binary 定义的列长度
varbinary 定义的列长度
图像 0
datetime 8
smalldatetime 4
float 8
real 4
int 4
bigint 8
smallint 2
tinyint 1
money 8
smallmoney 4
decimal *
numeric *
uniqueidentifier 16
timestamp 8

*有关 decimal 和 numeric 数据类型的详细信息,请参阅 decimal 和 numeric (Transact-SQL)

在上述所有情况中,若要创建日后要重新加载到 SQL Server 中的数据文件并使存储空间保持最小,请使用长度前缀,以及默认文件存储类型和默认字段长度。

另请参阅

bcp 实用工具
数据类型 (Transact-SQL)
指定字段终止符和行终止符 (SQL Server)
使用 bcp 指定数据文件中的前缀长度 (SQL Server)
使用 bcp 指定文件存储类型 (SQL Server)
在批量导入期间保留 Null 或使用默认值 (SQL Server)