Introduzione alle fonti di dati

Le fonti dati possono essere configurate per rendere disponibili tabelle o viste del database nei SKOOR Dashboard.

Con la versione 7.2 di SKOOR sono state aggiunte nuove funzionalità per creare e modificare tabelle e dati delle tabelle.

Sono supportati i database MySQL e PostgreSQL.

Creare una fonte di 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, viene visualizzata 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 dell'origine dati, i parametri di connessione e le impostazioni di timeout. Fare clic su Salva per salvare le 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 degli utenti o dei gruppi di utenti all'origine dati.

Gli utenti amministratori possono leggere e modificare tutti i dati di tutte le tabelle

Ambito 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 dell'origine dati che per i dashboard.

Le espressioni discriminanti dell'ambito possono essere valori stringa semplici o operatori descritti nella pagina dell'editor di query dell'origine dati.

Esempi di espressioni:

Espressione	Descrizione
1234	Corrisponde a tutte le righe con valore della colonna uguale a 1234.
NOT(NULL())	Corrisponde a tutte le righe con valore della colonna diverso da NULL.
GE(0)	Corrisponde a tutte le righe con valore della colonna maggiore o uguale a zero.
foo%	Corrisponde a tutte le righe con valore della colonna che inizia con "foo"

Autorizzazioni 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 per

consentire agli utenti con il ruolo di editore 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. dell'origine dati selezionata. Gli utenti con il ruolo di operatore vedranno solo le tabelle definite dai permessi di scrittura.

Selezionare un elemento dai gruppi a sinistra (ad esempio 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 amministratori possono creare nuove tabelle

Le nuove tabelle possono essere create manualmente o insieme a un'importazione di 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 pulsante Aggiungi corrispondente 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 con un'importazione di 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 con un futuro caricamento di 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 autorizzazioni di scrittura

Modifica dello schema

Solo gli utenti amministratori possono modificare lo schema di una tabella

Fare clic sull'icona delle opzioni su un elemento 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 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 se una colonna è nullable

Modifica dati

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

È sufficiente cliccare su una colonna di un record specifico per modificare i suoi dati o eliminare un record utilizzando la rispettiva icona del cestino. È possibile apportare diverse modifiche contemporaneamente, che saranno contrassegnate da un cambiamento di colore e da un'opzione di annullamento sulla sinistra.

I campi di testo e le aree di testo hanno inoltre la possibilità di impostare il loro valore su NULL, cliccando sull'icona X che appare quando si passa il mouse su tali campi.

Fare clic su Salva modifiche per mantenere i dati.

Elimina tabella

Fare clic sull'icona delle opzioni su un elemento della tabella e selezionare Elimina per eliminarlo.

Esporta/Importa nelle origini dati

Esporta dati

I dati possono essere esportati in un file CSV facendo clic sul pulsante Esporta. Il file risultante conterrà solo i dati visualizzati nell'anteprima, il che significa che vengono applicati gli ambiti definiti.

I dati saranno esportati con codifica UTF-8

Importare 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 Creare/Importare una tabella

È possibile importare file Excel (solo 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, clicca su Importa da file per aprire un file. Successivamente, seleziona una delle seguenti modalità di importazione:

INSERISCI: inserisce tutti i record dal file. Se la definizione della tabella lo consente, vengono inseriti i duplicati
UPSERT: inserisce tutti i record dal file. Se un record esiste già, verrà aggiornato. In questo caso, è necessario definire una chiave primaria nella tabella
SOSTITUISCI: i dati esistenti verranno troncati prima che i dati vengano caricati dal file

Creare un'origine dati script (obsoleta)

Le origini dati script sono obsolete 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 dell'origine dati. Questo nome sarà disponibile nelle impostazioni del widget quando il tipo di ricerca è impostato su dataSource. La tabella sarà sempre impostata su STDOUT:
Recupera eseguibile	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
Recupera argomenti	Argomenti della riga di comando del programma, un argomento per riga. Qualsiasi parametro impostato nel widget di destinazione può essere passato allo script, così come gli argomenti impostati 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 dell'origine dati insieme ad altri argomenti, ad esempio il valore "123":
Puntatore al risultato	Se nei dashboard è necessario solo un sottoinsieme del risultato della stringa JSON del 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" } ] } Solo l'array dei file system verrà visualizzato su un dashboard. Pertanto, il puntatore JSON /filesystems deve essere impostato come puntatore di recupero dei risultati: Se si desidera visualizzare tutti gli oggetti di una stringa JSON, impostare il puntatore del risultato di recupero su "/".
Eseguibile distinto	Se si utilizza un'origine dati script per un widget matrice filtro, sarà necessario un array JSON con valori univoci. Lo script o il programma configurato qui deve restituire un array di questo tipo
Argomenti distinti	Vedere argomenti di recupero
Puntatore di risultato distinto	Vedi puntatore del risultato di recupero
Colonne	I campi JSON dell'output dello script devono essere configurati come colonne per essere disponibili come tali nei widget del dashboard

Documentazione

Fonti dei dati