DocumentazioneQuery sui dati
Questa sezione è disponibile solo per gli utenti con privilegi di amministratore
Nozioni di base sulle query di dati
Con le query di dati, è possibile preparare i dati provenienti da database esterni per utilizzarli nei dashboard.
Le query di dati presentano i seguenti vantaggi:
Sviluppo e test delle query SQL direttamente nella sezione di amministrazione della SKOOR Dashboard
È possibile aumentare le prestazioni del dashboard
tramite l'uso di parametri che portano a set di risultati più piccoli dai database
tramite l'uso della funzione Materialize, che mantiene automaticamente una tabella di cache dei risultati della query sul database
Sono possibili query di dati nidificate
È possibile pubblicare versioni delle query e riutilizzare le versioni pubblicate in precedenza.
È possibile passare direttamente alle dashboard che utilizzano una query di dati e da tali dashboard tornare alla query di dati
Vedere Esempi di query di dati per alcuni esempi utili.
Se sei interessato a utilizzare le query di dati con Filter Matrix, consulta i dettagli in: Filter Matrix e query di dati
Creare query di dati
Per poter utilizzare le query di dati, è necessario configurare almeno un'origine dati in SKOOR.
Clicca sui tre puntini in alto a sinistra dello schermo per aggiungere un nuovo gruppo di query o aggiungi semplicemente una query di dati al gruppo predefinito:
I nomi delle query di dati devono essere univoci a livello di sistema
Viene visualizzata la finestra Crea query di dati, in cui è necessario impostare il nome della query di dati e l'origine dati utilizzata.
Dopo aver cliccato su Crea, viene visualizzata la query di dati.
Inserire una query SQL nel campo Query. Selezionare la casella Accessibile dai dashboard se la query di dati verrà utilizzata nei dashboard:
Le query possono essere testate direttamente premendo il pulsante Esegui query sul lato destro dell'editor. Fare clic su Attiva/disattiva filtri per abilitare e utilizzare i filtri per cercare record specifici nel set di risultati. In caso di errori, nell'editor o sopra di esso verranno visualizzati suggerimenti o messaggi.
Ora la nuova query è pronta per essere pubblicata.
Pubblicare le query di dati
Le query possono essere pubblicate facendo clic sul pulsante Pubblica come mostrato di seguito. Le versioni non pubblicate di una query non influiranno sulle dashboard.
Le versioni pubblicate di una query sono contrassegnate nel menu a discesa delle versioni. Passa il mouse sul punto interrogativo per visualizzare la nota di pubblicazione fornita al momento della pubblicazione:
La pubblicazione di una query di dati eliminerà automaticamente tutte le versioni non pubblicate di quella query fino al momento della pubblicazione.
Le versioni pubblicate in precedenza non vengono modificate.
Materializza query dati
Se la casella Materializza è selezionata, gli oggetti del database verranno creati per memorizzare il set di risultati della query non appena la query viene pubblicata. Ciò aumenterà in modo significativo le prestazioni di accesso ai dati dai dashboard. È sempre consigliabile creare indici degli attributi chiave del database.
Eliminazione delle query di dati
Fare clic sui tre puntini
di un gruppo o di una query e fare clic su Elimina.
Sposta query dati
Le query possono essere spostate tra i gruppi tramite drag & drop.
Duplicare le query di dati
Le query possono essere copiate facilmente facendo clic su Duplica nel menu contestuale.
Rinominare le query di dati
Quando si apre una query dati, è possibile modificarne facilmente il nome digitando il nuovo nome nel campo Nome.
Questo creerà una nuova versione della query di dati e sarà necessario pubblicarla per vedere il nuovo nome nei dashboard.
Quando si rinomina una query di dati annidata all'interno di altre query di dati, la modifica del nome verrà propagata a tutte le query dipendenti. Questa propagazione darà luogo a nuove versioni di tali query dipendenti, rendendole pronte per la pubblicazione.
Elenco delle impostazioni nella query di dati
Impostazione | Descrizione |
|---|---|
Crea gruppo | Aggiungi gruppi per le query associate |
Aggiungi query dati | Aggiungi nuova query a un gruppo |
Nome | Nome della query dati. Questo nome può essere utilizzato anche per query dati nidificate |
Origine dati | Nome dell'origine dati utilizzata per questa query dati |
Accessibile dai dashboard | Le query di dati possono essere selezionate dai widget delle dashboard quando questa casella è selezionata |
Query | Query in linguaggio SQL |
Cronologia delle query | Le versioni precedentemente pubblicate di una query possono essere riattivate/pubblicate se necessario |
Pubblica | Rendere la query corrente disponibile per altre query di dati o dashboard. Le query non pubblicate non influiscono sui dati visualizzati nelle dashboard |
Dipendenze | Mostra le sottoquery, le query e i dashboard che utilizzano la query di dati corrente. Passando il mouse sopra di esse viene visualizzato un elenco di elementi specifici che, se cliccati, consentono di passare al dashboard corrispondente. |
Materializza | Crea oggetti database per memorizzare nella cache il set di risultati della query e aumentare le prestazioni del dashboard |
Indici | Seleziona gli attributi chiave del database per i quali SKOOR deve creare indici |
Aggiorna ora | Aggiorna la cache dei risultati (dati materializzati) |
Copia link di aggiornamento | Copia il link della query materializzata corrente. È possibile creare un processo SKOOR per eseguire gli aggiornamenti utilizzando quel link |
Esegui query | Esegue e salva la query SQL e visualizza il set di risultati nella sezione Anteprima dati |
Attiva/disattiva i filtri | Attiva o disattiva i campi filtro sotto le colonne del set di risultati per cercare record specifici |
Query nidificate
I dati provenienti da altre query possono essere interrogati o uniti allo stesso modo delle altre tabelle o viste del database. La versione delle query sottostanti verrà fissata a quella corrente in modo che le modifiche non causino comportamenti imprevisti. Nel momento in cui viene creata una nuova versione di una query, anche le query sottostanti verranno impostate sulle loro versioni più recenti.
La seguente query di dati seleziona un sottoinsieme della query di dati get_sales_data:
La dipendenza tra le query di dati get_sales_data e get_tech_sales è visibile in alto a destra in entrambe le schermate delle query di dati:
Query get_tech_sales:
Query get_sales_data:
Assicurarsi di controllare sempre le dipendenze prima di modificare e pubblicare le query
Esportazione e importazione
Esportazione
I gruppi di query di dati possono essere esportati da e importati in qualsiasi sistema SKOOR. Ciò consente lo scambio di query, ad esempio, tra sistemi di test e di produzione.
Finestra di dialogo di esportazione:
Per completare l'esportazione, copia la stringa di esportazione o scaricala in formato JSON. Seleziona la casella di controllo JSON semplice per leggere la stringa di esportazione come JSON.
Quando si esportano/importano query di dati, è necessario tenere presente quanto segue
Nel sistema di destinazione devono essere presenti le origini dati configurate nelle query di dati.
Gli ambiti dei dati e i permessi di scrittura dell'origine dati utilizzata vengono esportati/importati con la query di dati; affinché l'importazione abbia esito positivo, tutti gli utenti/gruppi di utenti utilizzati nelle impostazioni devono essere disponibili nel sistema di destinazione. (Questa opzione può essere disattivata durante l'importazione)
Le query di dati saranno aggiornate dalle query importate con lo stesso nome, indipendentemente dal gruppo a cui appartengono
I numeri di versione delle query sui sistemi di origine e di destinazione non corrispondono necessariamente, ma vengono aumentati in modo indipendente
Query pubblicate
Per impostazione predefinita, verrà esportata l'ultima versione pubblicata di ciascuna query dati di un gruppo.
Sul sistema di destinazione, durante l'importazione verrà eseguita la seguente operazione:
Se l'ultima versione di una query non è pubblicata o è una versione pubblicata diversa, la query importata con lo stesso nome verrà aggiunta come versione Minor non pubblicata
Se l'ultima versione pubblicata è uguale a quella importata, verrà aggiunta una nuova versione pubblicata della query.
Query non pubblicate
Per esportare le ultime modifiche non pubblicate, esportare il gruppo richiesto con l'opzione Includi versioni non pubblicate selezionata.
Nel sistema di destinazione verrà creata una nuova versione Minor non pubblicata di ciascuna query importata.
Importa
Selezionare Importa query dati dal menu contestuale di Query dati o da un gruppo specifico di query dati.
Incolla la stringa esportata nel campo corrispondente della finestra di dialogo di importazione. Dopo la convalida, le azioni di importazione saranno descritte sullo schermo:
Il flag Autorizzazioni e ambiti dati di DataSource viene utilizzato per importare facoltativamente le autorizzazioni e gli ambiti dati.
Se le azioni sono OK, fare clic su Importa query di dati.