UpsQry.IConnexionSql.ExecuterOrdreSql

Description

Le nom de l'ordre Sql doit être unique. Il permet de tracer son exécution. Le source de l'ordre 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 de l'ordre Sql peut être par exemple :

• Un ordre de sélection.
  SELECT ename, empno FROM emp WHERE deptno=10;
  
• Un ordre d'insertion.
  INSERT INTO emp(ename, empno, hiredate) VALUES ('john', 8100, sysdate);
  
• Un ordre de mise à jour.
  UPDATE emp SET sal=2100.00 WHERE empno=8100;
  
• Un ordre de suppression.
  DELETE FROM emp WHERE deptno=40;
  
• 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;
  

Le source de l'ordre 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 de l'ordre Sql ne peut comporter ni des paramètres d'entrée, de sortie ou d'entrée-sortie et ni des résultats pour les ordres de sélection.

A l'issu de l'exécution, le paramètre NbEnregistrementsImpactes reçoit le nombre d'enregistrements impactés quand un unique ordre Sql d'insertion, de mise à jour ou de suppression est exécuté.

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 de l'ordre Sql dépasse la taille du paramètre TailleMaxOrdreSql, alors l'exception OrdreSqlTropGrand est envoyée.

Si la méthode échoue, alors l'exception ErreurOrdreSql est envoyée.

Exemple

Voir aussi

Traduction