Fonti dei dati

Introduzione alle fonti di dati

Le origini dati possono essere configurate per rendere disponibili le tabelle o le viste del database nelle SKOOR Dashboard.

Con la versione 7.2 di SKOOR sono state aggiunte nuove funzionalità per creare e modificare le tabelle e i dati in esse contenuti.

Sono supportati i database MySQL e PostgreSQL.

Creazione di una fonte dati

Solo gli utenti amministratori possono creare origini dati

Fare clic sul segno + e aggiungere i parametri di connessione nella scheda Generale:

Fare clic sul pulsante Salva sotto i parametri di connessione per connettersi al database. Se il database è raggiungibile, appare un'icona di stato verde insieme ad alcune schede per ulteriori azioni su questo database:

La scheda "Generale" può essere utilizzata per aggiornare il nome della fonte dati, i parametri di connessione e le impostazioni di timeout. Fare clic su "Salva" per salvare tali modifiche.

Definire gli ambiti dei dati e i permessi di scrittura

Solo gli utenti amministratori possono definire gli ambiti dei dati e i permessi di scrittura

Nella scheda "Permessi" è possibile configurare l'accesso alla fonte dati per utenti o gruppi di utenti.

Gli utenti amministratori sono autorizzati a leggere e modificare tutti i dati di tutte le tabelle

Ambiti dei dati

Questa sezione consente di definire gli ambiti per ciascun utente o gruppo di utenti. Solo i dati che corrispondono all’ambito sono visibili al rispettivo utente o gruppo di utenti. Ciò vale sia per l’anteprima dei dati nella sezione della fonte dati sia per i dashboard.

Le espressioni di discriminazione dell’ambito possono essere semplici valori di stringa oppure operatori descritti nella pagina dell’editor di query della fonte dati.

Esempi di espressioni:

Espressione	Descrizione
1234	Corrisponde a tutte le righe con valore della colonna pari a 1234.
NOT(NULL())	Trova tutte le righe con un valore di colonna diverso da NULL.
GE(0)	Trova tutte le righe in cui il valore della colonna è maggiore o uguale a zero.
foo%	Trova tutte le righe con un valore di colonna che inizia con "foo"

Permessi di scrittura

In generale, ai ruoli utente SKOOR si applicano le seguenti regole:

gli utenti con il ruolo di editor possono leggere tutti i dati da tutte le tabelle
gli utenti con il ruolo di operatore non possono visualizzare No Data

Definire i permessi di scrittura in modo che

consentire agli utenti con il ruolo di "editor" di modificare i dati nelle tabelle selezionate
consentire agli utenti con il ruolo di operatore di leggere e modificare i dati nelle tabelle selezionate

Anteprima di un'origine dati

Nella scheda Dati sono visibili tutte le tabelle, le viste ecc. della fonte dati selezionata. Gli utenti con ruolo "operatore" vedranno solo le tabelle definite dai permessi di scrittura.

Selezionare una voce dai gruppi a sinistra (ad es. Tabelle) per visualizzarne i dati. Fare clic sul nome di una colonna per ordinarla oppure utilizzare il pulsante Attiva/Disattiva filtri sul lato destro per cercare record specifici.

Modifica di un'origine dati

Creare/importare una tabella

Solo gli utenti con ruolo di amministratore possono creare nuove tabelle

È possibile creare nuove tabelle manualmente o durante l’importazione dei dati.

Fare clic sull'icona + accanto al gruppo Tabelle per aprire la finestra di dialogo Aggiungi tabella:

Per definire una tabella manualmente, fare clic sul relativo pulsante "Aggiungi" per aggiungere colonne e indici e definire nomi, tipi di dati, ecc.

Per ulteriori informazioni, consultare la sezione successiva, Modifica schema

Per aggiungere una tabella tramite importazione dei dati, impostare il pulsante di opzione "Colonne" su "Importa":

Fare clic su "Importa da file" e aprire il file Excel (XLSX) o CSV richiesto. Il software SKOOR valuterà ora le colonne e i tipi di dati:

Per garantire che lo stesso file possa essere importato nuovamente in occasione di un futuro caricamento dei dati, i nomi delle colonne non possono essere modificati. Definire un nome per la tabella (per impostazione predefinita, il software utilizza il nome del file), nonché la chiave primaria, gli indici, il tipo di dati e così via, quindi fare clic su «Crea e importa» per avviare la creazione effettiva della tabella e l’importazione dei dati.

Modifica di una tabella esistente

La modifica è consentita solo agli utenti autorizzati; per ulteriori informazioni, consultare "Ambiti dei dati e permessi di scrittura"

Modifica dello schema

Solo gli utenti amministratori possono modificare lo schema di una tabella

Fare clic sull’icona delle opzioni su una voce della tabella per modificarne lo schema:

Utilizza la finestra di dialogo "Modifica tabella" per modificare effettivamente il nome della tabella, la chiave primaria, gli indici o le colonne nel database:

