Dela via

Egenskaper för begäran

  • Artikel

Gäller för: ✅Microsoft Fabric✅Azure Data Explorer

Egenskaper för begäran styr hur en fråga eller ett kommando kör och returnerar resultat.

Egenskaper för begäranden som stöds

I följande tabell beskrivs egenskaperna för begäranden som stöds.

Not

Begärandeegenskaperna query_weakconsistency_session_id och queryconsistency är inte tillgängliga i Infrastrukturresurser.

Egenskapsnamn Typ Beskrivning
best_effort bool Om värdet är inställt på true, tillåter fuzzy lösning och anslutningsproblem för datakällor (union legs.) Uppsättningen med unionskällor reduceras till den uppsättning tabellreferenser som finns och är tillgängliga vid tidpunkten för körningen. Om minst en tillgänglig tabell hittas körs frågan. Eventuella fel ger en varning i frågestatusresultatet men hindrar inte frågan från att köras.
client_max_redirect_count long Styr det maximala antalet HTTP-omdirigeringar som klienten följer under bearbetningen.
client_results_reader_allow_varying_row_widths bool Om värdet är inställt på truetolererar resultatläsaren tabeller vars radbredd varierar mellan rader.
deferpartialqueryfailures bool Om värdet är inställt på trueundertrycks rapportering av partiella frågefel i resultatuppsättningen.
materialized_view_shuffle_query dynamic Ger ett tips om att använda shuffle-strategin för refererade materialiserade vyer i frågan. Den här egenskapen påverkar endast materialiserade vyer och inte efterföljande åtgärder, till exempel kopplingar, i frågan. Det tar en matris med materialiserade vynamn och deras motsvarande shuffle-nycklar.

