Istruzione di dichiarazione dei parametri di query

Selezionare un servizio dall'elenco a discesa a sinistra.
Si applica a: ✅ Microsoft Fabric ✅ Esplora dati ✅ di Azure Monitoraggio di Azure Microsoft ✅ Sentinel

Le query inviate a Kusto possono includere un set di coppie nome o valore. Le coppie sono denominate parametri di query, insieme al testo della query stesso. La query può fare riferimento a uno o più valori, specificando nomi e tipo, in un'istruzione di dichiarazione di parametri di query.

I parametri di query hanno due usi principali:

• Come meccanismo di protezione dagli attacchi injection.
• Come modo per parametrizzare le query.

In particolare, le applicazioni client che combinano l'input fornito dall'utente nelle query inviate a Kusto devono usare il meccanismo per proteggersi dagli attacchi Kusto equivalenti di attacchi SQL Injection .

Dichiarazione di parametri di query

Per fare riferimento ai parametri di query, il testo della query o le funzioni usate deve innanzitutto dichiarare il parametro di query usato. Per ogni parametro, la dichiarazione fornisce il nome e il tipo scalare. Facoltativamente, il parametro può anche avere un valore predefinito. Il valore predefinito viene usato se la richiesta non fornisce un valore concreto per il parametro . Kusto analizza quindi il valore del parametro di query, in base alle normali regole di analisi per quel tipo.

Syntax

declare query_parameters ( Nome1:Type1 [=DefaultValue1] [,...] );

Altre informazioni sulle convenzioni di sintassi.

Parameters

Example

Negli esempi di questa sezione viene illustrato come usare la sintassi per iniziare.

Dichiarare i parametri di query

Questa query recupera gli eventi storm dalla tabella StormEvents in cui il numero totale di lesioni dirette e indirette supera una soglia specificata (il valore predefinito è 90). Proietta quindi EpisodeId, EventType e il numero totale di lesioni per ognuno di questi eventi.

declare query_parameters(maxInjured:long = 90);
StormEvents 
| where InjuriesDirect + InjuriesIndirect > maxInjured
| project EpisodeId, EventType, totalInjuries = InjuriesDirect + InjuriesIndirect

Output

Specificare i parametri di query in un'applicazione client

I nomi e i valori dei parametri di query vengono forniti come string valori dall'applicazione che effettua la query. Nessun nome può ripetersi.

L'interpretazione dei valori viene eseguita in base all'istruzione di dichiarazione dei parametri di query. Ogni valore viene analizzato come se fosse un valore letterale nel corpo di una query. L'analisi viene eseguita in base al tipo specificato dall'istruzione di dichiarazione dei parametri di query.

REST API

I parametri di query vengono forniti dalle applicazioni client tramite lo properties slot dell'oggetto JSON del corpo della richiesta, in un contenitore di proprietà annidato denominato Parameters. Ad esempio, ecco il corpo di una chiamata API REST a Kusto che calcola l'età di un utente, presumibilmente facendo in modo che l'applicazione richieda il compleanno dell'utente.

{
    "ns": null,
    "db": "myDB",
    "csl": "declare query_parameters(birthday:datetime); print strcat(\"Your age is: \", tostring(now() - birthday))",
    "properties": "{\"Options\":{},\"Parameters\":{\"birthday\":\"datetime(1970-05-11)\",\"courses\":\"dynamic(['Java', 'C++'])\"}}"
}

SDK Kusto

Per informazioni su come specificare i nomi e i valori dei parametri di query quando si usano le librerie client Kusto, vedere Usare i parametri di query per proteggere l'input dell'utente.

Kusto.Explorer

Per impostare i parametri di query inviati quando si effettua una richiesta al servizio, usare l'icona "wrench" dei parametri di query (ALT + P).