Exemple de package Capture Data Lineage

L'exemple de package Capture Data Lineage est un package qui capture des informations d'audit. Lorsque le package est exécuté, il charge cinq fichiers configurés de manière identique, ajoute des colonnes d'informations historiques (telles que les noms de fichiers) au moyen de la transformation d'audit, puis charge les données dans une table de la base de données AdventureWorks à l'aide d'une destination OLE DB. La table Lineage_Fact_Table est créée par la tâche d'exécution SQL qui la tronque chaque fois que vous exécutez le package.

Si vous exécutez l'exemple sur une version non anglaise de Windows, vous devrez peut-être remplacer le nom de dossier Program Files par sa traduction pour pouvoir ouvrir ou exécuter l'exemple.

Important :
Les exemples sont fournis à titre éducatif uniquement. Ils ne sont pas destinés à être utilisés dans un environnement de production et n'ont pas été testés à cet usage. Microsoft ne fournit aucun support technique pour ces exemples.

Configuration requise

L'exécution de cet exemple de package nécessite les éléments suivants :

• Les exemples de fichiers de données et de packages qu'il utilise doivent être installés sur le lecteur de disque dur local.
• Vous devez disposer d'une connexion et d'autorisations administratives sur la base de données AdventureWorks.
• Si vous envisagez uniquement d'exécuter l'exemple de package à partir de la ligne de commande, vous devez installer SQL Server 2005 Integration Services (SSIS).
• Si vous envisagez d'ouvrir le package dans le Concepteur SSIS et d'exécuter l'exemple de package, vous devez installer Business Intelligence Development Studio.

Pour plus d'informations sur l'installation des exemples, consultez la rubrique « Installation des exemples de packages Integration Services » dans la documentation en ligne de SQL Server 2005. Pour vous procurer la dernière version des exemples, y compris les nouveaux exemples publiés après la version d'origine de SQL Server 2005, consultez Exemples et exemples de base de données SQL Server 2005 (avril 2006).

Emplacement de l'exemple de package

Si les exemples ont été installés à l'emplacement d'installation par défaut, l'exemple de package Capture Data Lineage se trouve dans le dossier suivant :

C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CaptureDataLineage Sample\Capture Data Lineage\

Les fichiers suivants sont nécessaires à l'exécution de ce package.

Exécution de l'exemple

Le package peut être exécuté à partir de la ligne de commande à l'aide de l'utilitaire dtexec ou exécuté dans Business Intelligence Development Studio.

Si vous utilisez une version non anglaise de Windows, vous devrez peut-être mettre à jour la propriété ConnectionString de tous les gestionnaires de connexions de fichiers utilisés dans le package pour pouvoir exécuter comme il se doit l'exemple de package. Pensez à vérifier que le chemin d'accès utilisé dans le gestionnaire de connexions est valide sur votre ordinateur et, si besoin est, modifiez le chemin d'accès pour utiliser le nom traduit du dossier Program Files.

Pour cet exemple, il est possible que vous deviez mettre à jour « Program Files » dans la propriété ConnectionString du gestionnaire de connexions Sample Data.

Pour exécuter le package avec dtexec

1. Ouvrez une fenêtre d'invite de commandes.

2. Accédez au répertoire C:\Program Files\Microsoft SQL Server\90\DTS\Binn, l'emplacement de dtexec.

3. Tapez la commande suivante :

   dtexec /f "C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\CaptureDataLineage Sample\CaptureDataLineage\CaptureDataLineage.dtsx"
   

4. Appuyez sur Entrée.

Pour plus d'informations sur l'exécution du package à l'aide de l'utilitaire dtexec, consultez « Utilitaire dtexec » dans la documentation en ligne de SQL Server 2005.

Pour exécuter le package dans Business Intelligence Development Studio

1. Ouvrez Business Intelligence Development Studio.

2. Dans le menu Fichier, pointez sur Ouvrir, puis cliquez sur Projet/Solution.

3. Recherchez le dossier CaptureDataLineage Sample, puis double-cliquez sur le fichier nommé CaptureDataLineage.sln.

4. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur CaptureDataLineage.dtsx dans le dossier Packages SSIS, puis cliquez sur Exécuter le package.

Composants de l'exemple

Le tableau suivant répertorie les tâches, conteneurs, adaptateurs de données et transformations Integration Services utilisés dans l'exemple.

Élément

Fonction

Tâche d'exécution SQL

La tâche d'exécution SQL, Create Lineage_Fact_Table, exécute une instruction SQL qui crée la table Lineage_Fact_Table lors de la première exécution du package et qui tronque ensuite la table lors de la réexécution du package.

Tâche de flux de données

La tâche de flux de données, Get Data Lineage Information, exécute le flux de données du package.

Source de fichier plat

La source de fichier plat, Extract Data from Files, charge les données sources de fichier plat et ajoute une colonne pour le nom de fichier à chaque ligne de sortie.

Transformation d'audit

La transformation d'audit, Add Data Lineage Information, ajoute deux nouvelles colonnes pour les informations de lignage à chaque ligne de sortie. Les colonnes contiennent le nom d'utilisateur et l'heure de début.

Remarque :

La longueur par défaut de la colonne du nom d'utilisateur est de 64 caractères. Si votre organisation est susceptible d'inclure des noms d'utilisateurs dépassant 64 caractères, vous devez mettre à jour la longueur de colonne par le biais de la boîte de dialogue Éditeur avancé.

Destination OLE DB

La destination OLE DB, Load Data into Lineage_Fact_Table, charge les résultats dans Lineage_Fact_Table dans la base de données AdventureWorks.

Gestionnaire de connexions de fichiers plats multiples

Le gestionnaire de connexions de fichiers plats multiples Sample Data établit une connexion avec les fichiers portant l'extension .txt.

Gestionnaire de connexions OLE DB

Le gestionnaire de connexions OLE DB, (local).AdventureWorks, établit une connexion à la base de données AdventureWorks sur le serveur local.

Résultats de l'exemple

Pour voir les résultats de l'exécution de l'exemple de package Capture Data Lineage, exécutez la requête Transact-SQL suivante :

Select * from AdventureWorks.dbo.Lineage_Fact_Table

Dans ces résultats, vous constaterez la présence de colonnes remplies avec les données récupérées à partir des fichiers plats, accompagnées d'informations de lignage générées dans les colonnes File Name, User Name et Execution Start Time.