Redémarrer des packages à l'aide de points de contrôle

Article
05/23/2023

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

Integration Services peut redémarrer les packages ayant échoué à partir du point d’échec, au lieu de reprendre l’exécution du package tout entier. Si un package est configuré pour utiliser des points de contrôle, des informations sur l'exécution du package sont écrites dans un fichier de point de contrôle. Lorsque le package ayant échoué est relancé, le fichier de point de contrôle est utilisé pour redémarrer le package à partir du point d'échec. Si le package est exécuté avec succès, le fichier de point de contrôle est supprimé, puis recréé à l’exécution suivante du package.

L'utilisation des points de contrôle dans un package offre les avantages suivants :

Éviter de répéter le téléchargement ascendant et descendant de gros fichiers. Par exemple, un package qui télécharge plusieurs gros fichiers à l'aide d'une tâche FTP pour chaque téléchargement peut être redémarré après l'échec du téléchargement d'un seul fichier, puis ne reprendre le téléchargement que pour ce fichier.
Éviter de répéter le téléchargement de grands volumes de données. Par exemple, un package qui effectue des insertions en bloc dans des tables de dimension d'un entrepôt de données à l'aide d'une tâche d'insertion en bloc différente pour chaque dimension, peut être redémarré si l'insertion échoue pour une table de dimension, et ne recharger que cette dimension.
Éviter de répéter l'agrégation de valeurs. Par exemple, un package qui calcule de nombreux agrégats, tels que des moyennes et des sommes, à l'aide d'une tâche de flux de données distincte pour la réalisation de chaque agrégation, peut être redémarré en cas d'échec du calcul d'une agrégation pour ne recalculer que cette agrégation.

Si un package est configuré pour utiliser les points de contrôle, Integration Services capture le point de redémarrage dans le fichier de point de contrôle. Le type de conteneur qui échoue et l'implémentation de fonctionnalités telles que les transactions affectent le point de redémarrage enregistré dans le fichier de point de contrôle. Les valeurs actuelles des variables sont également capturées dans le fichier de point de contrôle. Toutefois, les valeurs des variables de type de données Object ne sont pas enregistrées dans les fichiers de point de contrôle.

Définition des points de redémarrage

Le conteneur d'hôte de tâche, qui encapsule une seule tâche, est la plus petite unité atomique à pouvoir être redémarrée. Le conteneur de boucles Foreach et un conteneur transactionnel sont également traités comme des unités atomiques de travail.

Si un package est arrêté alors qu'un conteneur transactionnel est en cours d'exécution, la transaction est arrêtée et tout travail effectué par le conteneur est annulé. Lorsque le package est redémarré, le conteneur qui a échoué est exécuté à nouveau. La réalisation de conteneurs enfants du conteneur transactionnel n'est pas enregistrée dans le fichier de point de contrôle. Par conséquent, lorsque le package est redémarré, le conteneur transactionnel et ses conteneurs enfants sont exécutés à nouveau.

Notes

L'utilisation de points de contrôle et de transactions dans le même package peut entraîner des résultats inattendus. Par exemple, lorsqu'un package échoue et redémarre à partir d'un point de contrôle, il peut répéter une transaction qui a déjà été correctement validée.

Les données de point de contrôle ne sont pas enregistrées pour les conteneurs de boucles For et Foreach. Lorsqu'un package est redémarré, les conteneurs de boucles For et Foreach et les conteneurs enfants sont exécutés à nouveau. Si un conteneur enfant de la boucle est exécuté correctement, il n'est pas enregistré dans le fichier de point de contrôle et il est exécuté à nouveau. Pour plus d'informations et pour obtenir une solution de contournement, consultez Les points de contrôle SSIS ne sont pas respectés pour les éléments de conteneur de boucles For ou Foreach.

Si le package est redémarré, les configurations du package ne sont pas rechargées, mais le package utilise les informations de configuration écrites dans le fichier de point de contrôle. Cette procédure assure que le package utilise les mêmes configurations lorsqu'il est exécuté à nouveau qu'au moment où il a échoué.

Un package ne peut être redémarré qu'au niveau du flux de contrôle. Vous ne pouvez pas redémarrer un package au milieu d'un flux de données. Pour éviter de réexécuter tout le flux de données, le package peut être conçu de manière à inclure plusieurs flux de données, utilisant chacun une tâche de flux de données différente. De cette manière, le package peut être redémarré en ne réexécutant qu'une seule tâche de flux de données.

Configuration d'un package pour le redémarrage

Le fichier de point de contrôle comprend les résultats d'exécution de tous les conteneurs achevés, les valeurs actuelles des variables système et définies par l'utilisateur, ainsi que les informations de configuration du package. Le fichier peut également inclure un identificateur unique du package. Pour redémarrer correctement le package, l'identificateur du package dans le fichier de point de contrôle doit correspondre au package. Dans le cas contraire, le redémarrage échoue. Cela empêche un package d'utiliser un fichier de point de contrôle écrit par une version de package différente. Si un package redémarre après avoir été exécuté correctement, le fichier de point de contrôle est supprimé.

