Share via

IBCPSession：：BCPInit (Native Client OLE DB 访问接口)

  • 项目

适用于：SQL ServerAzure SQL 数据库Azure SQL 托管实例Azure Synapse AnalyticsAnalytics Platform System (PDW)

重要

已从 SQL Server 2022 (16.x) 和 SQL Server Management Studio 19 (SSMS) 中移除 SQL Server Native Client（通常缩写为 SNAC）。 不建议在新的开发工作中使用 SQL Server Native Client OLE DB 提供程序（SQLNCLI 或 SQLNCLI11）和旧版 Microsoft OLE DB Provider for SQL Server (SQLOLEDB)。 此后请切换到新的 Microsoft OLE DB Driver (MSOLEDBSQL) for SQL Server。

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

语法

  
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 结果集中的列的数据类型。 数据类型由 sqlncli.h) (SQL Server Native Client 头文件中指定的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::BCPColumns 和 IBCPSession::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)
执行大容量复制操作