Uso di Kusto.Explorer

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

Kusto.Explorer è un'applicazione desktop che consente di esplorare i dati usando il Linguaggio di query Kusto in un'interfaccia utente facile da usare. Questo articolo illustra come usare le modalità di ricerca e query, condividere le query e gestire cluster, database e tabelle.

Modalità Search++

La modalità Search++ consente di cercare un termine usando la sintassi di ricerca in una o più tabelle.

1. Nell'elenco a discesa Query della scheda Home selezionare Cerca++.

2. Selezionare Più tabelle.

3. In Scegli tabelle definire le tabelle da cercare e quindi selezionare OK.

4. Nella casella di modifica immettere la frase di ricerca e selezionare Vai.

   Una mappa termica della griglia tabella/intervallo di tempo mostra i termini visualizzati e dove vengono visualizzati.

   

5. Selezionare una cella nella griglia e selezionare Visualizza dettagli per visualizzare le voci pertinenti nel riquadro dei risultati.

   

Modalità query

Kusto.Explorer include una potente modalità di query che consente di scrivere, modificare ed eseguire query inline. La modalità query include l'evidenziazione della sintassi e IntelliSense, in modo da poter aumentare rapidamente le conoscenze del Linguaggio di query Kusto.

Questa sezione descrive come eseguire query di base in Kusto.Explorer e come aggiungere parametri alle query.

Query di base

Se sono presenti log di tabella, è possibile iniziare a esplorarli:

StormEvents | count 

Quando il cursore si trova su questa linea, è grigio colorato. Premere F5 per eseguire la query.

Ecco alcune query di esempio:

// Take 10 lines from the table. Useful to get familiar with the data
StormEvents | take 10 

// Filter by EventType == 'Flood' and State == 'California' (=~ means case insensitive) 
// and take sample of 10 lines
StormEvents 
| where EventType == 'Flood' and State =~ 'California'
| take 10

Per altre informazioni sul Linguaggio di query Kusto, vedere Linguaggio di query Kusto.

Nota

Le righe vuote nell'espressione di query possono influire sulla parte della query eseguita.

Se non è selezionato alcun testo, si presuppone che la query o il comando sia delimitato da righe vuote. Se è selezionato, il testo viene eseguito.

Parametrizzazione delle query sul lato client

Nota

Esistono due tipi di tecniche di parametrizzazione delle query in Kusto:

• La parametrizzazione delle query integrata nel linguaggio viene implementata sul lato server e deve essere usata dalle applicazioni che eseguono query sul servizio a livello di codice. Questo metodo non è descritto in questo documento.

• La parametrizzazione delle query sul lato client è una funzionalità solo dell'applicazione Kusto.Explorer. Equivale all'uso di operazioni di sostituzione di stringhe sulle query prima di inviarle per l'esecuzione dal servizio. La sintassi non fa parte del linguaggio di query stesso e non può essere usata durante l'invio di query al servizio con mezzi diversi da Kusto.Explorer.

Se si usa lo stesso valore in più query o in più schede, è estremamente scomodo modificare tale valore in ogni posizione in cui viene usato. Per praticità, Kusto.Explorer supporta i parametri di query. I parametri di query vengono condivisi tra le schede in modo che possano essere facilmente riutilizzati. I parametri sono indicati da {} parentesi quadre. Ad esempio: {parameter1}.

È possibile definire e modificare facilmente i parametri di query esistenti:

È possibile avere più set di parametri (elencati nella casella combinata Imposta parametri). Selezionare Aggiungi nuovo o Elimina corrente per modificare l'elenco dei set di parametri.

Condividere query e risultati

In Kusto.Explorer è possibile condividere query e risultati tramite posta elettronica. È anche possibile creare collegamenti diretti che aprono ed eseguono una query nel browser.

Condividere query e risultati tramite posta elettronica

Kusto.Explorer offre un modo pratico per condividere query e risultati delle query tramite posta elettronica.

1. Eseguire la query in Kusto.Explorer.

2. Nella sezione Condividi della scheda Home selezionare Query e risultati negli Appunti oppure premere CTRL+MAIUSC+C.

   

   Kusto.Explorer copia gli Appunti seguenti:

   • Query
   • Risultati della query (tabella o grafico)
   • Dettagli di connessione per la casa eventi e il database
   • Collegamento che esegue nuovamente la query automaticamente

3. Incollare il contenuto degli Appunti in un nuovo messaggio di posta elettronica.

Query di deep linking

È possibile creare un URI che, quando aperto in un browser, apre Kusto.Explorer in locale ed esegue una query specifica in un database Kusto specificato.

Nota

Per motivi di sicurezza, il deep linking è disabilitato per i comandi di gestione.

Creazione di un collegamento diretto

Il modo più semplice per creare un collegamento diretto consiste nel creare la query in Kusto.Explorer e quindi usare Query and results to Clipboard per copiare la query (inclusi il collegamento diretto e i risultati) negli Appunti. È quindi possibile condividerlo tramite posta elettronica.

Quando viene copiato in un messaggio di posta elettronica, viene visualizzato un numero di collegamenti da eseguire in un tipo di carattere ridotto. Ad esempio:

Esecuzione: [Web] [Desktop] [Web (Lens)] [Desktop (SAW)] https://trd-1234.kusto.fabric.microsoft.com

Il collegamento Web apre la query in Azure Esplora dati. Il collegamento desktop è il collegamento diretto. Apre la query in Kusto.Explorer e imposta il contesto in modo appropriato.