Le tableau suivant présente les propriétés de package que vous définissez pour implémenter les points de contrôle.

Propriété	Description
CheckpointFileName	Indique le nom du fichier de point de contrôle.
CheckpointUsage	Indique si les points de contrôle sont utilisés.
SaveCheckpoints	Indique si le package enregistre les points de contrôle. Cette propriété doit avoir pour valeur True pour redémarrer le package à partir d'un point d'échec.

Vous pouvez également affecter la valeur true à la propriété FailPackageOnFailure pour tous les conteneurs du package que vous voulez identifier comme points de redémarrage.

Vous pouvez utiliser la propriété ForceExecutionResult pour tester l’utilisation des points de contrôle dans un package. En affectant la valeur la valeur Failure à la propriété ForceExecutionResult d’une tâche ou d’un conteneur, vous pouvez imiter un échec en temps réel. Lorsque vous redémarrez le package, la tâche et les conteneurs ayant échoué sont réexécutés.

Utilisation des points de contrôle

La propriété CheckpointUsage peut avoir les valeurs suivantes :

Valeur	Description
Jamais	Spécifie que le fichier de point de contrôle n'est pas utilisé et que le package est exécuté à partir du début du flux de travail du package.
Toujours	Spécifie que le fichier de point de contrôle est toujours utilisé et que le package redémarre à partir du point de l'échec de la précédente exécution. Si le fichier de point de contrôle est introuvable, le package échoue.
IfExists	Spécifie que le fichier de point de contrôle est utilisé s'il existe. Si le fichier de point de contrôle existe, le package redémarre à partir du point de l'échec de la précédente exécution. Sinon il est exécuté à partir du début du flux de travail du package.

Notes

L’option /CheckPointing on de dtexec revient à affecter la valeur True à la propriété SaveCheckpointsdu package et la valeur Always à la propriété CheckpointUsage . Pour plus d'informations, consultez Utilitaire dtexec.

Sécurisation des fichiers de point de contrôle

La protection au niveau du package n'inclut pas la protection des fichiers de point de contrôle ; vous devez donc sécuriser ces fichiers séparément. Les données de point de contrôle peuvent être stockées uniquement dans le système de fichiers et vous devez utiliser une liste de contrôle d'accès au système d'exploitation pour sécuriser l'emplacement ou le dossier de stockage du fichier. Il est important de sécuriser les fichiers de point de contrôle car ceux-ci contiennent des informations sur l'état du package, notamment les valeurs actuelles des variables. Une variable peut ainsi contenir un ensemble d'enregistrements doté de plusieurs lignes de données privées, telles que des numéros de téléphone. Pour plus d’informations, consultez Accéder aux fichiers utilisés par des packages.

Configurer des points de contrôle pour redémarrer un package ayant échoué

Vous pouvez configurer les packages Integration Services de sorte qu’ils redémarrent à partir d’un point d’arrêt au lieu de réexécuter l’ensemble du package. Pour ce faire, vous devez définir les propriétés des points de contrôle.

Pour configurer le redémarrage d'un package

Dans SQL Server Data Tools (SSDT), ouvrez le projet Integration Services contenant le package à configurer.
Dans l’Explorateur de solutions, double-cliquez sur le package pour l’ouvrir.
Cliquez sur l'onglet Flux de contrôle .
Cliquez avec le bouton droit n’importe où dans l’arrière-plan de la surface de dessin du flux de contrôle, puis cliquez sur Propriétés.
Définissez la propriété SaveCheckpoints sur True.
Tapez le nom du fichier point de contrôle dans la propriété CheckpointFileName.
Définissez la propriété CheckpointUsage sur l’une des deux valeurs suivantes :
- Sélectionnez Always pour toujours redémarrer le package à partir du point d'arrêt.
  
  Important
  
  Une erreur se produit si le fichier de point d'arrêt n'est pas disponible.
- Sélectionnez IfExists pour redémarrer le package uniquement si le fichier de point d'arrêt est disponible.
Configurez les tâches et les conteneurs à partir desquels le package peut redémarrer.
- Cliquez avec le bouton droit sur une tâche ou un conteneur, puis cliquez sur Propriétés.
- Affectez à la propriété FailPackageOnFailure la valeur True pour chaque tâche et conteneur sélectionnés.

Ressources externes

Article technique, Redémarrage automatique des packages SSIS après un basculement ou une défaillance
Article du Support technique Microsoft, Les points de contrôle SSIS ne sont pas respectés pour les éléments de conteneur de boucles For ou Foreach, sur le site support.microsoft.com.