bcp 实用工具

bcp实用工具在 Microsoft® SQL Server™ 2000 实例和数据文件之间以用户指定的格式复制数据。

语法

bcp{[[database_name.][owner].]{table_name|view_name}|"query"}
5lTE ]'swRE,y+S0    {in|out|queryout|format}data_file
C;N"wd2K%Pq m0    [-mmax_errors] [-fformat_file] [-eerr_file]ITPUB个人空间2q)v;Tah W@$|
c
    [-Ffirst_row] [-Llast_row] [-bbatch_size]
;^p-e U&@J`Kp:V{f0    [-n] [-c] [-w] [-N] [-V(60|65|70)] [-6]
n Fm
u;PpO0    [-q] [-Ccode_page] [-tfield_term] [-rrow_term]ITPUB个人空间8fVe7R|k)~"tb%V/v
    [-iinput_file] [-ooutput_file] [-apacket_size]ITPUB个人空间,{:It5|q'x%BXv9R
    [-Sserver_name[\instance_name]] [-Ulogin_id] [-Ppassword]ITPUB个人空间@Z n F*\
    [-T] [-v] [-R] [-k] [-E] [-h"hint[,...n]"]

参数

database_name

指定的表或视图所在数据库的名称。如果未指定，则为用户默认数据库。

owner

表或视图所有者的名称。如果执行大容量复制操作的用户拥有指定的表或视图，则owner是可选的。如果没有指定owner并且执行大容量复制操作的用户不拥有指定的表或视图，则 Microsoft® SQL Server™ 2000 将返回错误信息并取消大容量复制操作。

table_name

是将数据复制到 SQL Server 时 (in) 的目的表名，以及从 SQL Server 复制数据时 (out) 的源表名。

view_name

是将数据复制到 SQL Server 时 (in) 的目的视图名，以及从 SQL Server 复制数据时 (out) 的源视图名。只有其中所有列都引用同一个表的视图才能用作目的视图。有关将数据复制到视图的限制的更多信息，请参见INSERT。

Query

是返回一个结果集的 Transact-SQL 查询。如果查询返回多个结果集，例如指定 COMPUTE 子句的 SELECT 语句，只有第一个结果集将复制到数据文件，随后的结果集被忽略。使用双引号引起查询语句，使用单引号引起查询语句中嵌入的任何内容。在从查询中大容量复制数据时，还必须指定queryout。

in|out|queryout|format

指定大容量复制的方向。in是从文件复制到数据库表或视图，out是指从数据库表或视图复制到文件。只有从查询中大容量复制数据时，才必须指定queryout。根据指定的选项（-n、-c、-w、-6或-N）以及表或视图分隔符，format将创建一个格式文件。如果使用format，则还必须指定-f选项。

说明  Microsoft SQL Server 6.5 中的bcp实用工具不支持大容量复制到包含sql_variant或bigint数据类型的表。

data_file

大容量复制表或视图到磁盘（或者从磁盘复制）时所用数据文件的完整路径。当将数据大容量复制到 SQL Server 时，此数据文件包含将复制到指定表或视图的数据。当从 SQL Server 大容量复制数据时，该数据文件包含从表或视图复制的数据。路径可以有 1 到 255 个字符。

-mmax_errors

指定在大容量复制操作取消之前可能产生的错误的最大数目。bcp无法复制的每一行都将被忽略并计为一个错误。如果没有包括该选项，则默认为 10。

-fformat_file

指定格式文件的完整路径，该格式文件包含以前在同一个表或视图上使用bcp时的存储响应。当使用由format选项所创建的格式文件大容量复制入或复制出数据时，使用此选项。格式文件的创建是可选的。在提示几个格式问题之后，bcp将提示是否在格式文件中保存回答。默认文件名为 Bcp.fmt。大容量复制数据时，bcp可引用一个格式文件，因此不必重新交互输入以前的回答。如果未使用此选项，也没有指定–n、-c、-w、-6或-N，则bcp将提示输入格式信息。

-eerr_file

指定错误文件的完整路径，此错误文件用于存储bcp无法从文件传输到数据库的所有行。来自bcp的错误信息将发送到用户工作站。如果未使用此选项，则不创建错误文件。

-Ffirst_row

指定要大容量复制的第一行的序数。默认值是 1，表示在指定数据文件的第一行。

-Llast_row

指定要大容量复制的最后一行的序数。默认值是 0，表示指定数据文件中的最后一行。

-bbatch_size

指定所复制的每批数据中的行数。每个批处理作为一个事务复制至服务器。SQL Server 提交或回滚（在失败时）每个批处理的事务。默认情况下，指定的数据文件中的所有数据都作为一批复制。请不要与-h"ROWS_PER_BATCH =bb"选项一起使用。

-n

使用数据的本机（数据库）数据类型执行大容量复制操作。此选项不提示输入每一字段，它将使用本机值。

-c

使用字符数据类型执行大容量复制操作。此选项不提示输入每一字段；它使用char作为存储类型，不带前缀，\t（制表符）作为字段分隔符，\n（换行符）作为行终止符。

-w

使用 Unicode 字符执行大容量复制操作。此选项不提示输入每一字段；它使用nchar作为存储类型，不带前缀，\t（制表符）作为字段分隔符，\n（换行符）作为行终止符。不能在 SQL Server 6.5 版或更早版本中使用。

-N

对非字符数据使用数据的本机（数据库）数据类型和对字符数据使用 Unicode 字符类型执行大容量复制操作。这是可替代-w选项的性能更高的选项，其目的是使用数据文件将数据从一个 SQL Server 传输到另一个 SQL Server 中。它不提示输入每一字段。在需要传输包含 ANSI 扩展字符的数据以及想利用本机模式的性能时，可以使用这一选项。不能在 SQL Server 6.5 版或更早版本中使用-N选项。

-V(60|65|70)

使用 SQL Server 早期版本中的数据类型执行大容量复制操作。此选项与字符 (-c) 或本机 (-n) 格式一起使用。此选项并不提示输入每一字段，它使用默认值。例如，若要将 SQL Server 6.5 中的bcp实用工具所支持（但 ODBC 不再支持）的日期格式大容量复制到 SQL Server 2000，可使用-V 65参数。

重要  将数据从 SQL Server 大容量复制到数据文件时，即使指定了–V，bcp实用工具也不会为任何datetime或smalldatetime数据生成 SQL Server 6.0 或 SQL Server 6.5 的日期格式。日期将始终以 ODBC 格式写入。另外，由于 SQL Server 6.5 版或更早版本不支持可为空的bit数据，因此bit列中的空值写为值 0。

-6

使用 SQL Server 6.0 或 SQL Server 6.5 数据类型执行大容量复制操作。仅为保持向后兼容性。改为使用–V选项。

-q

在bcp实用工具和 SQL Server 实例的连接中执行 SET QUOTED_IDENTIFIERS ON 语句。使用该选项指定包含空格或引号的数据库、所有者、表或视图的名称。将由三部分组成的整个表名或视图名引在双引号 (" ") 中。

-Ccode_page

仅为保持向后兼容性。作为代替，请在格式文件或交互式bcp中为每一列指定一个排序规则名。

指定数据文件中的数据代码页。只有当数据中包含字符值大于 127 或小于 32 的char、varchar或text列时，code_page才有用。

-tfield_term

指定字段终止符。默认的字段终止符是\t（制表符）。使用此参数替代默认字段终止符。

-rrow_term

指定行终止符。默认的行终止符是\n（换行符）。使用此参数替代默认行终止符。

-iinput_file

指定响应文件的名称，使用交互模式（未指定–n、-c、-w、-6或-N）执行大容量复制时，响应文件包含对每一字段命令提示问题的响应。

-ooutput_file

指定接收bcp输出（从命令提示重定向）的文件的名称。

-apacket_size

指定发送到和发送自服务器的每个网络数据包的字节数。可以使用 SQL Server 企业管理器（或sp_configure系统存储过程）设置服务器配置选项。但是，使用此选项可以单个地替代服务器配置选项。packet_size可以设置为 4096 到 65535 字节，默认值为 4096。

数据包大小的增加能够提高大容量复制操作的性能。如果要求一个较大的数据包而得不到，则使用默认设置。bcp生成的性能统计显示出所使用数据包的大小。

-Sserver_name[\instance_name]

指定要连接到的 SQL Server 实例。指定server_name以连接该服务器上的 SQL Server 默认实例。指定server_name\instance_name以连接到该服务器上的 SQL Server 2000 命名实例。如果未指定服务器，则bcp连接到本地计算机上的 SQL Server 默认实例。从网络上的远程计算机执行bcp时，要求此选项。

-Ulogin_id

指定用于连接到 SQL Server 的登录 ID。

-Ppassword

指定登录 ID 的密码。如果未使用此选项，则bcp将提示输入密码。如果不带密码将此选项用于命令提示行末尾，则 bcp 将使用默认密码 (NULL)。

-T

指定bcp使用网络用户的安全凭据，通过信任连接连接到 SQL Server。不需要login_id和password。

-v

报告bcp实用工具的版本号和版权。

-R

指定使用为客户端计算机的区域设置定义的区域格式，将货币、日期和时间数据大容量复制到 SQL Server 中。默认情况下，将会忽略区域设置。

-k

指定在大容量复制操作中空列应保留一个空值，而不是对插入的列赋予默认值。

-E

指定标识列的值出现在要导入的文件中。如果没有给出-E，则正导入的数据文件中此列的标识值将被忽略，而且 SQL Server 2000 会根据创建表期间指定的种子值和增量值自动指派唯一的值。如果数据文件的表或视图中不包含标识列的值，则使用格式文件指定导入数据时应跳过表或视图中的标识列；SQL Server 2000 将自动为该列指派唯一值。有关详细信息，请参见DBCC CHECKIDENT。

-h"hint[,...n]"

指定在大容量复制数据到表或视图时所使用的提示。在大容量复制数据到 SQL Server 6.x或更早版本时，不能使用此选项。