Se si sposta il collegamento a un messaggio di posta elettronica e si preme CTRL+K, è possibile visualizzare l'URL effettivo.

Collegamenti diretti e query parametrizzate

È possibile usare query parametrizzate con deep linking.

1. Creare una query da creare come query parametrizzata (ad esempio, KustoLogs | where Timestamp > ago({Period}) | count)

1. Specificare un parametro per ogni parametro di query nell'URI. Per copiare l'URI, nel riquadro query KQL in Infrastruttura selezionare Copia>collegamento query negli Appunti.

2. Incolla il collegamento nel riquadro query Kusto.Explorer.

Nota

Per assicurarsi di poter eseguire la query in Kusto.Explorer, assicurarsi di potersi connettere al database a cui si fa riferimento nella query.

Limiti

Le query sono limitate a circa 2.000 caratteri a causa di limitazioni del browser, proxy HTTP e strumenti che convalidano i collegamenti, ad esempio Microsoft Outlook. La limitazione è approssimativa perché dipende dalla lunghezza del cluster e del nome del database. Per ulteriori informazioni, vedere https://support.microsoft.com/kb/208427.

Per ridurre le probabilità di raggiungere il limite di caratteri, vedere Recupero di collegamenti più brevi.

L'URI apre Kusto.Explorer ed esegue la query specificata. Se è già presente un'istanza in esecuzione, viene aperta una nuova scheda.

Recupero di collegamenti più brevi

Le query possono diventare lunghe. Per ridurre la probabilità che la query superi la lunghezza massima, usare il String Kusto.Data.Common.CslCommandGenerator.EncodeQueryAsBase64Url(string query) metodo disponibile nella libreria client Kusto. Questo metodo produce una versione più compatta della query. Il formato più breve viene riconosciuto anche da Kusto.Explorer.

<https://\BaseAddress>/groups/1234ab-cd55-6789-0123-e4567fg890hi/databases/01234abc-defg-6789-4567fg890hi?experience=power-bi&extensionScenario=openArtifact&query=1234AAAAAAAAAAAA567890BBBBBBBBBB01234567890CCCCCCCCCCC1234AAAAAAAA567890BBBBBBBBBBBB01234567890CCCCCCCCCCC1234AAAAAAAAAAA567890BBBBBBBBBB01234567890CCCCCCCCC%AB%AB

La query viene resa più compatta applicando la trasformazione seguente:

 UrlEncode(Base64Encode(gzip(original query)))

Argomenti della riga di comando kusto.Explorer

Gli argomenti della riga di comando vengono usati per configurare lo strumento per eseguire altre funzioni all'avvio. Ad esempio, caricare uno script e connettersi a un cluster. Di conseguenza, gli argomenti della riga di comando non sostituiscono alcuna funzionalità di Kusto.Explorer.

Gli argomenti della riga di comando vengono passati come parte dell'URL usato per aprire l'applicazione, in modo analogo al deep linking delle query.

Sintassi dell'argomento della riga di comando

Kusto.Explorer supporta diversi argomenti della riga di comando nella sintassi seguente (l'ordine è importante):

[LocalScriptFile] [QueryString]

Argomenti della riga di comando

Argomento della riga di comando	Descrizione
LocalScriptFile	Nome di un file di script nel computer locale, che deve avere l'estensione .kql. Se il file esiste, Kusto.Explorer carica automaticamente il file all'avvio.
QueryString	Stringa che usa la formattazione della stringa di query HTTP. Questo metodo fornisce più proprietà, come descritto nella tabella seguente.

Argomenti querystring

Argomento	Descrizione
Query da eseguire
query	Query da eseguire (con gzipped, quindi codificata in base64; vedere Recupero di collegamenti più brevi). Se non specificato, usa querysrc.
querysrc	URL di un file o di un BLOB che contiene la query da eseguire.
Connessione al cluster Kusto
uri	Il stringa di connessione del cluster Kusto a cui connettersi.
name	Nome visualizzato della connessione al cluster Kusto.
Gruppo di connessioni
path	URL di un file del gruppo di connessioni da scaricare (con codifica URL).
group	Nome del gruppo di connessioni.
filename	File locale contenente il gruppo di connessioni.

Esempio

Per avviare Kusto.Explorer con un file di script denominato c:\temp\script.kql e configurato per comunicare con un gruppo e un database specifici, usare il comando seguente:

Kusto.Explorer.exe c:\temp\script.kql "uri=https://<baseaddress>/groups/<GroupID>/databases/<DatabaseID>"

Gestire database, tabelle o entità autorizzate per le funzioni

Importante

Solo gli amministratori possono aggiungere o eliminare entità autorizzate nel proprio ambito.

1. Per visualizzare l'elenco delle entità autorizzate, fare clic con il pulsante destro del mouse sull'entità di destinazione nel pannello Connessioni e scegliere Gestisci entità autorizzate del database. È anche possibile selezionare questa opzione dal menu gestione.

   

2. Selezionare Aggiungi entità per aggiungere un'entità autorizzata.

3. Specificare i dettagli dell'entità, quindi selezionare Aggiungi entità.

   

4. Verificare di voler aggiungere l'entità autorizzata.

   

Per eliminare un'entità autorizzata esistente, selezionare Rilascia entità e confermare l'azione.

Contenuto correlato

• Tasti di scelta rapida di Kusto.Explorer
• Opzioni di Kusto.Explorer
• Risoluzione dei problemi relativi a Kusto.Explorer
• Funzionalità del codice Kusto.Explorer
• Linguaggio di query Kusto (KQL)