Eseguire query sui dati 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 di un database KQL.

Il set di query KQL usa il Linguaggio di query Kusto 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 un cluster e un database di Azure Esplora dati con autorizzazioni AllDatabase Amministrazione.

Selezionare un database

Le query vengono eseguite nel contesto di un database. È possibile modificare il database associato in qualsiasi momento e conservare le query salvate nell'editor di query. È possibile associare il set di query KQL a un database KQL o a un database da un cluster di azure Esplora dati.

Selezionare la scheda corrispondente al tipo di database desiderato.

KQL Database

1. Aprire il set di query KQL.

2. In Database selezionare V per espandere il menu Connessioni al database.

   

3. In Connessione'origine selezionare Hub dati OneLake.

4. Nella finestra dell'hub dati OneLake visualizzata selezionare un database KQL e quindi selezionare Seleziona.

   

Cluster di Esplora dati di Azure

1. Aprire il set di query KQL.

2. In Database selezionare V per espandere il menu Connessioni al database.

   

3. In origine Connessione selezionare Azure Esplora dati.

4. In URI di Connessione ion immettere l'URI del cluster.

   Per trovare l'URI di connessione, passare alla risorsa cluster nel portale di Azure. L'URI di connessione è l'URI disponibile in Panoramica. Per aggiungere un cluster di esempio gratuito, specificare "help" come URI di Connessione ion.

   

5. In Database selezionare il menu a discesa per espandere l'elenco di database nel cluster e quindi selezionare un database.

6. Selezionare Connetti.

Sotto il nome del database viene visualizzato un elenco di tabelle associate a questo database.

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 eseguire query sui dati da qualsiasi database a cui si ha accesso. Per altre informazioni su KQL, vedere Linguaggio di query Kusto panoramica.

Gli esempi seguenti usano i dati disponibili pubblicamente in https://kustosamples.blob.core.windows.net/samplefiles/StormEvents.csv.

1. Scrivere o copiare una query nel riquadro superiore del set di query KQL.

2. Selezionare il pulsante Esegui oppure premere MAIUSC+INVIO per eseguire la query.

   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.

   

Gestire le schede del set di query

All'interno di un set di query KQL è possibile creare più schede. Ogni scheda può essere associata a un database KQL diverso e consente di salvare le query per usarle o condividerle con altri utenti 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 stati diversi.

• Rinominare una scheda: selezionare l'icona a forma di matita accanto al nome della scheda.
• Aggiungi una nuova scheda: selezionare il segno più + a destra delle schede esistenti. È possibile connettere schede diverse a database diversi.
• Modificare la connessione al database esistente: in Database selezionare la connessione al database esistente per aprire l'hub dati.

Copia la query

Potrebbe essere necessario copiare o condividere le query create.

1. Nella parte superiore della finestra della query selezionare la scheda Home .

2. Selezionare Copia query.

   

   Nella tabella seguente vengono illustrate le numerose opzioni per la condivisione di una query.

   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.

   Azione	Descrizione
   Copia la query	Copiare il testo della query.
   Collegamento negli Appunti	Copiare un collegamento diretto che può essere usato per eseguire la query.
   Collegare ed eseguire query negli Appunti	Copiare un collegamento che può essere usato per eseguire la query e il testo della query.
   Collegare, eseguire 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.

3. Selezionare l'azione di condivisione desiderata nella tabella precedente.

4. Incollare queste informazioni in qualsiasi editor, ad esempio Microsoft Word.

Esportare i dati delle query come CSV

Invece di copiare 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.

1. Nella parte superiore della finestra della query selezionare la scheda Home .

   

2. Selezionare Esporta risultati in CSV.

3. Salvare il file CSV in locale.

Eliminare il set di query KQL

Per eliminare il set di query KQL:

1. Selezionare l'area di lavoro a cui è associato il set di query KQL.

2. Passare il puntatore del mouse sul set di query KQL da eliminare. Selezionare Altro [...], quindi elimina.

   

Passaggio successivo

Personalizzare i risultati nella griglia dei risultati del set di query KQL