Delen via

Eigenschappen van aanvraag

  • Artikel

Van toepassing op: ✅Microsoft Fabric✅Azure Data Explorer-

Eigenschappen aanvragen bepalen hoe een query of opdracht wordt uitgevoerd en resultaten retourneert.

Ondersteunde aanvraageigenschappen

De volgende tabel bevat een overzicht van de ondersteunde aanvraageigenschappen.

Notitie

De aanvraageigenschappen query_weakconsistency_session_id en queryconsistency zijn niet beschikbaar in Fabric.

Naam van eigenschap Type Beschrijving
best_effort bool Als deze optie is ingesteld op true, kunt u fuzzy oplossings- en connectiviteitsproblemen van gegevensbronnen (samenvoegingspoten)) toestaan. De set samenvoegbronnen wordt beperkt tot de set tabelverwijzingen die bestaan en toegankelijk zijn op het moment van uitvoering. Als er ten minste één toegankelijke tabel wordt gevonden, wordt de query uitgevoerd. Een fout resulteert in een waarschuwing in de resultaten van de querystatus, maar verhindert niet dat de query wordt uitgevoerd.
client_max_redirect_count long Hiermee bepaalt u het maximum aantal HTTP-omleidingen dat de client volgt tijdens de verwerking.
client_results_reader_allow_varying_row_widths bool Als deze optie is ingesteld op true, tolereert de resultatenlezer tabellen waarvan de rijbreedte per rij varieert.
deferpartialqueryfailures bool Als deze optie is ingesteld op true, onderdrukt u de rapportage van gedeeltelijke queryfouten in de resultatenset.
materialized_view_shuffle_query dynamic Biedt een hint voor het gebruik van de shuffle-strategie voor gerealiseerde weergaven waarnaar wordt verwezen in de query. Deze eigenschap heeft uitsluitend invloed op gerealiseerde weergaven en niet op latere bewerkingen, zoals joins, binnen de query. Er wordt een matrix met gerealiseerde weergavenamen en de bijbehorende willekeurige sleutels gebruikt.

