Share via

Readme_Creating a Basic Package Tutorial: Lesson Packages

  • Article

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 works with the SQL Server 2005 version of the AdventureWorks OLTP database. To install this database, see Sample Databases for Microsoft SQL Server 2008.

The Basic Lesson 1 and Basic Lesson 2 packages are the completed packages from the Integration Services tutorial, Creating a Basic Package Using a Wizard. The topics in Books Online provide detailed information about the functionality of each package. For more information, see the topics in "Creating a Basic Package Using a Wizard" located in the Integration Services Tutorials section of Books Online.

You can open and run these packages outside the tutorial. However, we do not recommend that you modify them. Modification of tutorial packages may give you results that differ from the results of packages that were defined in the tutorial lessons.

Important

The first time that you run the Basic Lesson 1 or Basic Lesson 2 package, the task named Drop table(s) SQL Task will fail. This behavior is expected. The reason the task fails is that the package tries to drop and re-create the ProspectiveCustomers table; however, the first time that the package runs, the table does not exist and therefore the DROP statement fails. This does not cause the package to fail because the precedence constraint between the Drop table(s) SQL Task and Preparation SQL tasks has been set to Completion instead of Success.

The following table provides a brief summary of each package.

Package Description

Basic Lesson 1

A simple data transfer package that uses a SELECT statement to extract data from an Excel workbook file and load the data into a table in the AdventureWorks database. If the table does not already exist, the package creates it. This package was built by using the SQL Server Import and Export Wizard.

Basic Lesson 2

The Basic Lesson 1 package enhanced with more complex data flow. The data flow now includes a Sort transformation to sort the data by state and city, and a Derived Column transformation to add a new column whose value is set by the evaluation result of an expression.

Important

Samples are provided for educational purposes only. They are not intended to be used in a production environment and have not been tested in a production environment. Microsoft does not provide technical support for these samples.

Requirements

Running this sample package requires the following:

  • The sample packages and data files that it uses must be installed on the local hard disk drive.
  • You must have installed and have administrative permissions on the AdventureWorks OLTP database.
  • If you intend only to run the sample package from the command line, you must install Integration Services.
  • If you intend to open the package in SSIS Designer and run the sample package, you must also install Business Intelligence Development Studio.

For more information about how to install samples, see "Installing Sample Integration Services Packages" in SQL Server Books Online.

Location of the Sample Packages

If the samples were installed to the default installation location, the tutorial sample packages are located in the following folder:

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Tutorial\Creating a Basic Package\Completed Packages

Running the Sample

The packages can be run from the command line by using the dtexec utility, or can be run in Business Intelligence Development Studio.

Important

This sample uses the Microsoft Jet 4.0 OLE DB provider, for which there is no 64-bit version. The package fails on a 64-bit computer.

If you are using a non-English version of Windows, you may have to update the ConnectionString property of any file connection managers used in the package to run the sample package successfully. You should verify that the path used in the connection manager is valid on your computer, and if you need to, modify the path so that it uses the localized name of the Program Files folder.

For this sample, you may have to update "Program Files" in the ExcelFilePath and ServerName properties of the SourceConnectionExcel connection manager.

To run the package by using dtexec

  1. Open a Command Prompt window.

  2. Change the directory to C:\Program Files\Microsoft SQL Server\100\DTS\Binn, the location of dtexec.

  3. Type the following command:

    dtexec /f "C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Tutorial\Creating a Basic Package\Completed Packages\<package name>"

  4. Press Enter.

For more information about how to run the package by using the dtexec utility, see the topic, "dtexec Utility", in SQL Server Books Online.

Running the Sample in Business Intelligence Development Studio

If you do not already have an Integration Services project to which you can add the tutorial packages, you must first create a project.

To create a new Integration Services project

  1. Open Business Intelligence Development Studio.

  2. On the File menu, point to New, and then click Project.

  3. In the New Project dialog box, select the Integration Services Project template from the Templates pane.

  4. Optionally, edit the project name and the location. The solution name is automatically updated to match the project name.

  5. In the Solution drop-down list, select Create new Solution.

  6. To create a separate folder for the solution file, select Create directory for solution. This is the default option.

  7. Click OK to add the solution to Solution Explorer and add the project to the solution.

Next, you add the packages to the Integration Services project.

To run a package in Business Intelligence Development Studio

  1. In Solution Explorer, right-click SSIS Packages and then click Add Existing Package.

  2. In the Add Copy of Existing Package dialog box, set Package location to File system, click browse (…), and locate the folder that contains the completed packages from the tutorial. The default location is C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\Tutorial\Creating a Basic Package\Completed Packages.

  3. Click the package to add, and then click Open.

  4. Click OK.

  5. Repeat steps 1-4 to add the second tutorial package to the project.

  6. Right-click the package to run in the SSIS Packages folder, and then click Execute Package.

See Also

Other Resources

Tutorial: Creating a Basic Package Using a Wizard

Help and Information

Getting SQL Server 2008 Assistance