Impostazioni	Descrizione
Nome della tabella	Il nome della tabella
Chiave primaria	Definire una chiave primaria a partire da una o più colonne
Indici	Definire indici a colonna singola o multipla per la tabella corrente
Colonne	Definire il nome della colonna, il tipo di dati e il valore predefinito. Attivare o disattivare l'incremento automatico e specificare se una colonna può contenere valori nulli

Modifica dati

I dati della tabella possono essere modificati, mentre le viste, le viste materializzate ecc. sono di sola lettura.

Basta cliccare su una colonna di un record specifico per modificarne i dati o eliminare un record utilizzando la rispettiva icona del cestino. È possibile apportare più modifiche contemporaneamente; queste saranno contrassegnate da un cambio di colore e dall’opzione "Annulla" a sinistra.

I campi di testo e le aree di testo offrono inoltre la possibilità di impostare il proprio valore su NULL; ciò può essere fatto cliccando sull'icona a forma di X che appare quando si passa il mouse su tali campi.

Fare clic su «Salva modifiche» per salvare i dati.

Elimina tabella

Fare clic sull’icona delle opzioni su una voce della tabella e selezionare “Elimina” per eliminarla.

Esportazione/Importazione nelle fonti dati

Esportazione dei dati

È possibile esportare i dati in un file CSV facendo clic sul pulsante "Esporta". Il file risultante conterrà solo i dati visualizzati nell'anteprima, il che significa che verranno applicati gli ambiti definiti.

I dati verranno esportati con codifica UTF-8

Importazione dei dati

La dimensione del file è limitata a 100 MB per i file CSV e a 2 MB per i file XLSX

È possibile creare tabelle direttamente durante l’importazione dei dati. Per ulteriori dettagli, consultare la sezione “Crea/Importa una tabella”

È possibile importare file Excel (solo in formato XLSX) e file separati da virgola (CSV) per sostituire o aggiornare una tabella. Fare clic sul pulsante "Importa" per aprire la finestra di dialogo:

Per prima cosa, fare clic su "Importa da file" per aprire un file. Successivamente, selezionare una delle seguenti modalità di importazione:

INSERT: inserisce tutti i record dal file. I duplicati vengono inseriti se la definizione della tabella lo consente
UPSERT: inserisce tutti i record dal file. Se un record esiste già, verrà aggiornato. In questo caso è necessario definire una chiave primaria sulla tabella
REPLACE: i dati esistenti verranno troncati prima del caricamento dei dati dal file

Creazione di una fonte dati script (obsoleta)

Le origini dati script sono deprecate e se ne sconsiglia l’uso

Se il tipo di origine dati viene modificato in SCRIPT, i parametri di configurazione cambiano. Ora è possibile configurare uno script insieme a tutti i parametri necessari per generare un output adatto alle SKOOR Dashboard.

L'output dello script deve essere formattato in JSON

Parametro	Descrizione
Nome	Nome della fonte dati. Questo nome sarà disponibile nelle impostazioni del widget quando il tipo di ricerca è impostato su dataSource. La tabella sarà sempre impostata su STDOUT:
Eseguibile di recupero	Percorso completo del programma o dello script che genera i dati. Questo programma deve essere disponibile sul sistema in cui è installato il servizio web SKOOR
Argomenti di recupero	Argomenti della riga di comando del programma, un argomento per riga. È possibile passare allo script sia i parametri impostati nel widget di destinazione sia gli argomenti inseriti direttamente in questo campo. Esempio: il parametro URL "display" è configurato come "Query di ricerca" in un widget tabella: Lo stesso parametro può ora essere passato allo script della fonte dati insieme ad altri argomenti, ad esempio il valore "123":
Puntatore al risultato del recupero	Se nelle dashboard è necessario solo un sottoinsieme della stringa JSON risultante dal programma, è necessario impostare un puntatore JSON. La seguente stringa JSON di esempio è generata da un programma (formattata per facilitarne la lettura): { "host": "myhost", "filesystems": [ { "size": "51G", "used": "22G", "available": "27G", "usedp": "46%", "mountpoint": "/" }, { "size": "17G", "used": "45M", "available": "16G", "usedp": "1%", "mountpoint": "/home" } ] } In una dashboard verrà visualizzato solo l’array "filesystems". Pertanto, il puntatore JSON "/filesystems" deve essere impostato come puntatore del risultato di recupero: Se si desidera visualizzare tutti gli oggetti di una stringa JSON, impostare il puntatore del risultato di recupero su "/".
Eseguibile distinto	Se si utilizza una fonte dati script per un widget a matrice di filtri, sarà necessario un array JSON con valori univoci. Lo script o il programma configurato qui deve restituire un array di questo tipo
Argomenti distinti	Vedi argomenti di recupero
Puntatore al risultato distinto	Vedi puntatore al risultato di recupero
Colonne	I campi JSON dell'output dello script devono essere configurati come colonne per essere disponibili come tali nei widget della dashboard