Condividi tramite


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 di un database KQL.

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

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 Esplora dati di Azure.

Selezionare la scheda corrispondente al tipo di database desiderato.

  1. Aprire il set di query KQL.

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

    Screenshot del menu del database che mostra un elenco di database connessi.

  3. In Connetti origine selezionare Hub dati OneLake.

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

    Screenshot della finestra dell'hub dati OneLake che mostra un database KQL selezionato.

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 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.

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

  2. 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 la 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.

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 stati diversi.

Screenshot delle opzioni per la modifica delle schede nel set di query KQL.

  • Rinominare una scheda: selezionare l'icona a forma di matita accanto al nome della scheda.
  • Aggiungere una nuova scheda: Selezionare il più + a destra della scheda esistente. È possibile connettere schede diverse a database diversi.
  • Modificare il collegamento al database esistente: in Database selezionare il collegamento 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, selezionare la scheda Home.

  2. Selezionare Copia query.

    Screenshot della scheda Gestisci del set di query KQL che mostra l'elenco a discesa dell'opzione copia query o risultati 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 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.
  3. Selezionare l'azione di condivisione desiderata nella tabella precedente.

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

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.

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

    Screenshot della scheda Home del set di query KQL che mostra l'opzione evidenziata per esportare i risultati in CSV.

  2. Selezionare Esportazione risultati in un file 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.

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

Passaggio successivo