SQL dynamique

Les instructions SQL dynamiques sont construites à l’exécution, dans une variable hôte. GixSQL supporte les trois premières « méthodes » de Pro*COBOL ; la quatrième (descripteurs, DESCRIBE) n’est pas supportée.

Méthode 1 : EXECUTE IMMEDIATE

Pour une instruction sans variables hôtes et qui ne renvoie aucune ligne :

           MOVE "DELETE FROM EMP WHERE DEPTNO = 40" TO SQL-STMT.
           EXEC SQL EXECUTE IMMEDIATE :SQL-STMT END-EXEC.

           EXEC SQL
               EXECUTE IMMEDIATE 'UPDATE TAB1 SET FLD1 = FLD1 + 100'
           END-EXEC.

Méthode 2 : PREPARE et EXECUTE

Pour une instruction exécutée plusieurs fois, avec des paramètres d’entrée :

       01  DYNSTMT  SQL TYPE IS VARCHAR(200).
       ...
           MOVE "INSERT INTO TAB1 (F1, F2) VALUES (?, ?)" TO DYNSTMT-ARR.
           MOVE FUNCTION LENGTH(FUNCTION TRIM(DYNSTMT-ARR))
             TO DYNSTMT-LEN.
           EXEC SQL PREPARE STMT1 FROM :DYNSTMT END-EXEC.

           MOVE 1 TO T1. MOVE 2 TO T2.
           EXEC SQL EXECUTE STMT1 USING :T1, :T2 END-EXEC.

EXECUTE ... INTO :a, :b USING ... renvoie les valeurs d’une requête mono-ligne.

Méthode 3 : requêtes préparées et curseurs

Pour une requête renvoyant plusieurs lignes :

           EXEC SQL PREPARE STMT2 FROM :DYNSTMT END-EXEC.
           EXEC SQL DECLARE C1 CURSOR FOR STMT2 END-EXEC.
           EXEC SQL OPEN C1 USING :DEPT-NO END-EXEC.
           EXEC SQL FETCH C1 INTO :EMP-NAME END-EXEC.
           ...
           EXEC SQL CLOSE C1 END-EXEC.
NoteÀ vérifier

OPEN ... USING sur un curseur déclaré sur une instruction préparée.

Marqueurs de paramètres

Chaque base de données a sa propre syntaxe pour les paramètres :

  • PostgreSQL : $1, $2…
  • Oracle : :name ou :1, :2…
  • ODBC : ?
  • SQLite : n’importe laquelle de ces syntaxes.

Pour les instructions statiques, le précompilateur génère les marqueurs choisis avec -z / --param-style : d pour $1 (par défaut), a pour ?, c pour :1. Le pilote Oracle accepte aussi les marqueurs $n.

Pour les instructions préparées, le texte est écrit par le programme. GixSQL peut convertir les marqueurs d’une instruction préparée en ceux de la base de données, avec l’option de connexion fixup_params=on ou la variable d’environnement GIXSQL_FIXUP_PARAMS=on.