Readme_Creating a Basic Package Tutorial: Lesson Packages

11/05/2008 21:36:06

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 2005.
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

Open a Command Prompt window.

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

To run a package in Business Intelligence Development Studio

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.

Click the package to add, and then click Open.

Click OK.

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

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