Readme_BulkCopyFormatAndData (ODBC)

[This topic is pre-release documentation and is subject to change in future releases. Blank topics are included as placeholders.]

This sample works only with SQL Server 2005 and SQL Server 2008. It will not work with any version of SQL Server earlier than SQL Server 2005.

This sample shows how to use the ODBC bcp_init function with a format file. This sample is not supported on IA64.

SQL Server samples and sample databases must be downloaded and installed before you can view or work with them. For more information, see Considerations for Installing SQL Server Samples and Sample Databases.

Languages

This sample uses Visual C++.

Prerequisites

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

  • SQL Server or SQL Server Express including Database Engine.
    You can download SQL Server Express from the Microsoft Download Center.
  • The AdventureWorks2008R2 database that is available at the Microsoft SQL Server Developer Center.
  • The SQL Server Database Engine samples that are available 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 Documentation.
  • You will also need an ODBC data source called AdventureWorks, whose default database is the AdventureWorks sample database. This data source must be based on the ODBC driver that is supplied by the operating system (the driver name is "SQL Server"). If you will build and run this sample as a 32-bit application on a 64-bit operating system, you must create the ODBC data source with the ODBC Administrator in %windir%\SysWOW64\odbcad32.exe.

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, which you can find in the sample's scripts directory:

    use AdventureWorks
    CREATE TABLE BCPDate (cola int, colb datetime) 
    

    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 BulkCopyFormatAndData.sln file and build it.

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

    MSBuild BulkCopyFormatAndData.sln
    

Running the Sample

  • From Visual Studio, invoke Start Without Debugging (CTRL+F5).
  • If you built with MSBuild.exe, first copy Bcpfmt.fmt and Bcpodbc.bcp from the project directory into the directory with the .exe and then invoke BulkCopyFormatAndData.exe.

See Also

Concepts

Data Access Samples

Help and Information

Getting SQL Server 2008 R2 Assistance