DocumentationNo Data
Cette section est réservée aux utilisateurs disposant de privilèges d'administrateur.
Principes de base des requêtes de données
Les requêtes de données permettent de préparer les données provenant de bases de données externes en vue de leur utilisation dans des tableaux de bord.
Les requêtes de données présentent les avantages suivants :
Développement et test des requêtes SQL directement dans la section d'administration du SKOOR Dashboard
Les performances du tableau de bord peuvent être améliorées
grâce à l'utilisation de paramètres qui permettent d'obtenir des ensembles de résultats plus petits à partir des bases de données
grâce à l'utilisation de la fonction Materialize qui gère automatiquement une table de mise en cache des résultats de la requête dans la base de données
Les requêtes de données imbriquées sont possibles
Les versions des requêtes peuvent être publiées, les anciennes versions publiées peuvent être réutilisées.
Accédez directement aux tableaux de bord utilisant une requête de données et, à partir de ces tableaux de bord, revenez à la requête de données
Consultez les exemples de requêtes de données pour obtenir des exemples utiles.
Si vous souhaitez utiliser les requêtes de données avec Filter Matrix, consultez les détails dans : Filter Matrix & Data Queries
Créer des requêtes de données
Au moins une source de données doit être configurée dans SKOOR pour pouvoir être utilisée avec les requêtes de données.
Cliquez sur les trois points en haut à gauche de l'écran pour ajouter un nouveau groupe de requêtes ou ajoutez simplement une requête de données au groupe par défaut :
Les noms des requêtes de données doivent être uniques à l'échelle du système
La fenêtre Créer une requête de données s'affiche. Vous devez y définir le nom de la requête de données et la source de données qu'elle utilise.
Après avoir cliqué sur Créer, la requête de données s'affiche.
Saisissez une requête SQL dans le champ Requête. Cochez la case Accessible depuis les tableaux de bord si la requête de données doit être utilisée dans les tableaux de bord :
Les requêtes peuvent être testées directement en appuyant sur le bouton Exécuter la requête situé à droite de l'éditeur. Cliquez sur Basculer les filtres pour activer et utiliser les filtres afin de rechercher des enregistrements spécifiques dans l'ensemble de résultats. En cas d'erreurs, des conseils ou des messages s'affichent dans l'éditeur ou au-dessus.
La nouvelle requête est désormais prête à être publiée.
Publier des requêtes de données
Les requêtes peuvent être publiées en cliquant sur le bouton Publier, comme indiqué ci-dessous. Les versions non publiées d'une requête n'auront aucune incidence sur les tableaux de bord.
Les versions publiées d'une requête sont marquées dans le menu déroulant des versions. Passez la souris sur le point d'interrogation pour voir la note de publication donnée au moment de la publication :
La publication réussie d'une requête de données supprimera automatiquement toutes les versions non publiées de cette requête jusqu'au moment de la publication.
Les versions précédemment publiées ne sont pas affectées.
Matérialiser les requêtes de données
Si la case Matérialiser est cochée, des objets de base de données seront créés pour stocker le jeu de résultats de la requête dès que celle-ci sera publiée. Cela améliorera considérablement les performances d'accès aux données à partir des tableaux de bord. Il est toujours judicieux de créer des index des attributs clés de la base de données.
Supprimer les requêtes de données
Cliquez sur les trois points
d'un groupe ou d'une requête, puis cliquez sur Supprimer.
Déplacer les requêtes de données
Les requêtes peuvent être déplacées d'un groupe à l'autre par glisser-déposer.
Dupliquer des requêtes de données
Les requêtes peuvent être facilement copiées en cliquant sur Dupliquer dans le menu contextuel.
Renommer les requêtes de données
Lorsqu'une requête de données est ouverte, son nom peut être facilement modifié en saisissant le nouveau nom dans le champ Nom.
Cela créera une nouvelle version de la requête de données et il faudra la publier pour voir le nouveau nom dans les tableaux de bord.
Lorsque vous renommez une requête de données imbriquée dans d'autres requêtes de données, le changement de nom se répercute sur toutes les requêtes dépendantes. Cette répercussion entraîne la création de nouvelles versions de ces requêtes dépendantes, qui sont alors prêtes à être publiées.
Liste des paramètres dans la requête de données
Paramètre | Description |
|---|---|
Créer un groupe | Ajouter des groupes pour les requêtes associées |
Ajouter une requête de données | Ajouter une nouvelle requête à un groupe |
Nom | Nom de la requête de données. Ce nom peut également être utilisé pour les requêtes de données imbriquées |
Source de données | Nom de la source de données utilisée pour cette requête de données |
Accessible depuis les tableaux de bord | Les requêtes de données peuvent être sélectionnées à partir des widgets des tableaux de bord lorsque cette case est cochée |
Requête | Requête en langage SQL |
Historique des requêtes | Les versions précédemment publiées d'une requête peuvent être réactivées/publiées si nécessaire |
Publier | Rendre la requête actuelle disponible pour d'autres requêtes de données ou tableaux de bord. Les requêtes non publiées n'ont aucune incidence sur les données affichées dans les tableaux de bord |
Dépendances | Affiche les sous-requêtes, les requêtes et les tableaux de bord qui utilisent la requête de données actuelle. En passant la souris dessus, une liste des éléments spécifiques s'affiche. En cliquant dessus, vous accédez au tableau de bord correspondant. |
Matérialiser | Créez des objets de base de données pour mettre en cache le jeu de résultats de la requête afin d'améliorer les performances du tableau de bord. |
Index | Sélectionnez les attributs clés de la base de données pour lesquels SKOOR doit créer des index. |
Actualiser maintenant | Actualiser le cache des résultats (données matérialisées) |
Copier le lien d'actualisation | Copiez le lien de la requête matérialisée actuelle. Une tâche SKOOR peut être créée pour effectuer des actualisations à l'aide de ce lien |
Exécuter la requête | Exécute et enregistre la requête SQL et affiche le jeu de résultats dans la section Aperçu des données |
Activer/désactiver les filtres | Activez ou désactivez les champs de filtre sous les colonnes de l'ensemble de résultats pour rechercher des enregistrements spécifiques. |
Requêtes imbriquées
Les données provenant d'autres requêtes peuvent être interrogées ou jointes de la même manière que les autres tables ou vues de la base de données. La version des requêtes sous-jacentes sera épinglée à la version actuelle afin que les modifications n'entraînent pas de comportement inattendu. Lorsqu'une nouvelle version d'une requête est créée, les requêtes sous-jacentes seront également définies sur leur version la plus récente.
La requête de données suivante sélectionne un sous-ensemble de la requête de données get_sales_data :
La dépendance entre les requêtes de données get_sales_data et get_tech_sales est visible en haut à droite des deux écrans de requête de données :
Requête get_tech_sales :
Requête get_sales_data :
Veillez à toujours vérifier les dépendances avant de modifier et de publier des requêtes
Exportation et importation
Export
Les groupes de requêtes de données peuvent être exportés depuis et importés vers n'importe quel système SKOOR. Cela permet l'échange de requêtes, par exemple entre les systèmes de test et de production.
Boîte de dialogue d'exportation :
Pour terminer l'exportation, copiez la chaîne d'exportation ou téléchargez-la au format JSON. Cochez la case « JSON simple » pour lire la chaîne d'exportation au format JSON.
Les éléments suivants doivent être pris en compte lors de l'exportation/importation de requêtes de données
Les sources de données configurées dans les requêtes de données doivent exister sur le système cible.
Les champs d'application des données et les autorisations d'écriture de la source de données utilisée sont exportés/importés avec la requête de données. Pour que l'importation réussisse, tous les utilisateurs/groupes d'utilisateurs utilisés dans les paramètres doivent être disponibles dans le système cible. (Cette option peut être désactivée lors de l'importation).
Les requêtes de données seront mises à jour par les requêtes importées portant le même nom, quel que soit le groupe auquel elles appartiennent.
Les numéros de version des requêtes sur les systèmes source et cible ne correspondent pas nécessairement, ils sont augmentés indépendamment.
Requêtes publiées
Par défaut, la dernière version publiée de chaque requête de données d'un groupe sera exportée.
Sur le système cible, les opérations suivantes seront effectuées lors de l'importation :
Si la dernière version d'une requête n'est pas publiée ou s'il s'agit d'une version publiée différente, la requête importée du même nom sera ajoutée en tant que version Minor non publiée.
Si la dernière version publiée est identique à celle importée, une nouvelle version publiée de la requête sera ajoutée.
Requêtes non publiées
Pour exporter les dernières modifications non publiées, exportez le groupe requis en cochant la case Inclure les versions non publiées.
Une nouvelle version Minor non publiée de chaque requête importée sera créée sur le système cible.
Importer
Sélectionnez Importer les requêtes de données dans le menu contextuel de Requêtes de données ou d'un groupe de requêtes de données spécifique.
Collez la chaîne exportée dans le champ correspondant de la boîte de dialogue d'importation. Après validation, les actions d'importation seront décrites à l'écran :
Le drapeau « Autorisations et champs d'application des données de la source de données » permet d'importer facultativement les autorisations et les champs d'application des données.
Si les actions sont OK, cliquez sur Importer les requêtes de données.