DocumentationNo Data
Cette section n'est disponible que pour les utilisateurs ayant des privilèges d'administrateur.
Dans ce guide :
Notions de base sur les requêtes Data
Les requêtes de données permettent de préparer des données provenant de bases de données externes en vue de leur utilisation dans des tableaux de bord.
Les Data Queries présentent les avantages suivants :
Développement et test de requêtes SQL directement dans la section d'administration de SKOOR Dashboard.
La performance du tableau de bord peut être augmentée
par l'utilisation de paramètres, ce qui conduit à des ensembles de résultats plus petits provenant des bases de données
par l'utilisation de la fonctionnalité Materialize 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 les anciennes versions publiées peuvent être réutilisées.
Sauter directement aux tableaux de bord consommant une requête de données et de ces tableaux de bord à la requête de données.
Voir Exemples de requêtes de données pour quelques exemples utiles.
Si vous souhaitez utiliser les Data Queries avec Filtrer Matrix, consultez les détails dans : Filtrer Matrix et les Data Queries
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 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 pour l'ensemble du système.
La fenêtre Créer une requête de données s'affiche, dans laquelle le nom de la requête de données et la source de données qu'elle utilise doivent être définis.
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 sera utilisée dans les tableaux de bord :
Les requêtes peuvent être testées directement en cliquant sur le bouton Exécuter la requête dans la partie 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 des résultats. En cas d'erreur, des conseils ou des messages seront affichés dans l'éditeur ou au-dessus.
La nouvelle requête est maintenant 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'affecteront aucun tableau de bord.
Les versions publiées d'une requête sont marquées dans le menu déroulant de la version. Survolez le point d'interrogation pour voir la note de publication donnée au moment de la publication :
La publication réussie d'une No Data Query supprime automatiquement toutes les versions non publiées de cette requête jusqu'au point de publication.
Les versions publiées précédemment 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 l'ensemble des résultats de la requête dès que celle-ci sera publiée. Cela augmentera considérablement les performances de l'accès aux données à partir des tableaux de bord. La création d'index des attributs clés de la base de données est toujours une bonne idée.
Supprimer des requêtes Data
Cliquez sur les trois points 
d'un groupe ou d'une requête et cliquez sur Supprimer.
Déplacer des requêtes de données
Les requêtes peuvent être déplacées entre les groupes par glisser-déposer.
Dupliquer les requêtes de données
Les requêtes peuvent être copiées facilement 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 tapant le nouveau nom dans le champ Nom .
Cela créera une nouvelle version de la requête de données et la publication est nécessaire pour voir le nouveau nom dans les tableaux de bord.
Lorsque vous renommez une Data Query qui est imbriquée dans d'autres Data Queries, le changement de nom se propagera à toutes les requêtes dépendantes. Cette propagation se traduira par de nouvelles versions de ces requêtes dépendantes, ce qui les rendra prêtes à être publiées.
Liste des paramètres de 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. |
Accessible à partir des 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 de la requête | Les versions précédemment publiées d'une requête peuvent être réactivées/publiées si nécessaire. |
Publier | Mettre la requête actuelle à la disposition 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 d'éléments spécifiques qui, lorsqu'ils sont cliqués, permettent d'accéder au tableau de bord correspondant. |
Matérialiser | Créer des objets de base de données pour mettre en cache l'ensemble des résultats de la requête afin d'améliorer les performances du tableau de bord. |
Indices | Sélectionnez les attributs clés de la base de données pour lesquels SKOOR doit créer des index. |
Rafraîchir maintenant | Actualiser le cache de l'ensemble des résultats (données matérialisées) |
Copier le lien d'actualisation | Copier le lien de la requête matérialisée actuelle. Un job SKOOR peut être créé pour effectuer des rafraîchissements en utilisant ce lien. |
Exécuter la requête | Exécute et enregistre la requête SQL et affiche l'ensemble de résultats dans la section Aperçu des données. |
Basculer les filtres | Active ou désactive 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 de données peuvent être interrogées ou jointes de la même manière que d'autres tables ou vues de la base de données. La version des requêtes de données sous-jacentes sera rattachée à la version actuelle afin que les modifications n'entraînent pas un comportement inattendu. Lorsqu'une nouvelle version d'une requête de données est créée, les requêtes sous-jacentes sont également mises à jour.
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
Exportation
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.
Dialogue d'exportation :
Pour terminer l'exportation, copiez la chaîne d'exportation ou téléchargez-la au format JSON. Cochez la case Plain JSON 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 Data Queries
Sur le système cible, les sources de données configurées dans les requêtes de données doivent exister.
Les champs d'application des données et les droits 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 est inédite ou une version publiée différente, la requête importée du même nom sera ajoutée en tant que version mineure inédite
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 en cochant la case Inclure les versions non publiées.
Une nouvelle version mineure non publiée de chaque requête importée sera créée sur le système cible.
Importer
Sélectionnez Importer des 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 Périmètres des autorisations et des données de DataSource permet d'importer facultativement les périmètres des autorisations et des données.
Si les actions sont OK, cliquez sur Importer des requêtes de données.