Gérer les requêtes

L'écran Requêtes de Portail ZAPP (menu Administration › Instance et exploitation › Requêtes) enregistre des requêtes SQL de lecture sur la base de l'instance, pour les exécuter à la demande et exporter leur résultat. Une requête enregistrée peut aussi alimenter une liste dans un formulaire dynamique ou être lancée par une tâche planifiée (voir « Planifier les tâches »).

L'écran est réservé aux Administrateurs.

La liste des requêtes

La liste montre pour chaque requête son N°, son Nom, sa Description, la colonne Procédure stockée (Oui si c'en est une) et les Groupes autorisés : le nombre de groupes, ou le badge Publique quand aucun groupe n'est choisi. Le champ Rechercher… cherche dans le nom et la description.

Sur chaque ligne, le bouton lecture ouvre l'exécution, le crayon ouvre la modification.

Créer et modifier une requête

Nouvelle requête demande :

• N° : un numéro d'au moins 1000 (convention : 1000 et plus), qui ordonne la liste ;
• Nom et Description ;
• Code : identifiant stable et unique, utilisé par l'import et l'export entre instances. Choisissez-le une fois pour toutes ;
• Procédure stockée : cochez-la si le champ SQL contient seulement le nom d'une procédure (nom ou schema.nom, rien d'autre) ;
• SQL : le texte de la requête ;
• Groupes autorisés : les groupes dont les membres peuvent exécuter la requête. Vide = accessible à tous.

Pour éviter une erreur de manipulation, une requête qui contient l'un des mots INSERT, UPDATE, DELETE, DROP, ALTER, EXEC, TRUNCATE, CREATE, GRANT ou REVOKE est refusée, même si le mot n'apparaît que dans un commentaire ou un texte entre apostrophes. Un code déjà pris est refusé aussi. Dans ces cas le formulaire revient sans être enregistré.

Ce contrôle est un garde-fou, pas une protection complète : seule une connexion en lecture seule dédiée aux requêtes, que votre hébergeur peut configurer, empêche vraiment toute écriture. Sans elle, les requêtes s'exécutent avec les droits de l'application.

Exécuter une requête et exporter le résultat

L'écran d'exécution affiche à gauche les Paramètres : un champ par nom précédé de @ dans le SQL (par exemple @debut dans WHERE date_creation >= @debut::date). Les valeurs sont transmises comme du texte : convertissez-les dans le SQL quand la colonne n'est pas du texte. Un paramètre laissé vide vaut « aucune valeur » (NULL). Une procédure stockée s'exécute sans paramètre.

Cliquez sur Exécuter. Le résultat s'affiche à droite :

• quand le module Grilles de données est installé, dans une grille ;
• sinon, dans un tableau précédé du nombre de lignes et de la durée d'exécution.

Une erreur SQL s'affiche à la place du résultat. Après une exécution, Export CSV et Export Excel relancent la requête avec les mêmes paramètres et téléchargent le résultat complet.

Un administrateur qui n'appartient à aucun des groupes autorisés d'une requête ne peut pas l'exécuter. Chaque exécution est journalisée (auteur, durée, nombre de lignes, erreur éventuelle).

Supprimer une requête

Sur l'écran de modification, Supprimer supprime la requête après confirmation, avec le journal de ses exécutions. La suppression est définitive : vérifiez d'abord qu'aucune liste de formulaire ni tâche planifiée ne s'appuie sur elle.

Ce qu'il faut savoir

• Une requête Publique peut être exécutée par toute personne qui atteint un point d'exécution, notamment par les utilisateurs d'un formulaire dynamique dont une liste s'appuie sur elle. Restreignez-la par groupes dès qu'elle renvoie des données sensibles.
• Pour une liste de formulaire, la première colonne du résultat est la valeur enregistrée et la deuxième le libellé affiché ; seules les 500 premières valeurs sont proposées.
• Une tâche planifiée qui lance une requête ne passe pas par le contrôle des groupes autorisés.

Voir aussi

• « Gérer les groupes » : les groupes à autoriser.
• « Régler les droits » : l'accès aux écrans du module.