Introduction aux sources de données

Les sources de données peuvent être configurées pour rendre les tables ou les vues de la 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 des données de table.

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 sous l'onglet Général :

Cliquez sur le bouton Enregistrer 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 apparaît avec quelques onglets permettant d'effectuer d'autres actions sur cette base de données :

L'onglet Général peut être utilisé pour mettre à jour 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 enregistrer ces modifications.

Définir les champs d'application des données et les autorisations d'écriture

Seuls les utilisateurs administrateurs peuvent définir les champs d'application des données et les 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 des données

Cette section permet de définir des champs d'application pour chaque utilisateur ou groupe d'utilisateurs. Seules les données correspondant au champ d'application sont visibles par l'utilisateur ou le groupe d'utilisateurs concerné. Cela s'applique à l'aperçu des données dans la section source de données ainsi qu'aux tableaux de bord.

Les expressions de discriminateur de portée peuvent être des valeurs de chaîne 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())	Correspond à toutes les lignes dont la valeur de la colonne n'est pas NULL.
GE(0)	Correspond à 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 ».

Autorisations d'écriture

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

les utilisateurs ayant le rôle d'éditeur peuvent lire toutes les données de toutes les tables
les utilisateurs ayant le rôle d'opérateur ne peuvent voir No Data

Définir les autorisations d'écriture pour

permettre aux utilisateurs ayant le rôle d'é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, tous les tableaux, vues, etc. de la source de données sélectionnée sont visibles. Les utilisateurs opérateurs ne verront que les tableaux définis par les autorisations d'écriture.

Sélectionnez un élément dans les groupes à 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 à 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 Table pour ouvrir la boîte de dialogue Ajouter une table :

Pour définir un tableau manuellement, cliquez sur le bouton Ajouter correspondant pour ajouter des colonnes et des index et définir des noms, des types de données, etc.

Pour plus d'informations, consultez la section suivante, Modifier le schéma

Pour ajouter une table avec une importation de données, basculez le bouton radio Colonnes sur Importer :

Cliquez sur Importer à partir du fichier et ouvrez le fichier Excel (XLSX) ou CSV requis. Le logiciel SKOOR évalue alors les colonnes et les types de données :

Pour garantir que le même fichier puisse être importé à nouveau lors d'un futur chargement de données, les noms des colonnes ne peuvent pas être modifiés. Définissez un nom de table (par défaut, le logiciel prend le nom du fichier) ainsi que la clé primaire, les index, le type de données, etc. Cliquez ensuite 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 qu'aux utilisateurs autorisés. Pour plus d'informations, consultez la section Portées des données et autorisations d'écriture

Modifier le schéma

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

Cliquez sur l'icône Options d'un élément de la 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, le type de données et la valeur par défaut. Activez ou désactivez l'augmentation automatique et indiquez si une colonne peut être nulle

Modifier les données

Les données du tableau 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 supprimer un enregistrement à l'aide de l'icône de corbeille correspondante. Plusieurs modifications peuvent être apportées à la fois et seront signalées par un changement de couleur et une option d'annulation à 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 conserver les données.

Supprimer le tableau

Cliquez sur l'icône Options d'un élément du tableau et sélectionnez Supprimer pour le supprimer.

Exporter/Importer 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 champs définis sont appliqués.

Les données seront exportées avec un encodage 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.

Les tableaux peuvent être créés directement lors de l'importation des données. Pour plus d'informations, consultez la section Créer/Importer un tableau.

Les fichiers Excel (format XLSX uniquement) et 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 à partir d'un fichier pour ouvrir un fichier. Sélectionnez ensuite l'un des modes d'importation suivants :

INSERT : insérer tous les enregistrements du fichier. Les doublons sont insérés si la définition du tableau 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 dans le tableau pour ce cas
REPLACE : les données existantes seront tronquées avant que les données ne soient chargées à partir du fichier.

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

Les sources de données de script sont obsolètes et leur utilisation est déconseillée.

Si le type de source de données est changé 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 formatée en 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 tableau sera toujours défini sur STDOUT :
Exécutable de récupération	Chemin d'accès complet au programme ou au 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, un argument par ligne. Tous les paramètres définis dans le widget cible peuvent être transmis au script, ainsi que les arguments définis directement dans ce champ. Exemple : l'affichage du paramètre URL est configuré comme requête de recherche dans un widget de tableau : Le même paramètre peut désormais être transmis au script de la source de données ainsi qu'à d'autres arguments, par exemple la valeur « 123 » :
Récupérer le pointeur de résultat	Si seul un sous-ensemble du résultat de la chaîne JSON 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 des systèmes de fichiers sera affiché sur un tableau de bord. Le pointeur JSON /filesystems doit donc être défini 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 filtrage, un tableau JSON avec des valeurs uniques sera nécessaire. Le script ou le programme configuré ici doit renvoyer un tel tableau
Arguments distincts	Voir les 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 telles dans les widgets du tableau de bord.

No Data