Activité Exécuter la requête

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.

Ajouter une activité Exécuter la requête à l'orchestration

  1. Créez ou ouvrez une orchestration. Une représentation graphique de l'orchestration s'affiche.
  2. Sélectionnez l'onglet Activités et développez le dossier Base de données.
  3. Déplacez l'activité Exécuter la requête sur l'orchestration.
  4. Sélectionnez l'activité Exécuter la requête.

Créer, sélectionner ou éditer un noeud final de base de données

  1. 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 :
      1. Sélectionnez Parcourir. L'Explorateur de projet s'ouvre.
      2. 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.
      1. Sélectionnez Parcourir. L'Explorateur de projet s'ouvre.
      2. Sélectionnez un noeud final existant et cliquez sur OK
      3. 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.
  2. Créez ou éditez un noeud final de base de données

Spécifiez l'instruction SQL de requête

  1. Sélectionnez la tâche Entrer la requête dans la Liste de contrôle. Le panneau Entrer la requête s'ouvre.
  2. Entrez la requête dans l'espace affiché dans le panneau. Ne placez pas de point-virgule à la fin de votre requête.
  3. 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.
  4. 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.
  5. 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.
  6. 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.

Configurer les paramètres d'entrée pour la requête

  1. Sélectionnez la tâche Configurer des paramètres d'entrée dans la Liste de contrôle. Le panneau Configurer des paramètres d'entrée montre le ou les paramètres d'entrée de la requête.
  2. 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.
  3. Cliquez dans l'en-tête de la colonne pour trier les lignes par valeur de colonne. Par exemple, pour trier les lignes par nom de colonne, cliquez dans l'en-tête Nom de colonne. Une flèche apparaît à droite du nom de l'en-tête de colonne. Une flèche vers le haut indique que la colonne est triée par ordre alphabétique, de a à z. Une flèche vers le bas indique que la colonne est triée par ordre alphabétique inversé, de z à a. Cliquez sur la flèche pour inverser l'ordre alphabétique.
  4. Si nécessaire, modifiez les valeurs de Type de données, Codage ou NULL admis pour chaque paramètre d'entrée de requête. Cliquez sur la zone pour effectuer une nouvelle sélection :
    • Nom de paramètre - Vous pouvez remplacer le nom par défaut par un nom plus explicite. Les paramètres sont répertoriés dans l'ordre dans lequel ils sont spécifiés dans la requête.
    • Type de données - Sélectionnez un type de données pour ce paramètre.
      Remarque : (pour les types de données MONEY et XMLTYPE). Pour le type de données XMLTYPE dans une base de données Oracle et les types de données MONEY dans une base de données SQL Server, Studio n'associe pas automatiquement le type de données correct, vous devez donc sélectionner manuellement le type de données approprié.
    • Codage - Sélectionnez un autre paramétrage de codage de caractères pour le paramètre si le codage requis diffère du codage par défaut pour la base de données.
    • Taille - Taille de la colonne définie dans la table. Cette taille est extraite de la table de base de données et n'est pas configurable.
  5. Cliquez sur Réinitialiser les valeurs pour interroger la base de données et extraire les types et la taille des données de la base de données. Cette opération remplace le type et la taille des données définis manuellement dans le panneau.

Configurer les paramètres de sortie

  1. Sélectionnez la tâche Configurer un ensemble de résultat dans la Liste de contrôle. Le panneau Configurer un ensemble de résultat s'ouvre et les valeurs par défaut du ou des paramètres de sortie de la requête sont répertoriées.
  2. 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.
  3. Si nécessaire, modifiez les valeurs de Type de données, Codage ou NULL admis pour chaque paramètre de sortie de requête :
    • Nom de paramètre - Vous pouvez remplacer le nom par défaut par un nom plus explicite. Les paramètres sont répertoriés dans l'ordre dans lequel ils sont spécifiés dans la requête.
    • Type de données - Sélectionnez un type de données pour ce paramètre.
    • Codage - Sélectionnez un autre paramétrage de codage de caractères pour le paramètre si le codage requis diffère du codage par défaut pour la base de données.
    • Taille - Taille de la colonne définie dans la table. Cette taille est extraite de la table de base de données et n'est pas configurable.
  4. Cliquez sur Réinitialiser les valeurs pour interroger la base de données et extraire les types et la taille des données de la base de données. Cette opération remplace le type et la taille des données définis manuellement dans le panneau.

Spécifier les options de tentative pour la requête

Pour spécifier les options de tentative pour la requête :
  1. 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 l'entrée de l'activité

  1. Sélectionnez la tâche Mapper les entrées dans la Liste de contrôle. Les paramètres d'entrée indiqués pour la requête sont les paramètres d'entrée de l'activité. Les paramètres d'entrée de l'activité sont affichés sous l'élément parameters dans le panneau Vers l'activité.
  2. Vous devez mapper tous les paramètres d'entrée de l'activité. Voir Création d'une mappe pour accéder à des instructions générales sur le mappage.

Mappez la sortie de l'activité

  1. 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é.
  2. 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.
 



Commentaires | Notices


Icône d'horodatage Dernière révision: Friday, November 1, 2013


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/db_execute_query_activity.html