README How to bulk copy data from program variables (ODBC)

This sample shows how to do a bulk copy from program variables bound with bcp_bind; data sent with bcp_sendrow. This sample is not supported on IA64.

Scenario

For more information on this sample, see How to: Bulk Copy Data from Program Variables (ODBC) in Books Online.

Languages

This sample uses Visual C++.

Prerequisites

Before running this sample, make sure the following software is installed:

• SQL Server 2005 or SQL Server 2005 Express Edition (SQL Server Express) including the Database Engine.
  You can download SQL Server Express from the Microsoft Download Center.
• The AdventureWorks database which is included with SQL Server 2005, and is also available at the Microsoft SQL Server Developer Center.
• The SQL Server 2005 Database Engine samples. These samples are included with SQL Server 2005. You can download the latest version of the samples at the Microsoft SQL Server Developer Center.
• .NET Framework SDK 2.0 or Microsoft Visual Studio 2005. You can obtain .NET Framework SDK free of charge. See Installing the .NET Framework SDK.
• You will also need an ODBC data source called AdventureWorks, whose default database is the AdventureWorks sample database.

Building the Sample

• This sample connects to your computer's default SQL Server instance. To connect to a named instance, change the definition of the ODBC data source to specify the instance using the following format: server\named_instance. By default, SQL Server Express installs to a named instance.

• The sample requires you to execute the following Transact-SQL statements before each program invocation; the Transact-SQL statements can be found in the sample's scripts directory:

  use AdventureWorks
  IF EXISTS (SELECT name FROM sysobjects WHERE name = 'BCPSource')
       DROP TABLE BCPSource
  IF EXISTS (SELECT name FROM sysobjects WHERE name = 'BCPTarget')
       DROP TABLE BCPTarget
  GO
  
  CREATE TABLE BCPSource (cola int PRIMARY KEY, colb CHAR(10) NULL)
  INSERT INTO BCPSource (cola, colb) VALUES (1, 'aaa')
  INSERT INTO BCPSource (cola, colb) VALUES (2, 'bbb')
  CREATE TABLE BCPTarget (cola int PRIMARY KEY, colb CHAR(10) NULL)
  

  In SQL Server Management Studio, load and execute the Scripts\setup.sql script or execute the following command in a Command Prompt window:

  sqlcmd -E -I -I Scripts\setup.sql
  

• If you are using Visual Studio, load the BulkCopyFromVariables.sln file and build it.

• If you are using MSBuild.exe, invoke MSBuild.exe at a command prompt, passing it the BulkCopyFromVariables.sln file:

  MSBuild BulkCopyFromVariables.sln
  

Running the Sample

• From Visual Studio, invoke Start Without Debugging (CTRL+F5).
• If you built with MSBuild.exe, invoke BulkCopyFromVariables.exe.

Change History

See Also

Concepts

Data Access Samples

Help and Information

Getting SQL Server 2005 Assistance