Cette section n'est disponible que pour les utilisateurs ayant des privilèges d'administrateur.

Dans ce guide :

Notions de base sur les Data Queries
Requêtes imbriquées
Exportation et importation
- Exporter
  - Requêtes publiées
  - Requêtes non publiées
- Importer

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.

Paramètre	Description
Message	Le message à afficher. Prend en charge les caractères génériques.
Type de recherche

Légende de corrélation

Modification du widget de légende de corrélation