L'instruction sql est une instruction de requête générale qui permet d'exécuter une requête SQL dans la base de donnée source et récupère les résultats de manière standard dans des formes vectorielles DIML.
source : La source est une des sources de données préalablement définie par une instruction <%sqlsource. Si elle est omise, c'est la variable DIML SQL::LAST_DEFINED_SOURCE qui est utilisée comme source par défaut.
query : C'est un attribut obligatoire dans lequel la requête SQL doit être écrite en utilisant l'échappement SGML. La requête peut contenir des appels DIML pourvu qu'ils soient correctement échappés.
En principe, cette instruction est appropriée pour les requêtes renvoyant des résultats, mais elle peut être également utilisée avec toute autre requête excepté celles qui demandent des données en entrée (sauf des données littérales en dur, auquel cas il s'agit d'une requête littérale sans retour).
Pour les requêtes complexes ou longues, l'attribut query peut être exprimé sous forme d'une indirection DIML. Il est alors possible d'écrire des requêtes SQL dans un template.
alias : Par défaut, l'instruction SQL génère ses résultats dans la portée standard SQL::. L'attribut alias permet de changer cette portée (il est conseillé qu'une portée se termine toujours par ::, bien que'il ne s'agisse que d'un préfixe litéral).
fromhtml : Ce commutateur permet d'activer un filtrage systématique sur les variables de type chaîne qui transforme des en retour ligne du système d'exploitation.
scalar : Ce commutateur suscite une résolution scalaire de la requête. Il doit être utilisé seulement si la requête est notoirement à résolution unique (par exemple, les requêtes basées sur la clef primaire). Les variables de sorties sont alors des entrées scalaires de l'interface DIML.
|