Outils de dépannage pour le développement des packages

Article
05/23/2023

S’applique à :SQL Server SSIS Integration Runtime dans Azure Data Factory

Integration Services comprend des fonctionnalités et des outils que vous pouvez utiliser pour dépanner les packages quand vous les développez dans SQL Server Data Tools (SSDT).

Dépannage des problèmes de validation au moment de la conception

Dans la version actuelle de Integration Services, quand un package est ouvert, le système valide toutes les connexions avant de valider tous les composants de flux de données, et définit toutes les connexions qui sont lentes ou non disponibles pour travailler hors connexion. Cela permet de réduire le délai de validation du flux de données du package.

Quand un package est ouvert, vous pouvez également désactiver une connexion en cliquant avec le bouton droit sur le gestionnaire de connexions dans la zone Gestionnaires de connexions et en cliquant sur Travailler hors connexion. Cela peut accélérer les opérations exécutées dans le concepteur SSIS.

Les connexions définies pour travailler hors connexion, restent hors connexion jusqu'à ce que vous effectuiez une des actions suivantes :

Vous tester la connexion en cliquant avec le bouton droit sur le gestionnaire de connexions dans la zone Gestionnaires de connexions du concepteur SSIS et vous cliquez sur Tester la connectivité.

Par exemple, une connexion est initialement définie pour travailler hors connexion lorsque le package est ouvert. Vous modifiez la chaîne de connexion pour résoudre le problème et cliquez sur Tester la connectivité pour tester la connexion.
Rouvrir le package ou rouvrir le projet qui contient le package. La validation est réexécutée sur toutes les connexions dans le package.

Integration Services inclut les fonctionnalités supplémentaires suivantes pour vous aider à éviter des erreurs de validation :

Définir tous les packages et toutes les connexions pour travailler hors connexion quand les sources de données ne sont pas disponibles. Vous pouvez activer Travailler hors connexion à partir du menu SSIS . Contrairement à la propriété DelayValidation , l’option Travailler hors connexion est disponible avant même que vous n’ouvriez un package. Vous pouvez également activer l’option Travailler hors connexion pour accélérer les opérations exécutées dans le concepteur, puis la désactiver dès que vous souhaitez valider votre package.
Configurer la propriété DelayValidation dans les éléments de package qui ne sont pas valides avant l’exécution. Pour éviter toute erreur de validation, vous pouvez affecter la valeur True à la propriété DelayValidation dans les éléments de package dont la configuration n’est pas valide au moment de la conception. Par exemple, vous pouvez disposer d'une tâche Flux de données qui utilise une table de destination qui n'existe pas jusqu'à ce qu'une tâche d'exécution SQL crée la table au moment de l'exécution. La propriété DelayValidation peut être activée au niveau du package ou au niveau des tâches individuelles et des conteneurs inclus dans le package. En règle générale, pour éviter les mêmes erreurs de validation au moment de l’exécution, vous devez laisser cette propriété avec la valeur True dans les mêmes éléments de package lors du déploiement du package.

La propriété DelayValidation peut être définie sur une tâche Flux de données mais pas sur des composants de flux de données individuels. Vous pouvez obtenir un résultat similaire en affectant la valeur ValidateExternalMetadata à la propriété ValidateExternalMetadata. Néanmoins, si cette propriété affiche la valeur false, le composant n'a pas connaissance des modifications apportées aux métadonnées des sources de données externes.

Si les objets de base de données utilisés par le package sont verrouillés lorsque la validation se produit, le processus de validation peut cesser de répondre. Dans ces circonstances, le concepteur SSIS cesse également de répondre. Vous pouvez reprendre la validation à l’aide de Management Studio pour fermer la session associée dans SQL Server. Vous pouvez aussi éviter ce problème en utilisant les paramètres décrits dans cette section.

Dépannage du flux de contrôle

Integration Services comprend les fonctionnalités et outils suivants que vous pouvez utiliser pour dépanner le flux de contrôle dans les packages lors de leur développement :

Définir des points d’arrêt dans des tâches, des conteneurs et le package. Vous pouvez définir des points d’arrêt à l’aide d’outils graphiques fournis par le concepteur SSIS . Les points d'arrêt peuvent être activés au niveau du package ou au niveau des tâches individuelles et des conteneurs inclus dans le package. Certaines tâches et certains conteneurs présentent des conditions d'arrêt supplémentaires pour la définition des points d'arrêt. Par exemple, vous pouvez activer une condition d'arrêt sur le conteneur de boucles For qui suspend l'exécution au début de chaque itération de la boucle.
Utiliser les fenêtres de débogage. Lorsque vous exécutez un package doté de points d'arrêt, les fenêtres de débogage dans SQL Server Data Tools (SSDT) fournissent un accès aux valeurs des variables et aux messages d'état.
Vérifier les informations sous l’onglet Progression. SSIS Le concepteur fournit des informations supplémentaires sur le flux de contrôle quand vous exécutez un package dans SQL Server Data Tools (SSDT). L'onglet Progression énumère les tâches et les conteneurs par ordre d'exécution et indique les heures de début et de fin, les avertissements et les messages d'erreur pour chaque tâche et chaque conteneur, y compris le package lui-même.

