Dans un programme PowerScript, on peut intégrer des requêtes SQL, on parle de requêtes encapsulées (Embedded SQL). Une variable PowerScript utilisée dans une requête doit être précédée par « : ». La requête doit être terminée par un « ; ».
Ex : insert into employe (salarie) values(:sal_var);

PowerBuilder supporte l’utilisation de variables indicatrices dans les requêtes Select Into et Fetch Into. Une variable indicatrice retourne :
    · 0 si la valeur retournée par la requête est non NULL,
    · -1 si la valeur retournée par la requête est NULL,
    · +1 s’il y a un problème de conversion entre le type de la colonne et le type de la variable.

Une variable indicatrice est placée après la variable, séparée par un espace.
Ex : Select nom into :nom_cli  indnom_cli from client where id_cli=10;

Il est conseillé de tester l’echec ou le succés d’une requête grâce à l’utilisation de la fonction SQLCODE. On l’uitlise comme suit : <objet de transaction>.SQLCODE. Cette fonction retourne :

    · 0 si succés,
    · 100 si succés mais la requête ne retourne pas de valeur,
    · -1 si erreur.

Ex : If SQLCA.SQLCODE = -1 then
    MessageBox(‘SQL erreur’,SQLCA.SQLErrText)
    End If

Dans un script, on peut utiliser les requêtes standards : Select Into, Insert, Update et Delete, les curseurs et les procédures stockées. Pour les deux derniers, il faut d’abord les déclarer pour pouvoir les utiliser. On les déclare comme des variables globales, d’instance, partagées ou locales dans les painters des fenêtre, objet utilisateur, menu et PowerScript.

Les instructions SQL :
· Select Into {using objet de transaction}
On précise le nom de l’objet de transaction s’il est différent de celui pris par défaut SQLCA. Rappelons que l’objet de transaction contient toutes les informations nécessaire pour identifier la base de données sur laquelle on travaille.

· Update {using objet de transaction}

· Update Where current of <nom_curseur>
cette commande est utilisée avec un curseur. Elle permet de mettre à jour le tuple correspondant à l’enregistrement ramené par le Fetch du curseur. La spécification de l’objet de transaction se fait lors de la déclaration du curseur.

· Insert into {using objet de transaction}

· Delete from {using objet de transaction}

· Delete Where current of <nom_curseur>

· Declare <nom_curseur> Cursor For <ordre Select> {using objet de transaction}
Rappelons qu’un curseur peut être déclaré comme une variable globale, d’instance, partagée ou locale.

· Declare <nom_procédure> Procedure For
<nom procédure stockée>
@param1=valeur1, @param2=valeur2,...
{using objet de transaction}

param et valeur représentent les noms des paramètres de la procédure et les valeurs qu’on leur passe (valeur peut être une variable qui sera renseignée dans un script avant l’appel de la fonction) .

· Open <nom_curseur> permet d’ouvrir le curseur.

· Fetch <nom_curseur> into <variables>.
nom_curseur est le nom du curseur tel qu’on l’a défini dans la section Declare et <Variables> sont des variables receptrices PowerScript.

· Close <nom_curseur> permet de fermer le curseur.

· Execute <nom_procédure> permet d’exécuter la procédure stockée. <nom_procédure> est le nom de la procédure tel qu’on l’a défini dans la section Declare.

· Close <nom_procedure> permet d’arrêter le traitement de de la procédure. Cette commande doit être précédée par la commande Execute. Elle n’est obligatoire que si la procédure stocke des valeurs.

· Connect {using objet de transaction}
Cette commande permet de faire la connexion avec la base de données. Elle doit être exécutée avant d’ exécucter des requêtes SQL. En général, elle est exécutée en debut d’application.

· Disconnect {using objet de transaction} permet de se deconnecter de la base de données.

· Commit {using objet de transaction}

· Rollback {using objet de transaction}

· Requêtes SQL dynamiques : supposons qu’on ne connaît pas tous les paramètres d’une requête au moment de la compilation. Ces paramètres seront renseignés lors de l’exécution de l’application. L’uitilisation des requêtes dynamiques reste rare, ll existe des commandes spécifiques pour les réaliser. Les variables globales prédéfinies SQLSA et SQLDA de types respectifs DynamicStagingArea et DynamicDescrptionArea sont utilisées dans ce but.