Till exempel anger dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) att vyn V1 av nycklar K1 och K2dynamic([ { "Name": "V1" } ]) blandar vy V1 av alla nycklar.
max_memory_consumption_per_query_per_node long Åsidosätter den maximala standardmängden minne som en fråga kan allokera per nod.
maxmemoryconsumptionperiterator long Åsidosätter den maximala mängden minne som en frågeoperator kan allokera.
maxoutputcolumns long Åsidosätter det maximala standardantalet kolumner som en fråga får producera.
norequesttimeout bool Anger tidsgränsen för begäran till maximalt värde. Det här alternativet kan inte ändras som en del av en set-instruktion.
notruncation bool Inaktiverar trunkering av frågeresultat som returneras till anroparen.
push_selection_through_aggregation bool Om värdet är inställt på truekan du push-överföra enkla val via aggregering.
query_bin_auto_at ordagrann Anger startvärdet som ska användas vid utvärdering av funktionen bin_auto().
query_bin_auto_size ordagrann Anger det intervallstorleksvärde som ska användas vid utvärdering av funktionen bin_auto().
query_cursor_after_default string Anger standardparametervärdet för funktionen cursor_after() när den anropas utan parametrar.
query_cursor_before_or_at_default string Anger standardparametervärdet för funktionen cursor_before_or_at() när den anropas utan parametrar.
query_cursor_current string Åsidosätter markörens värde som returneras av funktionen cursor_current().
query_cursor_disabled bool Inaktiverar användningen av markörfunktioner i frågekontexten.
query_cursor_scoped_tables dynamic Listar tabellnamn som ska begränsas till cursor_after_default .. cursor_before_or_at() (övre gränsen är valfri).
query_datascope string Styr de data som frågan gäller för. Värden som stöds är default, alleller hotcache.
query_datetimescope_column string Anger kolumnnamnet för frågans datetime-omfång (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from datetime Anger den minsta datum- och tidsgränsen för frågeomfånget. Om det definieras fungerar det som ett automatiskt tillämpat filter på query_datetimescope_column.
query_datetimescope_to datetime Anger den maximala datum- och tidsgränsen för frågeomfånget. Om det definieras fungerar det som ett automatiskt tillämpat filter på query_datetimescope_column.
query_distribution_nodes_span int Styr beteendet för sammanslagning av underfrågor. Den körande noden introducerar en extra nivå i frågehierarkin för varje undergrupp av noder, och det här alternativet anger undergruppsstorleken.
query_fanout_nodes_percent int Anger procentandelen noder för körning av utrullningsbara enheter.
query_fanout_threads_percent int Anger procentandelen trådar för att köra utstängt.
query_force_row_level_security bool Om värdet är inställt på trueframtvingar säkerhet på radnivå regler, även om principen är inaktiverad.
query_language string Avgör hur frågetexten ska tolkas. Värden som stöds är csl, kqleller sql. Det här alternativet kan inte ändras som en del av en set-instruktion.
query_log_query_parameters bool Aktiverar loggning av frågeparametrar för senare visning i .show-frågor journal.
query_max_entities_in_union long Åsidosätter det maximala standardantalet kolumner som en fråga får producera.
query_now datetime Åsidosätter datetime-värdet som returneras av funktionen now().
query_optimize_fts_at_relop bool När värdet är inställt på trueaktiverar du en experimentell optimering för frågor som utför kostsamma sökåtgärder i fritext. Till exempel \|where * has "pattern".
query_python_debug bool eller int Om värdet är inställt på truegenererar en Python-felsökningsfråga för den uppräknade Python-noden.
query_results_apply_getschema bool Om värdet är inställt på truehämtar schemat för varje tabelldata i resultatet av frågan i stället för själva data.
query_results_cache_force_refresh bool Om värdet är inställt på truetvingar du fram en cacheuppdatering av frågeresultat för en specifik fråga. Måste användas i kombination med query_results_cache_max_ageoch skickas via Kusto Data ClientRequestProperties-klass, inte som en set-instruktion.
query_results_cache_max_age timespan Styr den maximala åldern för cachelagrade frågeresultat som tjänsten får returnera.
query_results_cache_per_shard bool Om värdet är inställt på trueaktiverar per utsträckning cachelagring av frågor.
query_results_progressive_row_count long Ger ett tips för hur många poster som ska skickas i varje uppdatering. Börjar gälla endast om results_progressive_enabled har angetts.
query_results_progressive_update_period timespan Ger ett tips om hur ofta förloppsramar ska skickas. Börjar gälla endast om results_progressive_enabled har angetts.
query_take_max_records long Begränsar frågeresultat till ett angivet antal poster.
query_weakconsistency_session_id string Anger sessions-ID för svag konsekvens för frågan. Börjar gälla när queryconsistency läge är inställt på weakconsistency_by_session_id. Det här alternativet kan inte ändras som en del av en set-instruktion.
queryconsistency string Styr frågekonsekvens. Värden som stöds är strongconsistency, weakconsistency, weakconsistency_by_query, weakconsistency_by_databaseeller weakconsistency_by_session_id. När du använder weakconsistency_by_session_idmåste du också ange egenskapen query_weakconsistency_session_id. Det här alternativet kan inte ändras som en del av en set-instruktion.
request_app_name string Anger namnet på begärandeprogrammet som ska användas i rapporteringen. Till exempel .show-frågor. Det här alternativet kan inte ändras som en del av en set-instruktion.
request_block_row_level_security bool Om värdet är inställt på trueblockerar du åtkomsten till tabeller med säkerhet på radnivå princip aktiverad.
request_callout_disabled bool Om inställningen är inställd på trueförhindrar du begärandeutrop till en tjänst som tillhandahålls av användaren.
request_description string Tillåter inkludering av godtycklig text som beskrivning av begäran.
request_external_data_disabled bool Om värdet är inställt på trueförhindrar du att begäran får åtkomst till externa data med hjälp av externaldata operator eller externa tabeller.
request_external_table_disabled bool Om värdet är inställt på trueförhindrar det att begäran kommer åt externa tabeller.
request_impersonation_disabled bool Om värdet är inställt på trueanger det att tjänsten inte ska personifiera anroparens identitet.
request_readonly bool Om värdet är inställt på trueförhindrar du skrivåtkomst för begäran. Det här alternativet kan inte ändras som en del av en set-instruktion.
request_readonly_hardline bool Om den är inställd på truefungerar begäran i ett strikt skrivskyddat läge. Begäran kan inte skriva något och alla inkompatibla funktioner, till exempel plugin-program, är inaktiverade. Det här alternativet kan inte ändras som en del av en set-instruktion.
request_remote_entities_disabled bool Om värdet är inställt på truehindrar begäran från att komma åt fjärrdatabaser och fjärrentiteter.
request_sandboxed_execution_disabled bool Om värdet är inställt på trueförhindrar du att begäran anropar kod i sandbox-miljön.
request_user string Anger den begärande användare som ska användas i rapporteringen. Till exempel .show-frågor. Det här alternativet kan inte ändras som en del av en set-instruktion.
results_error_reporting_placement string Avgör placeringen av fel i resultatuppsättningen. Alternativen är in_data, end_of_tableoch end_of_dataset.
results_progressive_enabled bool Om värdet är inställt på trueaktiverar du den progressiva frågeströmmen. Det här alternativet kan inte ändras som en del av en set-instruktion.
results_v2_fragment_primary_tables bool Gör att primära tabeller skickas i flera fragment som var och en innehåller en delmängd av raderna. Det här alternativet kan inte ändras som en del av en set-instruktion.
results_v2_newlines_between_frames bool Lägger till nya rader mellan bildrutor i resultatet för att göra det enklare att parsa dem.
servertimeout timespan Åsidosätter tidsgränsen för standardbegäran. Det här alternativet kan inte ändras som en del av en set-instruktion. Ändra i stället alternativet med hjälp av instrumentpanelsinställningarna.
truncation_max_records long Åsidosätter det maximala standardantal poster som en fråga får returnera till anroparen (trunkering).
truncationmaxsize long Åsidosätter den maximala standarddatastorlek som en fråga får återgå till anroparen (trunkering). Det här alternativet kan inte ändras som en del av en set-instruktion.
validatepermissions bool Verifierar användarens behörigheter för att utföra frågan utan att köra frågan. Möjliga resultat för den här egenskapen är: OK (behörigheter finns och är giltiga), Incomplete (verifieringen kunde inte slutföras på grund av dynamisk schemautvärdering) eller KustoRequestDeniedException (behörigheter angavs inte).

Så här anger du egenskaper för begäran

Du kan ange egenskaper för begäranden på följande sätt:

Not

Följande egenskaper för begäran kan inte anges med en set-instruktion:

  • 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

Not

Relaterat innehåll