IBCPSession::BCPInit (OLE DB)

适用于: SQL Server(所有受支持的版本) Azure SQL 数据库 Azure SQL 托管实例 Azure Synapse Analytics Analytics Platform System (PDW)

下载 OLE DB 驱动程序

初始化大容量复制结构,执行某些错误检查,验证数据和格式化文件名是否正确,然后打开文件。

语法

  
HRESULT BCPInit(   
      const wchar_t *pwszTable,  
      const wchar_t *pwszDataFile,  
      const wchar_t *pwszErrorFile,  
      int eDirection);  

备注

在调用任何其他大容量复制方法之前,应先调用 BCPInit 方法 。 BCPInit 方法将对工作站和 SQL Server 之间的大容量数据复制执行必要的初始化。

BCPInit 方法将检查数据库源表或目标表的结构,而不检查数据文件 。 该方法将基于数据库表、视图或 SELECT 结果集中的每一列为数据文件指定数据格式值。 此指定包括每一列的数据类型、数据中是否存在长度或 Null 指示符和终止符字节字符串以及固定长度的数据类型的宽度。 BCPInit 方法按如下方式设置这些值 :

  • 指定的数据类型是数据库表、视图或 SELECT 结果集中的列的数据类型。 数据类型是通过 Microsoft OLE DB Driver for SQL Server 头文件中指定的 SQL Server 本机数据类型枚举的。 数据类型的值为 BCP_TYPE_XXX 模式。 数据将以其计算机形式表示。 也就是说,整数数据类型的列中的数据通过一个由四个字节组成的序列表示,该序列采用 big-endian 或 little-endian 格式,具体使用哪种格式取决于创建该数据文件的计算机。

  • 如果数据库数据类型的长度是固定的,则该数据文件中的数据长度也是固定的。 处理数据的大容量复制方法(例如 IBCPSession::BCPExec)将对数据文件中的数据长度预期与数据库表、视图或 SELECT 列列表中指定的数据长度相同的数据行进行分析。 例如,对于定义为 char(13) 的数据库列的数据,该文件中每行数据必须由 13 个字符来表示。 如果数据库列允许 Null 值,则可以使用 Null 指示符作为固定长度的数据的前缀。

  • 向 SQL Server 复制数据时,数据文件必须包含数据库表中的每列数据。 从 SQL Server 复制数据时,数据库表、视图或 SELECT 结果集中所有列的数据均将复制到数据文件。

  • 向 SQL Server 复制数据时,数据文件中列的序号位置必须与数据库表中列的序号位置相同。 从 SQL Server 复制数据时,BCPExec 方法将根据数据库表中列的序号位置放置数据。

  • 如果数据库数据类型的长度是可变的(如 varbinary(22)),或者如果数据库列可以包含 Null 值,则在数据文件中使用长度/Null 指示符作为数据的前缀。 指示符的宽度因数据类型和大容量复制的版本而异。 IBCPSession::BCPControl 方法选项 BCP_OPTION_FILEFMT 通过指示数据中的指示符宽度何时窄于预期宽度,在早期大容量复制数据文件和运行更高版本 SQL Server 的服务器之间提供兼容性。

备注

若要更改为数据文件指定的数据格式值,请使用 IBCPSession::BCPColumnsIBCPSession::BCPColFmt 方法。

对于不包含索引的表,可通过设置数据库选项 select into/bulkcopy 优化对 SQL Server 的大容量复制 。

参数

pwszTable [in]
要复制进或复制出的数据库表的名称。 该名称可以包含数据库名称或所有者名称。 例如,"pubs.username.titles"、"pubs..titles"、"username.titles"。

如果 eDirection 参数设置为 BCP_DIRECTION_OUT,则 pwszTable 参数可以为数据库视图的名称。

如果在调用 BCPExec 方法前将 eDirection 参数设置为 BCP_DIRECTION_OUT 并使用 BCPControl 方法指定 SELECT 语句,则必须将 pwszTable 参数设置为 NULL 。

pwszDataFile [in]
要复制进或复制出的用户文件的名称。

pwszErrorFile [in]
错误文件的名称,该文件将用进度消息、错误消息以及无法从用户文件复制到表的任何行的副本进行填充。 如果 pwszErrorFile 参数设置为 NULL,则不使用任何错误文件。

eDirection [in]
复制操作的方向,BCP_DIRECTION_IN 或 BCP_DIRECTION _OUT。 BCP_DIRECTION _IN 指示从用户文件向数据库表进行复制;BCP_DIRECTION _OUT 指示从数据库表向用户文件进行复制。

返回代码值

S_OK
方法成功。

E_FAIL
出现访问接口特定的错误,若要获取详细信息,请使用 ISQLServerErrorInfo 接口。

E_OUTOFMEMORY
内存不足错误。

E_INVALIDARG
未正确指定一个或多个参数。 例如,给定的文件名无效。

另请参阅

IBCPSession (OLE DB)
执行大容量复制操作