Condividi tramite

Proprietà delle richieste

  • Articolo

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati

Le proprietà della richiesta controllano la modalità di esecuzione di una query o di un comando e restituiscono i risultati.

Proprietà della richiesta supportate

Nella tabella seguente sono descritte le proprietà della richiesta supportate.

Nota

Le proprietà query_weakconsistency_session_id della richiesta e queryconsistency non sono disponibili in Fabic.

Nome proprietà Type Descrizione
best_effort bool Se impostato su true, consente la risoluzione fuzzy e i problemi di connettività delle origini dati (gambe di unione). Il set di origini di unione viene ridotto al set di riferimenti di tabella esistenti e accessibili al momento dell'esecuzione. Se viene trovata almeno una tabella accessibile, la query viene eseguita. Qualsiasi errore genera un avviso nei risultati dello stato della query, ma non impedisce l'esecuzione della query.
client_max_redirect_count long Controlla il numero massimo di reindirizzamenti HTTP che il client segue durante l'elaborazione.
client_results_reader_allow_varying_row_widths bool Se impostato su true, il lettore risultati tollera le tabelle la cui larghezza delle righe varia in base alle righe.
deferpartialqueryfailures bool Se impostato su true, elimina la segnalazione di errori parziali di query all'interno del set di risultati.
materialized_view_shuffle_query dynamic Fornisce un suggerimento per usare la strategia casuale per le viste materializzate di riferimento nella query. Questa proprietà influisce esclusivamente sulle viste materializzate e non sulle operazioni successive, ad esempio join, all'interno della query. Accetta una matrice di nomi di visualizzazione materializzati e le relative chiavi casuali corrispondenti.

