Définitions des requêtes
L'onglet Définitions des requêtes permet aux utilisateurs de créer de nouvelles requêtes et d'afficher et de gérer les requêtes créées précédemment.
Tapez | Standard : requête utilisée par un rapport auquel vous êtes abonné. Personnalisée : une requête intégrée à votre système. |
Poignée | Généralement, un GUID (certaines requêtes plus anciennes peuvent avoir des descripteurs descriptifs) généré par le système et utilisé comme identifiant unique pour la requête. |
Nom | Le nom de la requête à des fins de référence. |
Description | Brève description de la requête. |
Source de données | Source de connexion utilisée pour la requête ; les connexions standard sont BBLEARN, CMSDOC et BBSTATS. |
Modifier | Un lien pour modifier la requête. |
Supprimer | Un lien pour supprimer la requête. |
Exporter | Lien permettant d'exporter la définition de la requête sous forme de fichier texte JSON. |
L'outil Créer une définition de requête permet à un utilisateur ayant des connaissances en écriture de requêtes SQL d'écrire et d'enregistrer une requête qu'un utilisateur final peut exécuter pour remplir un rapport. L'outil possède certaines fonctionnalités de sécurité intégrées pour empêcher l'écriture de code malveillant (par exemple, vous ne pouvez pas l'utiliser pour mettre à jour les données Blackboard), mais vous êtes toujours en train d'écrire du code SQL pour l'exécuter sur une base de données. Gardez cela à l'esprit lorsque vous développez des requêtes, car vous pourriez écrire une mauvaise requête et faire tomber votre système en panne. L'outil est simple, mais il a de la puissance.
Les requêtes erronées consommeront les ressources de la base de données et feront tomber votre système en panne. On ne le dira jamais assez. Vous pouvez écrire une requête sur la base de données de transactions Blackboard qui affectera les performances du système. La meilleure pratique consiste à développer une requête à l'aide d'un autre outil sur une base de données hors production (par exemple, Snowflake ou pgAdmin sur une instance de test).
Il n'existe aucun mécanisme permettant d'arrêter une requête sur le serveur une fois qu'elle a été exécutée. C'est une excellente raison de développer sur un autre système et de coller la définition de la requête lorsque vous savez qu'elle fonctionnera correctement.
Pour en savoir plus sur la rédaction de requêtes, rendez-vous sur Anthology Support et connectez-vous. Recherchez l'article 89873 et téléchargez le guide de l'utilisateur du gestionnaire de rapports de la prolongation Reporting Framework.