Tache d'exécution de requêtes SQL
La tâche d'exécution de SQL exécute des instructions ou des procédures stockées SQL à partir d'un package. La tâche peut contenir une seule ou plusieurs instructions SQL s'exécutant de façon séquentielle. Vous pouvez utiliser la tâche d'exécution SQL aux fins suivantes :
Tronquer une table ou une vue pour la préparer à l'insertion de données.
Créer, modifier et supprimer des objets de base de données tels que des tables et des vues.
Recréer des tables de faits et de dimensions avant d'y charger des données.
Exécuter des procédures stockées.
Enregistrer dans une variable l'ensemble de lignes retourné par une requête.
Vous pouvez configurer la tâche d'exécution SQL comme suit :
Spécifiez le type de gestionnaire de connexions à utiliser pour établir la connexion à une base de données.
Spécifiez le type d'ensemble de résultats retourné par l'instruction SQL.
Spécifiez un délai d'expiration pour les instructions SQL.
Spécifiez la source de l'instruction SQL.
Indiquez si la tâche passe la phase de préparation de l'instruction SQL.
Si vous utilisez le type de connexion ADO, indiquez si l'instruction SQL est une procédure stockée. Pour d'autres types de connexion, cette propriété est définie en lecture seule et sa valeur est toujours false.
Vous pouvez combiner la tâche d'exécution SQL et les conteneurs de boucles Foreach et For pour exécuter plusieurs instructions SQL. Ces conteneurs mettent en œuvre des flux de contrôle répétitifs dans un package et peuvent exécuter la tâche d'exécution SQL de façon répétée. Par exemple, à l'aide du conteneur de boucles Foreach, un package peut passer en revue les fichiers d'un dossier et exécuter une tâche d'exécution SQL de façon répétée afin d'exécuter l'instruction SQL stockée dans chaque fichier.
Connexion à une source de données
La tâche d'exécution SQL peut utiliser différents types de gestionnaires de connexions pour se connecter à la source de données dans laquelle elle exécute l'instruction ou la procédure stockée SQL. La tâche peut utiliser les types de connexions décrits dans le tableau suivant.
Type de connexion |
Gestionnaire de connexions |
|---|---|
EXCEL |
|
OLE DB |
|
ODBC |
|
ADO |
|
ADO.NET |
|
SQLMOBILE |
Création d'instructions SQL
La source des instructions SQL utilisée par cette tâche peut être une propriété de tâche contenant une instruction, une connexion à un fichier contenant une ou plusieurs instructions ou le nom d'une variable contenant une instruction. Les instructions SQL doivent être écrites dans le langage du système de gestion de bases de données (SGBD) source. Pour plus d'informations, consultez Utilisation de requêtes dans les packages.
Si les instructions SQL sont stockées dans un fichier, la tâche utilise un gestionnaire de connexions de fichiers pour se connecter au fichier. Pour plus d'informations, consultez Gestionnaire de connexions de fichiers.
Dans le Concepteur SSIS, vous pouvez utiliser la boîte de dialogue Éditeur de tâche d'exécution SQL pour taper des instructions SQL ou utiliser le Générateur de requêtes, une interface graphique utilisateur permettant de créer des requêtes SQL. Pour plus d'informations, consultez Éditeur de tâche d'exécution SQL (page Général) et Générateur de requêtes.
[!REMARQUE]
Les instructions SQL valides écrites en dehors de la tâche d'exécution SQL peuvent ne pas être analysées correctement par celle-ci.
Envoi de plusieurs instructions dans un traitement
Si vous incluez plusieurs instructions dans une tâche d'exécution SQL, vous pouvez les regrouper et les exécuter sous forme de traitement. Pour indiquer la fin d'un traitement, utilisez la commande GO. Toutes les instructions SQL comprises entre deux commandes GO sont envoyées dans un traitement au fournisseur OLE DB afin d'être exécutées. La commande SQL peut comprendre plusieurs traitements séparés par des commandes GO.
Il existe des restrictions sur les types d'instructions SQL pouvant être regroupées dans un traitement. Pour plus d'informations, consultez Lots d'instructions.
Si la tâche d'exécution SQL exécute un traitement d'instructions SQL, les règles suivantes s'appliquent à celui-ci :
Une seule instruction peut retourner un ensemble de résultats et il doit s'agir de la première instruction du traitement.
Si l'ensemble de résultats utilise des liaisons de résultats, les requêtes doivent retourner le même nombre de colonnes. Si les requêtes retournent un nombre différent de colonnes, la tâche échoue. Toutefois, même si la tâche échoue, les requêtes qu'elle exécute, telles que les requêtes DELETE ou INSERT, peuvent réussir.
Si les liaisons de résultats utilisent des noms de colonne, la requête doit retourner des colonnes portant les mêmes noms que l'ensemble de résultats utilisé par la tâche. Si les colonnes sont manquantes, la tâche échoue.
Si la tâche utilise la liaison de paramètre, toutes les requêtes du traitement doivent avoir le même nombre et les mêmes types de paramètres.
Exécution de commandes SQL paramétrées
Les instructions et les procédures stockées SQL utilisent fréquemment des paramètres d'entrée, des paramètres de sortie et des codes de retour. La tâche d'exécution SQL prend en charge les types de paramètres Input, Output et ReturnValue. Vous utilisez le type Input pour les paramètres d'entrée, Output pour les paramètres de sortie et ReturnValue pour les codes de retour.
[!REMARQUE]
Vous ne pouvez utiliser des paramètres dans une tâche d'exécution SQL que si le fournisseur de données les prend en charge.
Pour plus d'informations sur l'utilisation de paramètres et de codes de retour dans la tâche d'exécution SQL, consultez Utilisation de paramètres et de codes de retour dans la tâche d'exécution SQL.
Spécification d'un type d'ensemble de résultats
Selon le type de commande SQL, un ensemble de résultats peut ou non être retourné à la tâche d'exécution SQL. Par exemple, une instruction SELECT retourne généralement un ensemble de résultats, contrairement à une instruction INSERT. L'ensemble de résultats issu d'une instruction SELECT peut contenir un nombre de lignes quelconque (aucune ligne, une ligne ou de nombreuses lignes). Les procédures stockées peuvent également retourner une valeur entière, appelée « code de retour », qui indique l'état de leur exécution. Dans ce cas, l'ensemble de résultats comprend une seule ligne.
Pour plus d'informations sur l'extraction de jeux de résultats à partir de commandes SQL dans la tâche d'exécution SQL, consultez Utilisation de jeux de résultats dans la tâche d'exécution SQL.
Entrées de journal personnalisées disponibles dans la tâche d'exécution SQL
Le tableau suivant décrit les entrées de journal personnalisées de la tâche d'exécution SQL. Pour plus d'informations, consultez Implémentation de la journalisation dans les packages et Messages personnalisés pour la journalisation.
Entrée du journal |
Description |
|---|---|
ExecuteSQLExecutingQuery |
Fournit des informations sur les phases d'exécution de l'instruction SQL. Des entrées de journal sont écrites lorsque la tâche acquiert la connexion à la base de données, lorsqu'elle commence à préparer l'instruction SQL et à la fin de l'exécution de l'instruction SQL. L'entrée de journal concernant la phase de préparation inclut l'instruction SQL que la tâche utilise. |
Résolution des problèmes liés à la tâche d'exécution SQL
Vous pouvez consigner les appels que la tâche d'exécution SQL effectue auprès de fournisseurs de données externes. Vous pouvez utiliser cette fonctionnalité de journalisation pour résoudre les problèmes liés aux commandes SQL qu'exécute la tâche d'exécution SQL. Pour consigner les appels que la tâche d'exécution SQL effectue à des fournisseurs de données externes, activez la journalisation des packages et sélectionnez l'événement Diagnostic au niveau du package. Pour plus d'informations, consultez Dépannage de l'exécution des packages.
Parfois, une commande SQL ou une procédure stockée retourne plusieurs jeux de résultats. Ces jeux de résultats incluent non seulement des ensembles de lignes qui sont le résultat de requêtes SELECT, mais également des valeurs uniques qui sont le résultat d'erreurs d'instructions RAISERROR ou PRINT. Le fait que la tâche ignore les erreurs dans des jeux de résultats qui se produisent après le premier jeu de résultats dépend du type de gestionnaire de connexions utilisé :
Lorsque vous utilisez les gestionnaires de connexions OLE DB et ADO, la tâche ignore les jeux de résultats qui se produisent après le premier jeu de résultats. Par conséquent, avec ces gestionnaires de connexions, la tâche ignore une erreur retournée par une commande SQL ou une procédure stockée lorsque l'erreur ne fait pas partie du premier jeu de résultats.
Lorsque vous utilisez les gestionnaires de connexions ODBC et ADO.NET, la tâche n'ignore pas les jeux de résultats qui se produisent après le premier jeu de résultats. Avec ces gestionnaires de connexions, la tâche échoue avec une erreur quand un jeu de résultats autre que le premier jeu de résultats contient une erreur.
Configuration de la tâche d'exécution SQL
Vous pouvez définir les propriétés par programme ou par le biais du concepteur SSIS.
Pour plus d'informations sur les propriétés que vous pouvez définir dans le concepteur SSIS, cliquez sur l'une des rubriques suivantes :
Éditeur de tâche d'exécution de requête SQL (page Mappage de paramètre)
Éditeur de tâche d'exécution SQL (page Ensemble de résultats)
Pour plus d'informations sur la définition de ces propriétés dans le concepteur SSIS, cliquez sur la rubrique suivante :
Configuration de la tâche d'exécution SQL par programme
Pour plus d'informations sur la définition par programme de ces propriétés, cliquez sur la rubrique suivante :
|
.gif "Icône Integration Services (petite)")
Rester à jour avec Integration ServicesVoir aussi