Skip to content

Commit d335f6d

Browse files
rwestMSFTrwestMSFT
committed
Refresh SSIS articles (UUF 364730, 363435)
1 parent 4678e15 commit d335f6d

3 files changed

Lines changed: 142 additions & 110 deletions

File tree

‎docs/includes/article-uses-adventureworks.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
---
22
author: rwestMSFT
33
ms.author: randolphwest
4-
ms.date: 06/07/2024
4+
ms.date: 01/23/2025
55
ms.service: sql
66
ms.topic: include
77
---
8-
The [!INCLUDE [tsql-md](tsql-md.md)] code samples in this article use the [!INCLUDE [sssampledbobject-md](sssampledbobject-md.md)] or [!INCLUDE [sssampledbdwobject-md](sssampledbdwobject-md.md)] sample database, which you can download from the [Microsoft SQL Server Samples and Community Projects](https://go.microsoft.com/fwlink/?LinkID=85384) home page.
8+
The code samples in this article use the [!INCLUDE [sssampledbobject-md](sssampledbobject-md.md)] or [!INCLUDE [sssampledbdwobject-md](sssampledbdwobject-md.md)] sample database, which you can download from the [Microsoft SQL Server Samples and Community Projects](https://go.microsoft.com/fwlink/?LinkID=85384) home page.

‎docs/integration-services/lesson-1-create-a-project-and-basic-package-with-ssis.md‎

Lines changed: 45 additions & 52 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: "Lesson 1: Create a project and basic package with SSIS"
2+
title: "Lesson 1: Create a Project and Basic Package with SSIS"
33
description: "Lesson 1: Create a project and basic package with SSIS"
44
author: chugugrace
55
ms.author: chugu
6-
ms.reviewer: mikeray
7-
ms.date: 09/17/2024
6+
ms.reviewer: mikeray, randolphwest
7+
ms.date: 01/23/2025
88
ms.service: sql
99
ms.subservice: integration-services
1010
ms.topic: tutorial
@@ -14,35 +14,33 @@ ms.topic: tutorial
1414

1515
[!INCLUDE [sqlserver-ssis](../includes/applies-to-version/sqlserver-ssis.md)]
1616

17-
In this lesson, you create a simple extract, transform, and load (ETL) package. The package extracts data from a single flat file source, transforms the data using two lookup transformations, and writes the transformed data to a copy of the **FactCurrencyRate** fact table in the [!INCLUDE [sssampledbdwobject-md](../includes/sssampledbdwobject-md.md)] sample database. As part of this lesson, you learn how to create new packages, add and configure data source and destination connections, and work with new control flow and data flow components.
17+
In this lesson, you create a simple extract, transform, and load (ETL) package. The package extracts data from a single flat file source, transforms the data using two lookup transformations, and writes the transformed data to a copy of the `FactCurrencyRate` fact table in the [!INCLUDE [sssampledbdwobject-md](../includes/sssampledbdwobject-md.md)] sample database. As part of this lesson, you create new packages, add and configure data source and destination connections, and work with new control flow and data flow components.
1818

19-
Before creating a package, you need to understand the formatting used in both the source data and the destination. Then, you are ready to define the transformations necessary to map the source data to the destination.
19+
Before creating a package, you need to understand the formatting used in both the source data and the destination. Then, you're ready to define the transformations necessary to map the source data to the destination.
2020

2121
## Prerequisites
2222

2323
This tutorial relies on Microsoft SQL Server Data Tools, a set of example packages, and a sample database.
2424

25-
- To install the SQL Server Data Tools, see [Download SQL Server Data Tools](../ssdt/download-sql-server-data-tools-ssdt.md).
25+
> [!NOTE]
26+
> [!INCLUDE [article-uses-adventureworks](../includes/article-uses-adventureworks.md)]
2627
27-
- To download all of the lesson packages for this tutorial:
28+
To install the SQL Server Data Tools, see [Install SQL Server Data Tools (SSDT) for Visual Studio](../ssdt/download-sql-server-data-tools-ssdt.md).
2829

29-
1. Navigate to [Integration Services tutorial files](https://www.microsoft.com/download/details.aspx?id=56827).
30+
To download all of the lesson packages for this tutorial:
3031

31-
1. Select the **DOWNLOAD** button.
32-
33-
1. Select the **Creating a Simple ETL Package.zip** file, then select **Next**.
34-
35-
1. After the file downloads, unzip its contents to a local directory.
36-
37-
- To install and deploy the [!INCLUDE [sssampledbdwobject-md](../includes/sssampledbdwobject-md.md)] sample database, see [Install and configure AdventureWorks sample database - SQL](../samples/adventureworks-install-configure.md).
32+
1. Navigate to [Integration Services tutorial files](https://www.microsoft.com/download/details.aspx?id=56827).
33+
1. Select the **Download** button.
34+
1. Select the `Creating a Simple ETL Package.zip` file, then select **Next**.
35+
1. After the file downloads, unzip its contents to a local directory.
3836

3937
## Look at the source data
4038

41-
For this tutorial, the source data is a set of historical currency data in a flat file named **SampleCurrencyData.txt**. The source data has the following four columns: the average rate of the currency, a currency key, a date key, and the end-of-day rate.
39+
For this tutorial, the source data is a set of historical currency data in a flat file named `SampleCurrencyData.txt`. The source data has the following four columns: the average rate of the currency, a currency key, a date key, and the end-of-day rate.
4240

43-
Here is an example of the source data in the SampleCurrencyData.txt file:
41+
Here's an example of the source data in the `SampleCurrencyData.txt` file:
4442

45-
```sql
43+
```output
4644
1.00070049USD9/3/05 0:001.001201442
4745
1.00020004USD9/4/05 0:001
4846
1.00020004USD9/5/05 0:001.001201442
@@ -55,52 +53,47 @@ Here is an example of the source data in the SampleCurrencyData.txt file:
5553
1.00020004USD9/12/05 0:000.99970009
5654
```
5755

58-
When working with flat file source data, it's important to understand how the Flat File connection manager interprets the flat file data. If the flat file source is Unicode, the Flat File connection manager defines all columns as [DT_WSTR] with a default column width of 50. If the flat file source is ANSI-encoded, the columns are defined as [DT_STR] with a default column width of 50. You probably have to change these defaults to make the string column types more applicable for your data. You need to look at the data type of the destination, and then choose that type within the Flat File connection manager.
56+
When working with flat file source data, it's important to understand how the Flat File connection manager interprets the flat file data. If the flat file source is Unicode, the Flat File connection manager defines all columns as `[DT_WSTR]` with a default column width of `50`. If the flat file source is ANSI-encoded, the columns are defined as `[DT_STR]` with a default column width of `50`. You probably have to change these defaults to make the string column types more applicable for your data. You need to look at the data type of the destination, and then choose that type within the Flat File connection manager.
5957

6058
## Look at the destination data
6159

62-
The destination for the source data is a copy of the **FactCurrencyRate** fact table in [!INCLUDE [sssampledbdwobject-md](../includes/sssampledbdwobject-md.md)]. The **FactCurrencyRate** fact table has four columns, and has relationships to two dimension tables, as shown in the following table.
60+
The destination for the source data is a copy of the `FactCurrencyRate` fact table in [!INCLUDE [sssampledbdwobject-md](../includes/sssampledbdwobject-md.md)]. The `FactCurrencyRate` fact table has four columns, and has relationships to two dimension tables, as shown in the following table.
6361

64-
| Column Name | Data Type | Lookup Table | Lookup Column |
62+
| Column name | Data type | Lookup table | Lookup column |
6563
| --- | --- | --- | --- |
66-
| `AverageRate` | `float` | None | None |
67-
| `CurrencyKey` | `int` (`FK`) | `DimCurrency` | `CurrencyKey` (`PK`) |
68-
| `DateKey` | `int` (`FK`) | `DimDate` | `DateKey` (`PK`) |
69-
| `EndOfDayRate` | `float` | None | None |
64+
| `AverageRate` | **float** | None | None |
65+
| `CurrencyKey` | **int** (FK) <sup>1</sup> | `DimCurrency` | `CurrencyKey` (PK) <sup>2</sup> |
66+
| `DateKey` | **int** (FK) <sup>1</sup> | `DimDate` | `DateKey` (PK) <sup>2</sup> |
67+
| `EndOfDayRate` | **float** | None | None |
68+
69+
<sup>1</sup> FK: Foreign key
70+
71+
<sup>2</sup> PK: Primary key
7072

7173
## Map the source data to the destination
7274

73-
Our analysis of the source and destination data formats indicates that lookups are necessary for the **CurrencyKey** and **DateKey** values. The transformations that perform these lookups get those values by using the alternate keys from the **DimCurrency** and **DimDate** dimension tables.
75+
Our analysis of the source and destination data formats indicates that lookups are necessary for the `CurrencyKey` and `DateKey` values. The transformations that perform these lookups get those values by using the alternate keys from the `DimCurrency` and `DimDate` dimension tables.
7476

75-
| flat file Column | Table Name | Column Name | Data Type |
77+
| Flat file column | Table name | Column name | Data type |
7678
| --- | --- | --- | --- |
77-
| 0 | `FactCurrencyRate` | `AverageRate` | `float` |
78-
| 1 | `DimCurrency` | `CurrencyAlternateKey` | `nchar(3)` |
79-
| 2 | `DimDate` | `FullDateAlternateKey` | `date` |
80-
| 3 | `FactCurrencyRate` | `EndOfDayRate` | `float` |
79+
| `0` | `FactCurrencyRate` | `AverageRate` | **float** |
80+
| `1` | `DimCurrency` | `CurrencyAlternateKey` | **nchar(3)** |
81+
| `2` | `DimDate` | `FullDateAlternateKey` | **date** |
82+
| `3` | `FactCurrencyRate` | `EndOfDayRate` | **float** |
8183

8284
## Lesson tasks
8385

84-
This lesson contains the following tasks:
85-
86-
- [Step 1: Create a new Integration Services project](../integration-services/lesson-1-1-creating-a-new-integration-services-project.md)
87-
88-
- [Step 2: Add and configure a Flat File connection manager](../integration-services/lesson-1-2-adding-and-configuring-a-flat-file-connection-manager.md)
89-
90-
- [Step 3: Add and configure an OLE DB connection manager](../integration-services/lesson-1-3-adding-and-configuring-an-ole-db-connection-manager.md)
91-
92-
- [Step 4: Add a Data Flow task to the package](../integration-services/lesson-1-4-adding-a-data-flow-task-to-the-package.md)
93-
94-
- [Step 5: Add and configure the flat file source](../integration-services/lesson-1-5-adding-and-configuring-the-flat-file-source.md)
95-
96-
- [Step 6: Add and configure the lookup transformations](../integration-services/lesson-1-6-adding-and-configuring-the-lookup-transformations.md)
97-
98-
- [Step 7: Add and configure the OLE DB destination](../integration-services/lesson-1-7-adding-and-configuring-the-ole-db-destination.md)
99-
100-
- [Step 8: Annotate and format the Lesson 1 package](../integration-services/lesson-1-8-making-the-lesson-1-package-easier-to-understand.md)
101-
102-
- [Step 9: Test the Lesson 1 package](../integration-services/lesson-1-9-testing-the-lesson-1-tutorial-package.md)
86+
- [Lesson 1-1: Create a new Integration Services project](lesson-1-1-creating-a-new-integration-services-project.md)
87+
- [Lesson 1-2: Add and configure a Flat File connection manager](lesson-1-2-adding-and-configuring-a-flat-file-connection-manager.md)
88+
- [Lesson 1-3: Add and configure an OLE DB connection manager](lesson-1-3-adding-and-configuring-an-ole-db-connection-manager.md)
89+
- [Lesson 1-4: Add a Data Flow task to the package](lesson-1-4-adding-a-data-flow-task-to-the-package.md)
90+
- [Lesson 1-5: Add and configure the Flat File source](lesson-1-5-adding-and-configuring-the-flat-file-source.md)
91+
- [Lesson 1-6: Add and configure the Lookup transformations](lesson-1-6-adding-and-configuring-the-lookup-transformations.md)
92+
- [Lesson 1-7: Add and configure the OLE DB destination](lesson-1-7-adding-and-configuring-the-ole-db-destination.md)
93+
- [Lesson 1-8: Annotate and format the Lesson 1 package](lesson-1-8-making-the-lesson-1-package-easier-to-understand.md)
94+
- [Lesson 1-9: Test the Lesson 1 package](lesson-1-9-testing-the-lesson-1-tutorial-package.md)
10395

104-
## Start the lesson
96+
## Next step
10597

106-
[Step 1: Create a new integration services project](../integration-services/lesson-1-1-creating-a-new-integration-services-project.md)
98+
> [!div class="nextstepaction"]
99+
> [Step 1: Create a new integration services project](../integration-services/lesson-1-1-creating-a-new-integration-services-project.md)

0 commit comments

Comments
 (0)