Introduction aux sources de données

Les sources de données peuvent être configurées pour rendre les tables ou les vues de base de données disponibles dans les SKOOR Dashboards.

Avec la version 7.2 de SKOOR, de nouvelles fonctionnalités ont été ajoutées pour créer et modifier des tables ainsi que leurs données.

Les bases de données MySQL et PostgreSQL sont prises en charge.

Créer une source de données

Seuls les utilisateurs administrateurs peuvent créer des sources de données

Cliquez sur le signe « + » et ajoutez les paramètres de connexion dans l'onglet « Général » :

Cliquez sur le bouton « Enregistrer » situé sous les paramètres de connexion pour vous connecter à la base de données. Si la base de données est accessible, une icône d'état verte s'affiche, accompagnée de plusieurs onglets permettant d'effectuer d'autres actions sur cette base de données :

L'onglet « Général » permet de modifier le nom de la source de données, les paramètres de connexion et les paramètres de délai d'expiration. Cliquez sur « Enregistrer » pour valider ces modifications.

Définir les portées de données et les autorisations d'écriture

Seuls les utilisateurs administrateurs peuvent définir des périmètres de données et des autorisations d'écriture

Dans l’onglet « Autorisations », vous pouvez configurer l’accès des utilisateurs ou des groupes d’utilisateurs à la source de données.

Les utilisateurs administrateurs sont autorisés à lire et à modifier toutes les données de toutes les tables

Portées de données

Cette section permet de définir des portées pour chaque utilisateur ou groupe d’utilisateurs. Seules les données correspondant à la portée sont visibles par l’utilisateur ou le groupe d’utilisateurs concerné. Cela s’applique aussi bien à l’aperçu des données dans la section « Source de données » qu’aux tableaux de bord.

Les expressions de discrimination de périmètre peuvent être des chaînes de caractères simples ou des opérateurs décrits sur la page de l'éditeur de requêtes de la source de données.

Exemples d’expressions :

Expression	Description
1234	Correspond à toutes les lignes dont la valeur de la colonne est égale à 1234.
NOT(NULL())	Recherche toutes les lignes dont la valeur de la colonne est différente de NULL.
GE(0)	Recherche toutes les lignes dont la valeur de la colonne est supérieure ou égale à zéro.
foo%	Correspond à toutes les lignes dont la valeur de la colonne commence par « foo »

Droits d’écriture

En général, les règles suivantes s'appliquent aux rôles utilisateur SKOOR :

les utilisateurs disposant du rôle « éditeur » peuvent lire toutes les données de toutes les tables
les utilisateurs ayant le rôle « opérateur » ne peuvent voir No Data

Définissez les autorisations d'écriture pour

permettre aux utilisateurs ayant le rôle « éditeur » de modifier les données dans les tables sélectionnées
permettre aux utilisateurs ayant le rôle d’opérateur de lire et de modifier les données dans les tables sélectionnées

Prévisualiser une source de données

Dans l'onglet « Données », toutes les tables, vues, etc. de la source de données sélectionnée sont visibles. Les utilisateurs ayant le rôle « Operateur » ne verront que les tables définies par les autorisations d'écriture.

Sélectionnez un élément parmi les groupes situés à gauche (par exemple « Tables ») pour afficher ses données. Cliquez sur le nom d'une colonne pour la trier ou utilisez le bouton « Basculer les filtres » situé à droite pour rechercher des enregistrements spécifiques.

Modifier une source de données

Créer/importer une table

Seuls les utilisateurs administrateurs peuvent créer de nouvelles tables

Les nouvelles tables peuvent être créées manuellement ou lors d’une importation de données.

Cliquez sur l'icône + à côté du groupe « Tables » pour ouvrir la boîte de dialogue « Ajouter une table » :

Pour définir une table manuellement, cliquez sur le bouton « Ajouter » correspondant afin d’ajouter des colonnes et des index, et de définir les noms, les types de données, etc.

Pour plus d’informations, consultez la section suivante, « Modifier le schéma »

Pour ajouter une table via une importation de données, sélectionnez l'option « Importer » dans le menu radio « Colonnes » :

Cliquez sur « Importer depuis un fichier » et ouvrez le fichier Excel (XLSX) ou CSV requis. Le logiciel SKOOR va alors analyser les colonnes et les types de données :

Pour garantir que le même fichier puisse être réimporté lors d’un prochain chargement de données, les noms de colonnes ne doivent pas être modifiés. Définissez un nom de table (par défaut, le logiciel reprend le nom du fichier) ainsi que la clé primaire, les index, le type de données, etc., puis cliquez sur « Créer et importer » pour lancer la création de la table et l’importation des données.

Modifier une table existante

La modification n’est autorisée que pour les utilisateurs habilités. Pour plus d’informations, consultez la section « Portées des données et droits d’écriture ».

Modifier le schéma

Seuls les utilisateurs administrateurs peuvent modifier le schéma d’une table

Cliquez sur l’icône des options d’un élément de table pour modifier son schéma :

Utilisez la boîte de dialogue « Modifier la table » pour modifier le nom de la table, la clé primaire, les index ou les colonnes dans la base de données :

