Requêtes de données

Avec Data Queries , les données de bases de données externes peuvent être préparées pour être utilisées dans des tableaux de bord.

  • Développement et test de requêtes SQL directement dans la section d'administration SKOOR Dashboard

  • Les performances du tableau de bord peuvent être augmentées

    • par l'utilisation de paramètres qui conduit à des ensembles de résultats plus petits à partir des bases de données

    • par l'utilisation de la fonctionnalité Materialise qui maintient automatiquement une table de mise en cache du résultat de la requête sur la base de données

  • Les requêtes de données imbriquées sont possibles

  • Les versions des requêtes peuvent être publiées et annulées

Cette section n'est disponible que pour les utilisateurs disposant de privilèges d'administrateur

Voir Exemples de requête de données pour quelques exemples utiles.

Créer des requêtes de données

Au moins une source de données doit être configurée dans SKOOR pour être utilisée avec des requêtes de données.

Cliquez sur le signe + 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 de requête de données doivent être uniques à l'échelle du système

Sélectionnez la source de données dans le menu déroulant respectif et 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 sera 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 sur le côté droit de l'éditeur. Cliquez sur Basculer les filtres pour activer et utiliser des filtres pour rechercher des enregistrements spécifiques dans le jeu de résultats. En cas d'erreurs, des conseils ou des messages seront affichés dans l'éditeur ou au-dessus.

Dès que la requête est prête à être utilisée dans un tableau de bord, elle peut être publiée. Les versions non publiées d'une requête n'affecteront aucun tableau de bord.

Les versions publiées d'une requête sont marquées dans la liste déroulante des versions. Survolez le point d'interrogation pour voir la description donnée au moment de la publication :

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 la requête sera publiée. Cela augmentera considérablement les performances d'accès aux données des tableaux de bord. C'est toujours une bonne idée de créer des index des attributs clés de la base de données.

Paramètre

Description

Ajouter un groupe

Ajouter des groupes pour les requêtes associées

Ajouter une requête

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

La 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

Mettre en doute

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'affectent pas 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. Le survol de la souris affiche une liste des éléments spécifiques

Se concrétiser

Créer des objets de base de données pour mettre en cache le jeu de résultats de la requête afin d'augmenter les performances du tableau de bord

Indices

Sélectionner les principaux attributs de la base de données SKOOR devrait créer des index pour

Actualiser maintenant

Actualiser le cache de l'ensemble de résultats (données matérialisées)

Copier le lien d'actualisation

Copiez le lien de la requête matérialisée en cours. 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

Basculer les filtres

Activer ou désactiver les champs de filtre sous les colonnes du jeu de résultats pour rechercher des enregistrements spécifiques

Supprimer des requêtes ou des groupes

Cliquez sur l'icône d'engrenage d'un groupe ou d'une requête et cliquez sur Supprimer .

Déplacer les requêtes entre les groupes

Les requêtes peuvent être déplacées entre les groupes par glisser-déposer.

Requêtes en double

Les requêtes peuvent être copiées facilement en cliquant sur Dupliquer dans le menu contextuel.

Requêtes imbriquées

Les données d'autres requêtes de données peuvent être interrogées ou jointes de la même manière que d'autres tables ou vues de base de données. La version des requêtes de données sous-jacentes sera épinglée à la version actuelle, afin que les modifications n'entraînent pas de comportement inattendu. Au moment où une nouvelle version d'une requête de données est créée, les requêtes sous-jacentes seront également définies sur leurs versions les plus récentes.

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 :

Assurez-vous de toujours vérifier les dépendances avant de modifier et de publier des requêtes

Exporter et importer

Les groupes de requêtes de données peuvent être exportés 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 telle quelle ou au format JSON en cochant la case Afficher au format JSON ou en la téléchargeant sous forme de fichier.

Sur le système cible, les sources de données configurées dans les requêtes de données doivent exister

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 est non publiée ou une version publiée différente, la requête importée du même nom sera ajoutée en tant que version mineure non publiée

  • Si la dernière version publiée est la même que 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 avec l'option Inclure les versions non publiées cochée.

Une nouvelle version mineure non publiée de chaque requête importée sera créée sur le système cible.

Importer

Cliquez avec le bouton droit sur un groupe sur le système cible et cliquez sur Importer . Collez la chaîne exportée dans le champ correspondant de la boîte de dialogue d'importation. Après validation, les actions d'import seront décrites à l'écran :

Si les actions sont correctes, cliquez sur Importer des requêtes de données .