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

适用于:SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsMicrosoft Fabric 中的 SQL 数据库

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

bcp 关于字段长度的提示

如果交互式bcp命令包含in或out选项,而没有使用格式文件开关(-f)或数据格式开关(-n、-c、-w、-N),则命令会提示输入每个数据字段的字段长度,如下:

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

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

注意

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

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

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

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

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

使用默认字段长度

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

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

重要

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

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

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

数据类型 默认长度(字符数)
char 定义的列长度
varchar 定义的列长度
nchar 定义的列长度的两倍
nvarchar 定义的列长度的两倍
Text 0
ntext 0
比特 1
binary 定义的列长度的两倍 + 1
varbinary 定义的列长度的两倍 + 1
图像 0
datetime 24
smalldatetime 24
float 30
真实 30
int 12
bigint 19
smallint 7
tinyint 5
money 30
smallmoney 30
小数 41 1
numeric 41 1
uniqueidentifier 37
timestamp 17
varchar(max) 0
varbinary(max) 0
nvarchar(max) 0
UDT 用户定义术语 (UDT) 列长度
XML 0
矢量 不适用 2

1 有关十进制和数值数据类型的详细信息,请参阅十进制和数值(Transact-SQL)。

2 不允许将 向量 数据类型转换到字符类型,也不允许从字符类型转换为向量数据类型。

注意

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

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

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

数据类型 默认长度(字符数)
比特 1
binary 定义的列长度
varbinary 定义的列长度
图像 0
datetime 8
smalldatetime 4
float 8
真实 4
int 4
bigint 8
smallint 2
tinyint 1
money 8
smallmoney 4
小数 1
numeric 1
uniqueidentifier 16
timestamp 8
矢量 8 字节向量标头 + 浮点数组大小

1 有关十进制和数值数据类型的详细信息,请参阅十进制和数值(Transact-SQL)。

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