Dati query in un set di query KQL
Questo articolo illustra come usare un set di query KQL. Il set di query KQL è l'elemento usato per eseguire query, visualizzare e personalizzare i risultati delle query sui dati provenienti da origini dati diverse, ad esempio Eventhouse, database KQL e altro ancora.
Il set di query KQL usa il linguaggio di query Kusto (KQL) per la creazione di query e supporta anche molte funzioni SQL. Per altre informazioni sul linguaggio di query, vedere Panoramica del linguaggio di query Kusto.
Prerequisiti
- Un'area di lavoro con una capacità abilitata per Microsoft Fabric
- Un database KQL con autorizzazioni e dati di modifica o uncluster e un database di Esplora dati di Azure con autorizzazioni AllDatabaseAdmin.
Selezionare un'origine dati
Le query vengono eseguite nel contesto di un'origine dati. È possibile modificare l'origine dati associata in qualsiasi momento e conservare le query salvate nell'editor di query. È possibile associare la tua query KQL con più origini dati di tipi diversi, tra cui un database KQL o un'origine dati proveniente da un cluster di Azure Data Explorer.
Selezionare la scheda corrispondente al tipo di origine dati desiderato.
Nel riquadro sul lato sinistro della pagina della query, sotto Explorer e sotto la barra di ricerca, utilizzare il commutatore di database per espandere il menu delle connessioni all'origine dati.
Selezionare Aggiungi origine datie quindi selezionare OneLake data hub.
Nella finestra dell'hub dati OneLake visualizzata selezionare un database KQL per connettersi al set di query KQL e quindi selezionare Connetti. In alternativa, chiudere la finestra dell'hub dati di OneLake e usare il menu + Aggiungi origine dati per connettersi a un'origine dati diversa.
Sotto il nome dell'origine dati viene visualizzato un elenco di tabelle associate a questa origine dati.
Scrivere una query
Ora che si è connessi all'origine dati, è possibile eseguire query su questi dati. L'oggetto Queryset KQL usa il linguaggio di query Kusto (KQL) per interrogare i dati da qualsiasi origine dati a cui hai accesso. Per altre informazioni su KQL, vedere Panoramica del Linguaggio di query Kusto (KQL).
Gli esempi seguenti usano i dati disponibili pubblicamente in https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.
Scrivere o copiare una query nel riquadro superiore del set di query KQL.
Eseguire la query selezionando il pulsante Esegui o premendo Maiusc+Invio.
L'output della query risultante viene visualizzato nella griglia dei risultati, visualizzato sotto il riquadro della query. Si noti il segno di spunta verde che indica che la query è stata completata correttamente e il tempo usato per calcolare i risultati della query.
Interagire con le sorgenti di dati
L'esploratore delle origini dati consente di passare tra le origini dati connesse alla scheda queryset che si sta utilizzando.
Nella parte superiore del riquadro Esplora origini dati, in Explorer è possibile usare la barra di ricerca per cercare un'origine dati specifica. È anche possibile usare il selettore di database sotto la barra di ricerca per espandere il menu delle connessioni delle origini dati. Selezionare l'origine dati da usare. Se il nome della scheda non è stato modificato in precedenza, prende automaticamente il nome dall'origine dati.
Il riquadro Esplora origini dati include due sezioni. La sezione superiore elenca tutti gli elementi nell'origine dati e la sezione inferiore mostra tutte le origini dati disponibili nel set di query.
Elementi nell'origine dati
La sezione superiore dell'esploratore di origini dati mostra tutti gli elementi inclusi nell'origine dati in uso.
- Tabelle
- Visualizzazione materializzata
- Collegamenti
- Funzioni
Selezionare la freccia > a sinistra dell'elemento da espandere. È possibile eseguire il drill-down per visualizzare altri dettagli selezionando la freccia > a sinistra degli elementi nei livelli di elenco successivi. Ad esempio, in Tabelleselezionare la freccia > a sinistra di una tabella per visualizzare l'elenco delle colonne in tale tabella.
Per aprire il menu azione, passare il puntatore del mouse su una voce nell'elenco espanso e selezionare il Altre azioni menu [...]. Il menu mostra le opzioni seguenti:
- Aggiornare il database
- Visualizzare il profilo dati
- Inserisci: per creare e copiare uno script
- Ottenere dati: per aggiungere una nuova origine dati
- Creare un dashboard
- Elimina tabella
Sono disponibili azioni diverse per diversi tipi di elemento.
Origini dati disponibili
La sezione inferiore dell'esploratore di origini dati mostra tutte le fonti di dati disponibili aggiunte al queryset.
Per aprire il menu azione, passare il puntatore del mouse sul nome dell'origine dati e selezionare il Altre azioni menu [...]. Il menu mostra le opzioni seguenti:
- Aggiornare il database
- Usare questo database: passare all'uso di questa origine dati nella scheda corrente
- Query in una nuova scheda: aprire questa origine dati in una nuova scheda nel set di query
- Rimuovi origine: rimuove tutti i database nell'origine dati
- Rimuovi database: rimuove solo il database selezionato
Copia la query
È possibile copiare e condividere le query create.
Nella parte superiore della finestra, selezionare la scheda Home.
Nel riquadro query selezionare Copia query.
Nella tabella seguente vengono illustrate le numerose opzioni per la copia di una query.
Azione Descrizione Copia la query Copiare il testo della query. Collegamento negli Appunti Copiare un deep link che può essere usato per eseguire la query. Collegamento e query negli Appunti Copiare un collegamento che può essere usato per eseguire la query e il testo della query. Collegamento, query e risultati negli Appunti Copiare un collegamento che può essere usato per eseguire la query, il testo della query e i risultati della query. Copiare i risultati Copiare i risultati della query. Selezionare l'azione desiderata dall'elenco.
Incollare queste informazioni per modificarle o condividerle, ad esempio in Microsoft Word, Microsoft Teams o Outlook.
Importante
L'utente che riceve il collegamento alla query deve disporre delle autorizzazioni di visualizzazione per i dati sottostanti per eseguire la query e visualizzare i risultati.
Gestire le schede del set di query
All'interno di un set di query KQL è possibile creare più schede. Ogni scheda nel set di query KQL può essere associata a un database KQL diverso e consente di salvare le query per usarle in un secondo momento o di condividerle con altri per collaborare all'esplorazione dei dati. È anche possibile modificare il database KQL associato a qualsiasi scheda, consentendo di eseguire la stessa query sui dati in database diversi.
È possibile gestire le schede come segue:
- Modificare la connessione all'origine dati esistente: in Explorer e nella barra di ricerca, utilizzare il selettore di database per espandere il menu delle connessioni all'origine dati.
- Rinominare una scheda: accanto al nome della scheda selezionare l'icona a forma di matita .
- Aggiungi una nuova scheda: a destra delle schede esistenti nella barra dei comandi selezionare il segno più +. Schede diverse possono essere collegate a origini dati diverse.
- Altre azioni: Sul lato destro della barra dei comandi, c'è un menu a schede con ulteriori azioni per gestire le varie schede nel tuo set di query.
- Modificare le posizioni delle schede: usare i gesti di trascinamento.
Esporta dati come CSV
Invece di copiare e incollare semplicemente l'output della query, è anche possibile esportare i risultati della query.
Si tratta di un metodo monouso per esportare un file CSV contenente i risultati della query.
Nella parte superiore della finestra, selezionare la scheda Home.
Nel riquadro della query selezionare Esporta in CSV.
Salvare il file CSV in locale.
Eliminare il set di query KQL
Per eliminare il set di query KQL:
Selezionare l'area di lavoro in cui si trova il set di query KQL.
Passare il puntatore del mouse sul set di query KQL da eliminare. Selezionare Altro [...], quindi Elimina.
