Condividi tramite

Classe Kusto Data ClientRequestProperties

  • Articolo

Nella libreria dati Kusto la ClientRequestProperties classe consente di gestire l'interazione tra l'applicazione client e il servizio. Questa classe contiene le informazioni seguenti:

  • Proprietà della richiesta: mapping di opzioni specifiche per la personalizzazione del comportamento della richiesta.
  • Parametri di query: mapping di parametri dichiarati dall'utente che consentono la personalizzazione sicura delle query.
  • Proprietà denominate: ID richiesta client, dettagli dell'applicazione e dati utente, usati principalmente per il debug e la traccia.

Proprietà delle richieste

Le proprietà della richiesta consentono di personalizzare il comportamento di una query specifica. La ClientRequestProperties classe include vari metodi per la gestione delle proprietà della richiesta, ad esempio l'opzione set, l'opzione get e l'opzione . I nomi precisi dei metodi variano in base alle convenzioni di denominazione specifiche della lingua per ogni libreria client.

Per un elenco delle proprietà delle richieste disponibili, vedere Proprietà della richiesta.

Ad esempio, vedere Personalizzare il comportamento delle query con le proprietà della richiesta client.

Parametri di query

L'istruzione di dichiarazione dei parametri di query può essere usata per dichiarare i parametri per una query di Linguaggio di query Kusto (KQL). In Dati Kusto la ClientRequestProperties classe contiene metodi da impostare, cancellare e controllare la presenza di tali parametri di query.

Il metodo set parameter fornisce overload per i tipi di dati comuni, ad esempio string e long. Per tutti gli altri tipi, esprimere il valore come valore letterale KQL nel string formato e assicurarsi che l'istruzione query_parameters declare dichiari il tipo di dati scalare corretto.

Ad esempio, vedere Usare i parametri di query per proteggere l'input dell'utente.

Proprietà denominate

Nella tabella seguente vengono descritte le proprietà denominate disponibili nella ClientRequestProperties classe . Ogni proprietà si traduce in un'intestazione HTTP e può essere impostata anche quando si effettua una richiesta API REST.

Nome della proprietà Intestazione HTTP Descrizione
ClientRequestId o client_request_id (in base alle convenzioni di denominazione specifiche della lingua) x-ms-client-request-id ID utilizzato per identificare la richiesta. Questa specifica è utile per il debug e può essere necessaria per scenari specifici, ad esempio l'annullamento delle query.

È consigliabile usare il formato ClientApplicationName.ActivityType;UniqueId. Se il client non specifica un valore per questa proprietà, viene assegnato un valore casuale.
Application x-ms-app Nome dell'applicazione client che effettua la richiesta. Questo valore viene usato per la traccia.

Se il client non specifica un valore per questa proprietà, la proprietà viene impostata automaticamente sul nome del processo che ospita la libreria dati Kusto. Per specificare questa proprietà in un stringa di connessione Kusto, utilizzare la Application Name for Tracing proprietà .
User x-ms-user Identità dell'utente che effettua la richiesta. Questo valore viene usato per la traccia.

Per specificare questa proprietà in un stringa di connessione Kusto, utilizzare la User Name for Tracing proprietà .

Attenzione

La proprietà ID richiesta client viene registrata per la diagnostica. Evitare di inviare dati sensibili, ad esempio informazioni personali o riservate.

Contenuto correlato