Ad esempio, dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) indica la visualizzazione casuale in base V1 alle chiavi K1 e K2, mentre dynamic([ { "Name": "V1" } ]) la visualizzazione V1 casuale viene eseguita da tutte le chiavi.
max_memory_consumption_per_query_per_node long Esegue l'override della quantità massima di memoria predefinita che una query può allocare per nodo.
maxmemoryconsumptionperiterator long Esegue l'override della quantità massima predefinita di memoria che un operatore di query può allocare.
maxoutputcolumns long Esegue l'override del numero massimo predefinito di colonne che una query può produrre.
norequesttimeout bool Imposta il timeout della richiesta sul valore massimo. Questa opzione non può essere modificata come parte di un'istruzione set.
notruncation bool Disabilita il troncamento dei risultati della query restituiti al chiamante.
push_selection_through_aggregation bool Se impostato su true, consente di eseguire il push di una selezione semplice tramite aggregazione.
query_bin_auto_at literal Specifica il valore iniziale da utilizzare durante la valutazione della funzione bin_auto().
query_bin_auto_size literal Specifica il valore della dimensione del bin da utilizzare durante la valutazione della funzione bin_auto().
query_cursor_after_default string Imposta il valore del parametro predefinito per la funzione cursor_after() quando viene chiamato senza parametri.
query_cursor_before_or_at_default string Imposta il valore del parametro predefinito per la funzione cursor_before_or_at() quando viene chiamato senza parametri.
query_cursor_current string Esegue l'override del valore del cursore restituito dalla funzione cursor_current().
query_cursor_disabled bool Disabilita l'utilizzo delle funzioni di cursore all'interno del contesto di query.
query_cursor_scoped_tables dynamic Elenca i nomi delle tabelle con ambito cursor_after_default .. cursor_before_or_at() (limite superiore è facoltativo).
query_datascope string Controlla i dati a cui viene applicata la query. I valori supportati sono default, allo hotcache.
query_datetimescope_column string Specifica il nome della colonna per l'ambito datetime della query (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from datetime Imposta il limite minimo di data e ora per l'ambito della query. Se definito, funge da filtro applicato automaticamente in query_datetimescope_column.
query_datetimescope_to datetime Imposta il limite massimo di data e ora per l'ambito della query. Se definito, funge da filtro applicato automaticamente in query_datetimescope_column.
query_distribution_nodes_span int Controlla il comportamento dell'unione di sottoquery. Il nodo in esecuzione introduce un livello aggiuntivo nella gerarchia di query per ogni sottogruppo di nodi e questa opzione imposta le dimensioni del sottogruppo.
query_fanout_nodes_percent int Specifica la percentuale di nodi per l'esecuzione della ventola.
query_fanout_threads_percent int Specifica la percentuale di thread per l'esecuzione della ventola.
query_force_row_level_security bool Se impostato su , applica le regole di sicurezza a truelivello di riga, anche se i criteri sono disabilitati.
query_language string Determina la modalità di interpretazione del testo della query. I valori supportati sono csl, kqlo sql. Questa opzione non può essere modificata come parte di un'istruzione set.
query_log_query_parameters bool Abilita la registrazione dei parametri di query per la visualizzazione successiva nel journal delle query .show.
query_max_entities_in_union long Esegue l'override del numero massimo predefinito di colonne che una query può produrre.
query_now datetime Esegue l'override del valore datetime restituito dalla funzione now().
query_optimize_fts_at_relop bool Se impostato su true, abilita un'ottimizzazione sperimentale per le query che eseguono operazioni di ricerca senza testo costose. Ad esempio, \|where * has "pattern".
query_python_debug bool oppure int Se impostato su true, genera una query di debug Python per il nodo Python enumerato.
query_results_apply_getschema bool Se impostato su true, recupera lo schema di ogni dati tabulare nei risultati della query anziché i dati stessi.
query_results_cache_force_refresh bool Se impostato su true, forza un aggiornamento della cache dei risultati della query per una query specifica. Deve essere usato in combinazione con query_results_cache_max_agee inviato tramite la classe Kusto Data ClientRequestProperties, non come istruzione set.
query_results_cache_max_age timespan Controlla la validità massima dei risultati delle query memorizzate nella cache che il servizio può restituire.
query_results_cache_per_shard bool Se impostato su true, abilita la memorizzazione nella cache delle query in base all'extent.
query_results_progressive_row_count long Fornisce un suggerimento per il numero di record da inviare in ogni aggiornamento. Ha effetto solo se results_progressive_enabled è impostato.
query_results_progressive_update_period timespan Fornisce un suggerimento per la frequenza con cui inviare frame di stato. Ha effetto solo se results_progressive_enabled è impostato.
query_take_max_records long Limita i risultati della query a un numero specificato di record.
query_weakconsistency_session_id string Imposta l'ID sessione di coerenza debole della query. Diventa effettivo quando queryconsistency la modalità è impostata weakconsistency_by_session_idsu . Questa opzione non può essere modificata come parte di un'istruzione set.
queryconsistency string Controlla la coerenza delle query. I valori supportati sono strongconsistency, weakconsistency, weakconsistency_by_query, weakconsistency_by_databaseo weakconsistency_by_session_id. Quando si usa weakconsistency_by_session_id, assicurarsi di impostare anche la query_weakconsistency_session_id proprietà . Questa opzione non può essere modificata come parte di un'istruzione set.
request_app_name string Specifica il nome dell'applicazione di richiesta da utilizzare nella creazione di report. Ad esempio, .show query. Questa opzione non può essere modificata come parte di un'istruzione set.
request_block_row_level_security bool Se impostato su true, blocca l'accesso alle tabelle con i criteri di sicurezza a livello di riga abilitati.
request_callout_disabled bool Se impostato su true, impedisce il callout della richiesta a un servizio fornito dall'utente.
request_description string Consente l'inclusione di testo arbitrario come descrizione della richiesta.
request_external_data_disabled bool Se impostato su true, impedisce alla richiesta di accedere a dati esterni usando l'operatore externaldata o le tabelle esterne.
request_external_table_disabled bool Se impostato su true, impedisce alla richiesta di accedere a tabelle esterne.
request_impersonation_disabled bool Se impostato su true, indica che il servizio non deve rappresentare l'identità del chiamante.
request_readonly bool Se impostato su true, impedisce l'accesso in scrittura per la richiesta. Questa opzione non può essere modificata come parte di un'istruzione set.
request_readonly_hardline bool Se è impostato su true, la richiesta opera in modalità strict di sola lettura. La richiesta non è in grado di scrivere nulla e le funzionalità non conformi, ad esempio i plug-in, sono disabilitate. Questa opzione non può essere modificata come parte di un'istruzione set.
request_remote_entities_disabled bool Se impostato su true, impedisce alla richiesta di accedere a database remoti ed entità remote.
request_sandboxed_execution_disabled bool Se impostato su true, impedisce alla richiesta di richiamare il codice nella sandbox.
request_user string Specifica l'utente della richiesta da utilizzare nella creazione di report. Ad esempio, .show query. Questa opzione non può essere modificata come parte di un'istruzione set.
results_error_reporting_placement string Determina la posizione degli errori nel set di risultati. Le opzioni sono in_data, end_of_tablee end_of_dataset.
results_progressive_enabled bool Se impostato su true, abilita il flusso di query progressivo. Questa opzione non può essere modificata come parte di un'istruzione set.
results_v2_fragment_primary_tables bool Fa sì che le tabelle primarie vengano inviate in più frammenti, ognuna contenente un subset delle righe. Questa opzione non può essere modificata come parte di un'istruzione set.
results_v2_newlines_between_frames bool Aggiunge nuove linee tra fotogrammi nei risultati, per semplificarne l'analisi.
servertimeout timespan Esegue l'override del timeout predefinito della richiesta. Questa opzione non può essere modificata come parte di un'istruzione set. Modificare invece l'opzione usando le impostazioni del dashboard.
truncation_max_records long Esegue l'override del numero massimo predefinito di record consentiti per restituire una query al chiamante (troncamento).
truncationmaxsize long Esegue l'override delle dimensioni massime predefinite dei dati consentite a una query per tornare al chiamante (troncamento). Questa opzione non può essere modificata come parte di un'istruzione set.
validatepermissions bool Convalida le autorizzazioni dell'utente per eseguire la query senza eseguire effettivamente la query. I risultati possibili per questa proprietà sono: OK (le autorizzazioni sono presenti e valide), Incomplete (non è stato possibile completare la convalida a causa della valutazione dinamica dello schema) o KustoRequestDeniedException (le autorizzazioni non sono state impostate).

Come impostare le proprietà della richiesta

È possibile impostare le proprietà delle richieste nei modi seguenti:

Nota

Le proprietà della richiesta seguenti non possono essere impostate con un'istruzione set:

  • norequesttimeout
  • queryconsistency
  • query_language
  • query_weakconsistency_session_id
  • request_app_name
  • request_readonly
  • request_readonly_hardline
  • request_user
  • results_progressive_enabled
  • results_v2_fragment_primary_tables
  • servertimeout
  • truncationmaxsize

Nota

Contenuto correlato