Exemple de package SMOTablesDBCC

L'exemple de package SMOTablesDBCC illustre comment énumérer les tables utilisateur dans la base de données AdventureWorks en utilisant l'énumérateur SMO Foreach dans un conteneur de boucle Foreach. D'abord, une tâche de script extrait le schéma et les noms de table, puis les place dans deux variables. Ensuite, une tâche d'exécution SQL exécute une commande DBCC CHECKCONSTRAINTS en utilisant les deux variables.

ms160947.note(fr-fr,SQL.90).gifRemarque :
Pour permettre au package de s'exécuter dans un environnement 64 bits, la propriété PreCompile de la tâche de script possède la valeur True. Si vous voulez exécuter le script en pas à pas à l'aide d'outils de débogage, vous devez affecter à cette propriété la valeur False.

Pour plus d'informations, consultez les rubriques « Conteneur de boucles Foreach », « Tâche de script » et « Tâche d'exécution SQL » dans la documentation en ligne de SQL Server 2005.

ms160947.note(fr-fr,SQL.90).gifImportant :
Les exemples sont fournis uniquement à titre éducatif. 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 :

  • Recherchez les fichiers suivants et copiez-les sous %windir%\Microsoft.NET\Framework\v2.0.xxxxx (xxxxx étant la version la plus récente de votre .NET Framework):
    • %ProgramFiles%\Microsoft SQL Server\90\SDK\Assemblies\Microsoft.SqlServer.Smo.dll
    • %ProgramFiles%\Microsoft SQL Server\90\SDK\Assemblies\Microsoft.SqlServer.SmoEnum.dll
    • %ProgramFiles%\Microsoft SQL Server\90\SDK\Assemblies\Microsoft.SqlServer.ConnectionInfo.dll
  • L'exemple de package et les fichiers de données qu'il utilise doivent être installés sur votre disque dur local.
  • Vous devez avoir installé la base de données AdventureWorks et y bénéficier des autorisations administratives.
  • Si vous comptez seulement exécuter l'exemple de package à partir de la ligne de commande, vous devez installer SQL Server 2005 Integration Services (SSIS).
  • Si vous avez l'intention d'ouvrir et d'exécuter le package dans le Concepteur SSIS, 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 depuis 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 par défaut, l'exemple de package SMOTablesDBCC se trouve dans le dossier suivant :

C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Package Samples\SmoTablesDBCC\SmoTablesDBCC\.

Les fichiers suivants sont nécessaires pour exécuter cet exemple de package.

Fichier Description

SmoTablesDBCC.dtsx

Exemple de package.

Exécution de l'exemple

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

Pour exécuter le package à l'aide de 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\SmoTablesDBCC\SmoTablesDBCC\SmoTablesDBCC.dtsx"
    
  4. Appuyez sur Entrée.

Pour plus d'informations sur l'exécution du package à l'aide de l'utilitaire dtexec, consultez la rubrique « 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 SmoTablesDBCC, puis double-cliquez sur le fichier nommé SmoTablesDBCC.sln.

  4. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur SmoTablesDBCC.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, les conteneurs et les gestionnaires de connexions Integration Services qui sont utilisés dans l'exemple.

Élément Fonction

Boucle Foreach

Le conteneur de boucle Foreach, Foreach Loop Container, utilise l'énumérateur SMO Foreach pour parcourir itérativement les tables de la base de données AdventureWorks. Le conteneur de boucle Foreach contient une tâche de script et une tâche d'exécution SQL.

Tâche de script

La tâche de script met à jour les valeurs de variables avec les noms du schéma et de la table à chaque parcours de la boucle.

Tâche d'exécution SQL

La tâche d'exécution SQL, DBCC CHECK CONSTRAINTS, exécute une commande DBCC à chaque parcours de la boucle.

Gestionnaire de connexions OLE DB

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

Résultats de l'exemple

Une fois exécuté, le package affiche des sorties présentant l'aspect suivant.

Exemple de sortie :

Début : 10:41:04

Progression : 2005-03-15 10:41:06.04

Source : DBCC CHECK CONSTRAINTS

Exécution de la requête "DBCC CHECKCONSTRAINTS('[dbo].[AWBuildVersion]') WI".: 100% effectué(s)

Fin de la progression

Progression : 2005-03-15 10:41:06.07

Source : DBCC CHECK CONSTRAINTS

Exécution de la requête "DBCC CHECKCONSTRAINTS('[dbo].[DatabaseLog]') WITH ".: 100% effectué(s)

Fin de la progression

Progression : 2005-03-15 10:38:16.81

Source : DBCC CHECK CONSTRAINTS

Exécution de la requête "DBCC CHECKCONSTRAINTS('[Sales].[Store]') WITH ALL_".: 100% effectué(s)

Fin de la progression

Progression : 2005-03-15 10:38:16.91

Source : DBCC CHECK CONSTRAINTS

Exécution de la requête "DBCC CHECKCONSTRAINTS('[Sales].[StoreContact]') WI".: 100% effectué(s)

Fin de la progression

DTExec : l'exécution du package a retourné DTSER_SUCCESS (0).

Début : 10:37:25

Terminé : 10:38:17

Temps écoulé : 51,687 secondes