Pour plus d’informations sur ces fonctionnalités, consultez Débogage du flux de contrôle.

Dépannage du flux de données

Integration Services comprend les fonctionnalités et outils suivants que vous pouvez utiliser pour dépanner les flux de données dans les packages lors du développement de ces derniers :

Effectuer des tests uniquement avec un sous-ensemble de vos données. Si vous voulez dépanner le flux de données dans un package en utilisant seulement un échantillon du dataset, vous pouvez inclure une transformation d'échantillonnage du pourcentage ou de ligne pour créer un exemple de données en ligne à l'exécution. Pour plus d’informations, consultez Transformation de l’échantillonnage du pourcentage et Transformation d’échantillonnage de lignes.
Utiliser les visionneuses de données pour analyser les données quand elles circulent dans le flux de données. Les visionneuses de données affichent des valeurs des données lors de leur déplacement entre des sources, des transformations et des destinations. Une visionneuse de données peut afficher des données dans une grille. Vous pouvez copier les données d'une visionneuse de données vers le Presse-papiers, puis coller les données dans un fichier ou une feuille de calcul Excel. Pour plus d’informations, consultez Débogage d’un flux de données .
Configurer les sorties d’erreur dans les composants de flux de données qui les prennent en charge. De nombreuses sources, transformations et destinations de flux de données prennent également en charge les sorties d'erreur. En configurant la sortie d'erreur d'un composant de flux de données, vous pouvez diriger les données contenant des erreurs vers une autre destination. Par exemple, vous pouvez capturer les données qui ont échoué ou qui ont été tronquées dans un fichier texte séparé. Vous pouvez aussi associer des visionneuses de données aux sorties d'erreur et examiner uniquement les données erronées. Au moment de la conception, les sorties d'erreur capturent des valeurs de données problématiques pour vous aider à développer des packages qui prennent effectivement en charge les données réelles. Néanmoins, tandis que les autres outils et fonctionnalités de dépannage ne sont utiles qu'au moment de la conception, les sorties d'erreur le restent également dans l'environnement de production. Pour plus d’informations, consultez Gestion des erreurs dans les données.
Capturer le nombre de lignes traitées. Quand vous exécutez un package dans le concepteur SSIS , le nombre de lignes transmises par le biais d’un chemin est affiché dans le concepteur de flux de données. Ce nombre est mis à jour régulièrement lorsque des données empruntent le chemin d'accès. Vous pouvez également ajouter une transformation de nombre de lignes au flux de données pour capturer le nombre de lignes final dans une variable. Pour plus d’informations, voir Row Count Transformation.
Vérifier les informations sous l’onglet Progression. SSIS Le concepteur fournit des informations supplémentaires sur les flux de données quand vous exécutez un package dans SQL Server Data Tools (SSDT). L'onglet Progression répertorie les composants de flux de données par ordre d'exécution et comprend des informations sur la progression de chaque phase du package (sous forme de pourcentage) et le nombre de lignes écrites sur la destination.

Pour plus d’informations sur ces fonctionnalités, consultez Débogage d’un flux de données.

Dépannage des scripts

Microsoft Visual Studio Tools for Applications (VSTA) est l’environnement de développement dans lequel vous écrivez les scripts utilisés par la tâche de script et le composant Script. VSTA fournit les fonctionnalités et outils suivants que vous pouvez utiliser pour résoudre les problèmes liés aux scripts lors du développement des packages :

Définissez des points d'arrêt dans des scripts pour des tâches de script. VSTA prend en charge le débogage de scripts pour les tâches de script uniquement. Les points d'arrêt que vous définissez dans les tâches de script sont intégrés à ceux que vous définissez pour les packages, et les tâches et conteneurs du package, ce qui permet un débogage transparent de tous les éléments de package.

Notes

Lorsque vous déboguez un package qui contient plusieurs tâches de script, le débogueur accède aux points d'arrêt d'une seule tâche de script et ignore les points d'arrêt des autres tâches de script. Si une tâche de script fait partie d'un conteneur de boucle Foreach ou For, le débogueur ignore les points d'arrêt de la tâche de script après la première itération de la boucle.

Pour plus d’informations, consultez Script de débogage. Pour obtenir des suggestions sur la façon de déboguer le composant Script, consultez Codage et débogage du composant Script.

Dépannage des erreurs sans description

Si vous rencontrez un numéro d’erreur Integration Services accompagné d’aucune description lors du développement du package, vous pouvez rechercher la description dans le Guide de référence des erreurs et des messages propres à Integration Services. La liste ne comporte actuellement aucune information de dépannage.

Voir aussi

Outils de dépannage pour l’exécution des packages
Fonctionnalités de performances de flux de données