Geeft dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) bijvoorbeeld aan dat de weergave V1 wordt weergegeven op basis van sleutels K1 en K2, terwijl dynamic([ { "Name": "V1" } ]) weergaven V1 door alle sleutels dynamic([ { "Name": "V1" } ]).
max_memory_consumption_per_query_per_node long Hiermee wordt de standaard maximale hoeveelheid geheugen overschreven die een query per knooppunt kan toewijzen.
maxmemoryconsumptionperiterator long Hiermee wordt de standaard maximale hoeveelheid geheugen overschreven die een queryoperator kan toewijzen.
maxoutputcolumns long Hiermee wordt het standaard maximum aantal kolommen overschreven dat een query mag produceren.
norequesttimeout bool Hiermee stelt u de time-out van de aanvraag in op de maximale waarde. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
notruncation bool Hiermee wordt afkapping van queryresultaten uitgeschakeld die worden geretourneerd aan de aanroeper.
push_selection_through_aggregation bool Als deze optie is ingesteld op true, kunt u eenvoudige selecties pushen via aggregatie.
query_bin_auto_at letterlijk Hiermee geeft u de beginwaarde op die moet worden gebruikt bij het evalueren van de bin_auto() functie.
query_bin_auto_size letterlijk Hiermee geeft u de waarde van de bin-grootte die moet worden gebruikt bij het evalueren van de bin_auto() functie.
query_cursor_after_default string Hiermee stelt u de standaardparameterwaarde voor de cursor_after() functie in wanneer deze wordt aangeroepen zonder parameters.
query_cursor_before_or_at_default string Hiermee stelt u de standaardparameterwaarde voor de cursor_before_or_at() functie in wanneer deze wordt aangeroepen zonder parameters.
query_cursor_current string Hiermee overschrijft u de cursorwaarde die wordt geretourneerd door de functie cursor_current().
query_cursor_disabled bool Hiermee schakelt u het gebruik van cursorfuncties in de querycontext uit.
query_cursor_scoped_tables dynamic Bevat tabelnamen die moeten worden beperkt tot cursor_after_default .. cursor_before_or_at() (bovengrens is optioneel).
query_datascope string Hiermee bepaalt u de gegevens waarop de query van toepassing is. Ondersteunde waarden zijn default, allof hotcache.
query_datetimescope_column string Hiermee geeft u de kolomnaam voor het datum/tijd-bereik van de query (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from datetime Hiermee stelt u de minimale datum- en tijdslimiet voor het querybereik in. Indien gedefinieerd, fungeert het als een automatisch toegepast filter op query_datetimescope_column.
query_datetimescope_to datetime Hiermee stelt u de maximale datum- en tijdslimiet voor het querybereik in. Indien gedefinieerd, fungeert het als een automatisch toegepast filter op query_datetimescope_column.
query_distribution_nodes_span int Hiermee bepaalt u het gedrag van subquerysamenvoeging. Het uitvoerende knooppunt introduceert een extra niveau in de queryhiërarchie voor elke subgroep van knooppunten. Met deze optie wordt de grootte van de subgroep ingesteld.
query_fanout_nodes_percent int Hiermee geeft u het percentage knooppunten voor het uitvoeren van fan-out.
query_fanout_threads_percent int Hiermee geeft u het percentage threads voor het uitvoeren van fan-out.
query_force_row_level_security bool Als deze optie is ingesteld op true, wordt beveiliging op rijniveau afgedwongen regels, zelfs als het beleid is uitgeschakeld.
query_language string Bepaalt hoe de querytekst moet worden geïnterpreteerd. Ondersteunde waarden zijn csl, kqlof sql. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
query_log_query_parameters bool Hiermee schakelt u logboekregistratie van queryparameters in voor later weergeven in de .show query's logboek.
query_max_entities_in_union long Hiermee wordt het standaard maximum aantal kolommen overschreven dat een query mag produceren.
query_now datetime Hiermee overschrijft u de datum/tijd-waarde die wordt geretourneerd door de now() functie.
query_optimize_fts_at_relop bool Wanneer deze optie is ingesteld op true, schakelt u een experimentele optimalisatie in voor query's die kostbare zoekbewerkingen voor vrije tekst uitvoeren. Bijvoorbeeld \|where * has "pattern".
query_python_debug bool of int Als deze is ingesteld op true, genereert u een Python-foutopsporingsquery voor het opgesomde Python-knooppunt.
query_results_apply_getschema bool Als dit is ingesteld op true, haalt u het schema van elke tabelgegevens op in de resultaten van de query in plaats van de gegevens zelf.
query_results_cache_force_refresh bool Als deze optie is ingesteld op true, dwingt u een cachevernieuwing van queryresultaten voor een specifieke query af. Moet worden gebruikt in combinatie met query_results_cache_max_ageen verzonden via Kusto Data ClientRequestProperties-klasse, niet als een set-instructie.
query_results_cache_max_age timespan Hiermee bepaalt u de maximale leeftijd van de queryresultaten in de cache die door de service mogen worden geretourneerd.
query_results_cache_per_shard bool Als deze optie is ingesteld op true, schakelt u per omvang querycache in.
query_results_progressive_row_count long Biedt een hint voor het aantal records dat in elke update moet worden verzonden. Wordt alleen van kracht als results_progressive_enabled is ingesteld.
query_results_progressive_update_period timespan Biedt een hint voor hoe vaak voortgangsframes moeten worden verzonden. Wordt alleen van kracht als results_progressive_enabled is ingesteld.
query_take_max_records long Hiermee worden queryresultaten beperkt tot een opgegeven aantal records.
query_weakconsistency_session_id string Hiermee stelt u de sessie-id voor zwakke consistentiequery's in. Wordt van kracht wanneer queryconsistency modus is ingesteld op weakconsistency_by_session_id. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
queryconsistency string Bepaalt de consistentie van query's. Ondersteunde waarden zijn strongconsistency, weakconsistency, weakconsistency_by_query, weakconsistency_by_databaseof weakconsistency_by_session_id. Wanneer u weakconsistency_by_session_idgebruikt, moet u ook de eigenschap query_weakconsistency_session_id instellen. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
request_app_name string Hiermee geeft u de naam van de aanvraagtoepassing moet worden gebruikt in rapportage. Bijvoorbeeld .show query's. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
request_block_row_level_security bool Als dit is ingesteld op true, blokkeert u de toegang tot tabellen met beveiliging op rijniveau beleid ingeschakeld.
request_callout_disabled bool Als dit is ingesteld op true, voorkomt u het bijschrift van aanvragen voor een door de gebruiker geleverde service.
request_description string Hiermee staat u het opnemen van willekeurige tekst toe als de beschrijving van de aanvraag.
request_external_data_disabled bool Als deze optie is ingesteld op true, voorkomt u dat de aanvraag toegang heeft tot externe gegevens met behulp van de externaldata-operator of externe tabellen.
request_external_table_disabled bool Als deze optie is ingesteld op true, voorkomt u dat de aanvraag toegang heeft tot externe tabellen.
request_impersonation_disabled bool Als deze optie is ingesteld op true, geeft u aan dat de service de identiteit van de beller niet mag imiteren.
request_readonly bool Als deze optie is ingesteld op true, voorkomt u schrijftoegang voor de aanvraag. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
request_readonly_hardline bool Als deze optie is ingesteld op true, werkt de aanvraag in een strikte modus met het kenmerk Alleen-lezen. De aanvraag kan niets schrijven en alle niet-compatibele functionaliteit, zoals invoegtoepassingen, zijn uitgeschakeld. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
request_remote_entities_disabled bool Als deze optie is ingesteld op true, voorkomt u dat de aanvraag toegang heeft tot externe databases en externe entiteiten.
request_sandboxed_execution_disabled bool Als deze optie is ingesteld op true, voorkomt u dat de aanvraag code in de sandbox aanroept.
request_user string Hiermee geeft u de aanvraaggebruiker moet worden gebruikt in rapportage. Bijvoorbeeld .show query's. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
results_error_reporting_placement string Bepaalt de plaatsing van fouten in de resultatenset. Opties zijn in_data, end_of_tableen end_of_dataset.
results_progressive_enabled bool Als deze optie is ingesteld op true, schakelt u de progressieve querystroom in. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
results_v2_fragment_primary_tables bool Zorgt ervoor dat primaire tabellen in meerdere fragmenten worden verzonden, elk met een subset van de rijen. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
results_v2_newlines_between_frames bool Voegt nieuwe lijnen toe tussen frames in de resultaten om ze gemakkelijker te parseren.
servertimeout timespan Hiermee wordt de standaardtime-out van de aanvraag overschreven. Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie. Wijzig in plaats daarvan de optie met behulp van de dashboardinstellingen.
truncation_max_records long Hiermee wordt het standaard maximum aantal records overschreven dat een query mag terugkeren naar de aanroeper (afkapping).
truncationmaxsize long Hiermee wordt de standaard maximale gegevensgrootte overschreven die een query mag retourneren naar de aanroeper (afkapping). Deze optie kan niet worden gewijzigd als onderdeel van een set-instructie.
validatepermissions bool Valideert de machtigingen van de gebruiker om de query uit te voeren zonder de query daadwerkelijk uit te voeren. Mogelijke resultaten voor deze eigenschap zijn: OK (machtigingen zijn aanwezig en geldig), Incomplete (validatie kan niet worden voltooid vanwege dynamische schema-evaluatie) of KustoRequestDeniedException (machtigingen zijn niet ingesteld).

Aanvraageigenschappen instellen

U kunt aanvraageigenschappen op de volgende manieren instellen:

Notitie

De volgende aanvraageigenschappen kunnen niet worden ingesteld met een set-instructie:

  • 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

Notitie

Verwante inhoud