UpsQry.IConnexionSql.CreerBlocSql

Description

Le nom du bloc Pl/Sql doit être unique. Il permet de tracer son exécution. Le source du bloc Pl/Sql doit respecter la syntaxe et la sémantique de la base de données cible, même pour le pilote Open DataBase Connectivity (ODBC).

Le source du bloc Pl/Sql peut être par exemple :

• Un appel de procédure ou de fonction stockée.
  BEGIN
${SalaireMoyen}:=MaFonction(${NumeroDepartement});
END;
  
• Un ordre agissant sur le dictionnaire de données.
  CREATE OR REPLACE PROCEDURE MaProcedure(NumeroDepartement IN NUMBER, SalaireMin OUT NUMBER, SalaireMax OUT NUMBER) AS
BEGIN
SELECT MIN(sal), MAX(sal) INTO SalaireMin, SalaireMax FROM emp WHERE deptno=NumeroDepartement;
END MaProcedure;
  
• Une suite d'ordres dans un bloc Pl/Sql.
  BEGIN;
SELECT ename:=${NomEmploye}, empno:=${NumeroEmploye} FROM emp WHERE deptno=${NumeroDepartement};
INSERT INTO emp(ename, empno, hiredate) VALUES (${NomEmploye}, ${NumeroEmploye}, ${DateEmbauche});
UPDATE emp SET sal=${Salaire} WHERE empno=${NumeroEmploye};
DELETE FROM emp WHERE deptno=${NumeroDepartement};
${SalaireMoyen}:=MaFonction(${NumeroDepartement});
END;
  

Le source du bloc Pl/Sql ne peut pas être :

• Un ordre de validation de transaction.
  COMMIT;
  Il faut utiliser impérativement la méthode Valider du type implémentant l'interface IConnexionSql appliquée à la connexion concernée.
  
• Un ordre d'invalidation de transaction.
  ROLLBACK;
  Il faut utiliser impérativement la méthode Invalider du type implémentant l'interface IConnexionSql appliquée à la connexion concernée.
  

Le source du bloc Pl/Sql peut comporter des paramètres d'entrée, de sortie ou d'entrée-sortie. Ils sont identifiés par des pseudo-variables correspondant aux noms déclarés par l'appel à la méthode DeclarerParametre.
Si le paramètre TTP spécifiant la taille des tableaux pour les paramètres a pour valeur 1, alors il y a un seul cycle d'exécution au niveau de la base de données. Sinon les paramètres sont transmis par tableau dont la taille est donnée par TTP et il y a autant de cycles d'exécution au niveau de la base de données que de lignes dans le tableau.
La gestion des tableaux est automatisée pour rendre le principe de Bulk Processing transparent.

Si le paramètre TDG spécifiant le temps de garde en secondes est positif, alors il existe un délai pour exécuter l'ordre Sql.

Si la taille du source du bloc Pl/Sql dépasse la taille du paramètre TailleMaxOrdreSql, alors l'exception OrdreSqlTropGrand est envoyée.

Si une méthode d'un type implémentant l'interface IBlocSql échoue, alors l'exception ErreurOrdreSql est envoyée.

Exemple

Voir aussi

Traduction