Interrogare i dati in un set di query KQL

Questo articolo illustra come usare un set di query KQL. Un set di query KQL consente di eseguire query, visualizzare i risultati e personalizzare i risultati delle query per i dati provenienti da origini diverse, ad esempio una sede eventi o un database KQL.

È anche possibile usare un set di query KQL per eseguire query tra servizi su un'area di lavoro Monitoraggio di Azure Log Analytics o su una risorsa di Application Insights.

Il set di query KQL usa il linguaggio di query Kusto (KQL) per creare query e supporta anche molte funzioni SQL. Per altre informazioni sul linguaggio di query, vedere Panoramica del linguaggio di query Kusto.

Prerequisiti

Selezionare un'origine dati

Le query vengono eseguite nel contesto di un'origine dati. È possibile modificare l'origine dati associata in qualsiasi momento e mantenere le query salvate nell'editor di query. È possibile associare il set di query KQL a più tipi di origine dati, tra cui un database KQL, un cluster Esplora dati di Azure o Monitoraggio di Azure.

Selezionare la scheda per il tipo di origine dati.

  1. Aprire il set di query KQL.

  2. Nel riquadro Esplora, sotto la barra di ricerca, aprire il menu del database e selezionare Aggiungi origine dati>Eventhouse / KQL Database.

    Screenshot del menu delle origini dati che mostra un elenco di origini dati connesse.

  3. Nella finestra del catalogo OneLake selezionare un database KQL per connettersi al set di query KQL e quindi selezionare Connetti.

    In alternativa, chiudere la finestra del catalogo 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 a un'origine dati, è possibile eseguire query su di essa. Queryset KQL usa il linguaggio di query Kusto (KQL) per eseguire query sui dati da qualsiasi origine dati connessa a cui è possibile accedere. Per altre informazioni su KQL, vedere Panoramica del linguaggio di query Kusto.

Negli esempi seguenti viene usato il file di esempioStormEvents.csv pubblico.

  1. Scrivere o copiare una query nel riquadro superiore dell'interfaccia di query KQL.

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

    I risultati della query vengono visualizzati nella griglia dei risultati 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.

    Screenshot del set di query KQL che mostra i risultati di una query. Sia la query che il riquadro dei risultati sono evidenziati.

Annotazioni

È anche possibile usare Copilot per scrivere query. Per altre informazioni, vedi Copilot per scrivere query nel set di query KQL.

Interagire con le sorgenti di dati

L'esplora origini dati consente di passare da un'origine dati all'altra tra quelle collegate alla scheda queryset corrente.

Nella parte superiore del riquadro Esplora origini dati, in Esplora è 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 la scheda non è stata rinominata in precedenza, viene automaticamente denominata dopo l'origine dati.

Screenshot che mostra come passare da un'origine dati all'altra usando la barra di ricerca e il commutatore database nel riquadro Esplora risorse.

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.

Visualizzare gli elementi nell'origine dati

La sezione superiore dell'Esplora origine dati mostra tutti gli elementi dell'origine dati che stai utilizzando.

  • Tabelle
  • Viste materializzate
  • 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 Tabelle selezionare la freccia > a sinistra di una tabella per visualizzare l'elenco di colonne in tale tabella.

Per aprire il menu azione, passare il puntatore del mouse su una voce nell'elenco espanso e selezionare il menu Altro [...]. Il menu include le opzioni seguenti:

  • Aggiornare il database
  • Visualizzare il profilo dati
  • Esplorazione dei 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.

Screenshot che mostra il pannello dell'esploratore, come espandere l'elenco di elementi nell'origine dati e dove trovare il menu Altre azioni.

Esplorare le origini dati disponibili

La sezione inferiore di Esplora origini dati mostra tutte le origini dati disponibili aggiunte al set di query.

Per aprire il menu azione, passare il puntatore del mouse sul nome dell'origine dati e selezionare il menu Altro [...]. Il menu include 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
  • Apri nel database KQL: apre questa origine dati in un database KQL.

Screenshot che mostra la parte inferiore del pannello Esplora risorse, dove sono elencate tutte le origini dati aggiunte al tuo query set.

Gestire le schede del query set

All'interno di un insieme di query KQL è possibile creare diverse schede. Ogni scheda può essere associata a un database KQL diverso. Questa configurazione consente di salvare le query per usarle in un secondo momento o condividerle con altri utenti per collaborare all'esplorazione dei dati. È anche possibile modificare il database KQL associato a qualsiasi scheda, che consente di eseguire la stessa query sui dati in database diversi.

È possibile gestire le schede come segue:

  • Modificare la connessione all'origine dati esistente: in Esplora e nella barra di ricerca usare il commutatore di database per espandere il menu 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, usare il menu scheda per gestire più schede nel set di query.
  • Modificare le posizioni delle schede: Usare trascinare e rilasciare.

Schermata del menu delle schede multiple per gestire più schede nel set di query in KQL.

Elimina un set di query KQL

Per eliminare il set di query KQL:

  1. Selezionare l'area di lavoro che contiene il set di query KQL.

  2. Posizionare il puntatore del mouse sul set di query KQL da eliminare. Selezionare Altro [...], quindi selezionare Elimina.

    Screenshot dell'area di lavoro di Microsoft Fabric che mostra come eliminare un set di query KQL.

Passaggio successivo