Paramètres	Description
Nom de la table	Nom de la table
Clé primaire	Définir une clé primaire à partir d'une ou plusieurs colonnes
Index	Définir des index à une ou plusieurs colonnes pour la table actuelle
Colonnes	Définissez le nom de la colonne, son type de données et sa valeur par défaut. Activez ou désactivez l'incrémentation automatique et indiquez si une colonne peut contenir des valeurs nulles

Modifier les données

Les données de la table peuvent être modifiées, tandis que les vues, les vues matérialisées, etc. sont en lecture seule.

Il suffit de cliquer dans une colonne d’un enregistrement spécifique pour modifier ses données ou de supprimer un enregistrement à l’aide de l’icône de corbeille correspondante. Plusieurs modifications peuvent être effectuées simultanément ; elles seront signalées par un changement de couleur et une option « Annuler » située à gauche.

Les champs de texte et les zones de texte offrent en outre la possibilité de définir leur valeur sur NULL ; pour ce faire, cliquez sur l’icône « X » qui apparaît lorsque vous survolez un tel champ.

Cliquez sur « Enregistrer les modifications » pour valider les données.

Supprimer une table

Cliquez sur l’icône des options d’un élément de la table et sélectionnez « Supprimer » pour le supprimer.

Exportation/importation dans les sources de données

Exporter des données

Les données peuvent être exportées vers un fichier CSV en cliquant sur le bouton « Exporter ». Le fichier obtenu ne contiendra que les données affichées dans l'aperçu, ce qui signifie que les plages définies sont appliquées.

Les données seront exportées au format UTF-8.

Importer des données

La taille du fichier est limitée à 100 Mo pour les fichiers CSV et à 2 Mo pour les fichiers XLSX

Il est possible de créer des tableaux directement lors de l'importation des données. Consultez la section « Créer/Importer un tableau » pour plus de détails

Les fichiers Excel (format XLSX uniquement) et les fichiers séparés par des virgules (CSV) peuvent être importés pour remplacer ou mettre à jour un tableau. Cliquez sur le bouton « Importer » pour ouvrir la boîte de dialogue :

Commencez par cliquer sur « Importer depuis un fichier » pour ouvrir un fichier. Sélectionnez ensuite l'un des modes d'importation suivants :

INSERT : insère tous les enregistrements du fichier. Les doublons sont insérés si la définition de la table le permet
UPSERT : insère tous les enregistrements du fichier. Si un enregistrement existe déjà, il sera mis à jour. Une clé primaire doit être définie sur la table dans ce cas
REPLACE : les données existantes seront tronquées avant le chargement des données du fichier

Créer une source de données de script (obsolète)

Les sources de données de type « Script » sont obsolètes et leur utilisation est déconseillée

Si le type de source de données est modifié en SCRIPT, les paramètres de configuration changent. Désormais, un script peut être configuré avec tous les paramètres nécessaires pour générer une sortie adaptée aux SKOOR Dashboard.

La sortie du script doit être au format JSON

Paramètre	Description
Nom	Nom de la source de données. Ce nom sera disponible dans les paramètres du widget lorsque le type de recherche est défini sur « dataSource ». Le paramètre « Table » sera toujours défini sur « STDOUT » :
Exécutable de récupération	Chemin d'accès complet vers le programme ou le script qui génère les données. Ce programme doit être disponible sur le système où le service web SKOOR est installé
Arguments de récupération	Arguments de ligne de commande du programme, à raison d’un argument par ligne. Tous les paramètres définis dans le widget cible peuvent être transmis au script, tout comme les arguments définis directement dans ce champ. Exemple : le paramètre URL « display » est configuré comme requête de recherche dans un widget de tableau : Ce même paramètre peut désormais être transmis au script de la source de données, tout comme d’autres arguments, par exemple la valeur « 123 » :
Pointeur de résultat de récupération	Si seul un sous-ensemble de la chaîne JSON résultant du programme est nécessaire dans les tableaux de bord, un pointeur JSON doit être défini. La chaîne JSON suivante est générée par un programme (formatée pour plus de lisibilité) : { "host": "myhost", "filesystems": [ { "size": "51G", "used": "22G", "available": "27G", "usedp": "46%", "mountpoint": "/" }, { "size": "17G", "used": "45M", "available": "16G", "usedp": "1%", "mountpoint": "/home" } ] } Seul le tableau « filesystems » sera affiché sur un tableau de bord. Il faut donc définir le pointeur JSON « /filesystems » comme pointeur de résultat de récupération : Si tous les objets d’une chaîne JSON doivent être affichés, définissez le pointeur de résultat de récupération sur « / ».
Exécutable distinct	Si une source de données de script est utilisée pour un widget de matrice de filtres, un tableau JSON contenant des valeurs uniques sera nécessaire. Le script ou le programme configuré ici doit renvoyer un tel tableau
Arguments distincts	Voir Arguments de récupération
Pointeur de résultat distinct	Voir « Pointeur de résultat de récupération »
Colonnes	Les champs JSON de la sortie du script doivent être configurés en tant que colonnes pour être disponibles en tant que tels dans les widgets du tableau de bord

No Data