Mapper des paramètres de requête à des variables dans une tâche d'exécution SQL
Cette rubrique décrit la façon d'utiliser une instruction SQL paramétrable dans la tâche d'exécution SQL et de créer des mappages entre des variables et les paramètres de l'instruction SQL.
Pour en savoir plus sur la tâche d’exécution SQL, les marqueurs de paramètres et les noms de paramètres que vous utilisez avec différents types de connexions, consultez Tâche d’exécution de requêtes SQL et Paramètres et codes de retour dans la tâche d’exécution SQL.
Pour mapper un paramètre de requête à une variable
Dans SQL Server Data Tools (SSDT), ouvrez le package Integration Services que vous voulez utiliser.
Dans l'Explorateur de solutions, double-cliquez sur le package pour l'ouvrir.
Cliquez sur l'onglet Flux de contrôle .
Si le package ne contient pas déjà une tâche d'exécution SQL, ajoutez-en une au flux de contrôle du package. Pour plus d’informations, consultez Ajouter ou supprimer une tâche ou un conteneur dans un flux de contrôle.
.Double-cliquez sur la tâche d'exécution SQL.
Indiquez une commande SQL paramétrable de l'une des manières suivantes :
Utilisez l’entrée directe et tapez la commande SQL dans la propriété SQLStatement.
Utilisez l’entrée directe, cliquez sur Générer la requête, puis créez une commande SQL à l’aide des outils graphiques fournis par le Générateur de requêtes.
Utilisez un fichier de connexion, puis référencez le fichier contenant la commande SQL.
Utilisez une variable, puis référencez la variable contenant la commande SQL.
Les marqueurs de paramètres que vous utilisez dans les instructions SQL paramétrables sont liés au type de connexion que la tâche d'exécution SQL utilise.
Type de connexion Marqueur de paramètre ADO ? ADO.NET et SQLMOBILE @<nom de paramètre> ODBC ? EXCEL et OLE DB ? Le tableau suivant présente des exemples de la commande SELECT par type de gestionnaire de connexions. Les paramètres fournissent les valeurs de filtre dans les clauses WHERE. Les exemples utilisent la commande SELECT pour retourner les produits de la table Product dans AdventureWorks2012 qui ont un ProductID supérieur et inférieur aux valeurs spécifiées par deux paramètres.
Type de connexion Syntaxe SELECT EXCEL, ODBC et OLEDB SELECT* FROM Production.Product WHERE ProductId > ? AND ProductID < ?ADO SELECT* FROM Production.Product WHERE ProductId > ? AND ProductID < ?ADO.NET SELECT* FROM Production.Product WHERE ProductId > @parmMinProductID AND ProductID < @parmMaxProductIDPour obtenir des exemples d’utilisation des paramètres avec des procédures stockées, consultez Paramètres et codes de retour dans la tâche d’exécution SQL.
Cliquez sur Mappage de paramètre.
Pour ajouter un mappage de paramètre, cliquez sur Ajouter.
Fournissez un nom dans la zone Nom du paramètre .
Les noms de paramètres que vous utilisez sont liés au type de connexion que la tâche d'exécution SQL utilise.
Type de connexion Nom du paramètre ADO Param1, Param2, ... ADO.NET et SQLMOBILE @<nom de paramètre> ODBC 1, 2, 3, ... EXCEL et OLE DB 0, 1, 2, 3, ... Dans la liste Nom de variable , sélectionnez une variable. Pour plus d’informations, consultez Ajouter, supprimer, modifier l’étendue de la variable définie par l’utilisateur dans un package.
Dans la liste Direction , indiquez si le paramètre est une entrée, une sortie ou une valeur de retour.
Dans la liste Type de données , définissez le type de données du paramètre.
Important
Le type de données du paramètre doit être compatible avec le type de données de la variable.
Répétez les étapes 8 à 11 pour chaque paramètre de l'instruction SQL.
Important
L'ordre de mappage des paramètres doit être identique à leur ordre d'apparition dans l'instruction SQL.
Cliquez sur OK.
Voir aussi
Tache d’exécution de requêtes SQL
Paramètres et codes de retour dans la tâche d'exécution SQL
Variables Integration Services (SSIS)