A l'exécution, l'activité Exécuter la requête exécute une instruction select SQL.
L'activité Exécuter la requête prend en charge les requêtes paramétrées - requête contenant des paramètres d'entrée ou des paramètres d'entrée et de sortie. Lorsque des paramètres d'entrée sont indiqués dans une requête, la valeur du paramètre est fournie en phase d'exécution. Le caractère ? dans l'exemple suivant d'instruction select indique qu'un caractère d'entrée a été défini :
select * from myUserSchema.mySourceTable where myUserSchema.mySourceTable.myColumn=?
Dans l'instruction select précédente, le caractère
* spécifie que la requête renvoie la ou les colonnes trouvées dans la table
mySourceTable en tant que paramètres de sortie. Par exemple, si la table
mySource contient deux colonnes, l'une de type CHAR et l'autre de type VARCHAR, l'activité
Exécuter la requête renvoie deux paramètres de sortie, l'un de type CHAR et l'autre de type VARCHAR.
Remarque : Seule l'instruction SQL select est prise en charge dans l'activité Exécuter la requête.
L'instruction SQL insert n'est pas prise en charge dans l'activité Exécuter la requête.
Les étapes d'ajout et de configuration d'une activité
Exécuter la requête dans une orchestration sont décrites dans les procédures suivantes :
Ajouter une activité Exécuter la requête à l'orchestration
- Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
- Sélectionnez l'onglet Activités et développez le dossier Base de données.
- Déplacez l'activité Exécuter la requête sur l'orchestration.
- Sélectionnez l'activité Exécuter la requête.
Créer, sélectionner ou éditer un noeud final de base de données
- Cliquez sur la tâche Sélectionner le noeud final dans la liste de contrôle et sélectionnez l'une des actions suivantes :
- Sélectionnez un noeud final existant :
- Sélectionnez Parcourir. L'Explorateur de projet s'ouvre.
- Sélectionnez un noeud final existant et cliquez sur OK.
Passez à la procédure Spécifiez l'instruction SQL de requête.
- Sélectionnez un noeud final existant et éditez-le.
- Sélectionnez Parcourir. L'Explorateur de projet s'ouvre.
- Sélectionnez un noeud final existant et cliquez sur OK
- Cliquez sur Editer. Le panneau Editer un noeud final s'ouvre.
- Créez un noeud final : sélectionnez Nouveau. Le panneau Créer un noeud final s'ouvre.
- Créez ou éditez un noeud final de base de données
Spécifiez l'instruction SQL de requête
- Sélectionnez la tâche Entrer la requête dans la Liste de contrôle.
Le panneau Entrer la requête s'ouvre.
- Entrez la requête dans l'espace affiché dans le panneau. Ne placez pas de point-virgule à la fin de votre requête.
- Cliquez sur Afficher les colonnes pour vérifier les caractéristiques des colonnes d'une table sélectionnée afin de faciliter la construction de l'instruction SQL, en entrant des noms et des colonnes de table valides.
- Sélectionnez un autre paramétrage de codage de caractères pour les paramètres d'entrée et de sortie si le codage souhaité diffère du codage par défaut pour la base de données, à l'aide de l'une des options suivantes :
- Dans la liste Codage, sélectionnez l'un des types de codage par défaut.
- Entrez le type de codage directement en cliquant dans la zone Codage et en saisissant le type de codage.
Remarque : Certains caractères codés sur deux octets ne sont pas convertis à l'aide du codage SHIFT-JIS. Pour plus d'informations, voir
Utilisation du codage Shift-JIS.
- Cliquez sur Valider la requête. Cette action vérifie la validité de votre requête et remplit les paramètres d'entrée et de sortie dans les tâches Mapper les entrées et Mapper les sorties.
- Entrez une valeur dans la zone Nombre maximal de lignes. La zone Nombre maximal de lignes spécifie le nombre maximal de lignes que la requête doit renvoyer pendant l'exécution.
Remarque : si la même requête est lancée plusieurs fois sur les mêmes données, le même ensemble de lignes est renvoyé. Par exemple, si la valeur de Nombre maximal de lignes est égale à 1, la même ligne (première ligne) est toujours renvoyée chaque fois que la requête est lancée, il n'y a pas d'itération dans le jeu de lignes.
Spécifier les options de tentative pour la requête
Pour spécifier les options de tentative pour la requête :
- Configurez les Options de tentative.
Remarque : Pour l'activité Exécuter la requête sur la base de données, si vous définissez l'option de tentative par zéro, le dispositif d'intégration tente indéfiniment d'établir la connexion.
Mappez la sortie de l'activité
- Sélectionnez la tâche Mapper les sorties dans la Liste de contrôle.
Les colonnes renvoyées par l'instruction SELECT sont les éléments affichés sous l'élément lignes/ligne dans le panneau Depuis l'activité.
- Il n'est pas obligatoire de mapper les paramètre de sortie pour cette activité.
Voir Création d'une mappe pour des instructions générales sur le mappage.