Spécification d'un stage SQL Command lors de l'exécution

Cette procédure explique comment configurer un flux de données pour qu'il prenne en charge les options d'exécution d'un stage SQL Command ainsi que d'indiquer les arguments Job Executor pour le faire.

Ouvrez le flux de données dans Enterprise Designer.
Pour configurer les options d'exécution d'un stage dans un flux de données intégré, ouvrez ce dernier.
Cliquez sur l'icône Options de flux de données de la barre d'outils ou sur Édition > Options de flux de données. La boîte de dialogue Options de flux de données apparaît.
Cliquez sur Ajouter. La boîte de dialogue Définir l'option de flux des données apparaît.
Développez le stage SQL Command.
Sélectionnez une option SQL Command. Il peut s'agir de PreSqlCommand, de SqlCommand ou de PostSqlCommand.
PreSqlCommand
Instructions SQL que vous souhaitez exécuter avant le traitement des enregistrements arrivant dans le stage. Ces instructions SQL sont exécutées une fois par exécution après le début de l'exécution du flux de données, mais avant le traitement du premier enregistrement par le stage SQL Command.

Un exemple d'utilisation du SQL avant traitement serait de créer une table pour les enregistrements qui seront traités.

SqlCommand
Instructions SQL à exécuter pour chaque enregistrement du flux de données.

PostSqlCommand
Instructions SQL à exécuter après le traitement de tous les enregistrements. Ces instructions SQL sont exécutées une fois par exécution après la fin du stage SQL Command, mais avant la fin du flux de données.

Par exemple, vous pouvez utiliser post-SQL pour créer un index après le traitement des enregistrements.

Le nom d'option SQL Command s'affiche dans les champs Option name et Option label. Il s'agit du nom de l'option qui devra être spécifié lors de l'exécution afin de définir cette option.
Saisissez une description de l'option dans le champ Description.
Dans le champ Target, sélectionnez l'option Selected stage(s).
Si vous voulez limiter les valeurs qu'un utilisateur peut sélectionner, modifiez les options disponibles dans le champ Legal values en cliquant sur l'icône située directement à droite de ce champ.
Pour modifier la valeur par défaut, indiquez une valeur différente dans le champ Valeur par défaut.

Remarque : Pour un service, vous ne pouvez modifier que les valeurs par défaut avant d'exposer le service pour la première fois.Une fois que vous exposez le service, vous ne pouvez plus modifier les valeurs par défaut à l’aide d’Enterprise Designer.Au lieu de cela, vous devez utiliser Management Console.Pour plus d'informations, reportez-vous à la section Spécification des Options de services par défaut.
Cliquez sur OK.
Continuez d'ajouter les options souhaitées.
Cliquez sur OK dans la boîte de dialogue des Options du flux de données lorsque vous avez terminé d'ajouter vos options.
Enregistrez et exposez le flux de données.
Créez un fichier texte contenant l'instruction SQL que vous souhaitez utiliser lors de l'exécution.
Le fichier texte peut prendre la forme suivante :
```
SqlCommand = UPDATE CustomersSET 
ContactName='Alfred Schmidt'
City='Hamburg'
WHERE CustomerName='Alfreds Futterkiste';
```
Dans cet exemple, SqlCommand est l'un des noms des options du stage SQL Command.
Utilisez l'argument -o lors de l'exécution d'un exécuteur de job depuis la ligne de commande.
```
java -jar jobexecutor.jar -h "noipa019sh-l1" -u "admin" -p "admin" -s "8080" -o "options.txt" -j "FetchOracleData" -w
```
Le nom de fichier (options.txt) indique le nom du fichier texte que vous avez créé à l'étape 14.

(Pour plus d'informations, reportez-vous à la section Exécution d'un job à partir de la ligne de commande.)