Sdílet prostřednictvím

Vlastnosti požadavku

  • Článek

Platí pro: ✅Microsoft Fabric✅Azure Data Explorer

Vlastnosti požadavku určují, jak se dotaz nebo příkaz spouští a vrací výsledky.

Podporované vlastnosti žádosti

Následující tabulka obsahuje přehled podporovaných vlastností žádosti.

Poznámka:

Vlastnosti query_weakconsistency_session_id žádosti a queryconsistency nejsou v fabicu k dispozici.

Název vlastnosti Type Popis
best_effort bool Pokud je truetato možnost nastavená, umožňuje řešení přibližných shod a problémy s připojením zdrojů dat (sjednocovací nohy).) Sada sjednocovací zdroje je omezena na sadu odkazů na tabulky, které existují a jsou přístupné v době provádění. Pokud se najde aspoň jedna přístupná tabulka, dotaz se spustí. Při selhání se ve výsledcích stavu dotazu zobrazí upozornění, ale nezabrání tomu, aby se dotaz spouštěl.
client_max_redirect_count long Řídí maximální počet přesměrování HTTP klienta během zpracování.
client_results_reader_allow_varying_row_widths bool Pokud je truetato možnost nastavená, čtenář výsledků toleruje tabulky, jejichž šířka řádku se v řádcích liší.
deferpartialqueryfailures bool Pokud je nastavená hodnota true, potlačí hlášení o částečných selháních dotazů v rámci sady výsledků.
materialized_view_shuffle_query dynamic Poskytuje nápovědu k použití strategie náhodného prohazování pro odkazovaná materializovaná zobrazení v dotazu. Tato vlastnost má výhradní vliv na materializovaná zobrazení a ne na žádné následné operace, například spojení, v rámci dotazu. Vezme pole materializovaných názvů zobrazení a jejich odpovídající klíče prohazování.

Označuje například dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) zobrazení V1 prohazování podle kláves K1 a K2při dynamic([ { "Name": "V1" } ]) náhodném prohazování V1 podle všech klíčů.
max_memory_consumption_per_query_per_node long Přepíše výchozí maximální velikost paměti, kterou může dotaz přidělit na uzel.
maxmemoryconsumptionperiterator long Přepíše výchozí maximální velikost paměti, kterou může operátor dotazu přidělit.
maxoutputcolumns long Přepíše výchozí maximální počet sloupců, které může dotaz vytvořit.
norequesttimeout bool Nastaví časový limit požadavku na maximální hodnotu. Tuto možnost nelze upravit jako součást příkazu set.
notruncation bool Zakáže zkrácení výsledků dotazu vrácených volajícímu.
push_selection_through_aggregation bool Pokud je nastavená hodnota true, umožňuje nabízení jednoduchého výběru prostřednictvím agregace.
query_bin_auto_at literal Určuje počáteční hodnotu, kterou se má použít při vyhodnocování funkce bin_auto().
query_bin_auto_size literal Určuje hodnotu velikosti přihrádky, kterou se má použít při vyhodnocování funkce bin_auto().
query_cursor_after_default string Nastaví výchozí hodnotu parametru pro funkci cursor_after() při zavolání bez parametrů.
query_cursor_before_or_at_default string Nastaví výchozí hodnotu parametru pro funkci cursor_before_or_at() při zavolání bez parametrů.
query_cursor_current string Přepíše hodnotu kurzoru vrácenou funkcí cursor_current().
query_cursor_disabled bool Zakáže použití funkcí kurzoru v kontextu dotazu.
query_cursor_scoped_tables dynamic Uvádí názvy tabulek, které mají být vymezeny na cursor_after_default .. cursor_before_or_at() (horní mez je volitelná).
query_datascope string Řídí data, na která se dotaz vztahuje. Podporované hodnoty jsou default, allnebo hotcache.
query_datetimescope_column string Určuje název sloupce pro obor data a času dotazu (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from datetime Nastaví minimální omezení data a času pro obor dotazu. Pokud je definováno, slouží jako automaticky použitý filtr query_datetimescope_column.
query_datetimescope_to datetime Nastaví maximální limit data a času pro obor dotazu. Pokud je definováno, slouží jako automaticky použitý filtr query_datetimescope_column.
query_distribution_nodes_span int Řídí chování sloučení poddotazů. Prováděcí uzel zavádí v hierarchii dotazů další úroveň pro každou podskupinu uzlů a tato možnost nastaví velikost podskupiny.
query_fanout_nodes_percent int Určuje procento uzlů pro spuštění ventilátoru.
query_fanout_threads_percent int Určuje procento vláken pro spuštění ventilátoru.
query_force_row_level_security bool Pokud je nastavená hodnota true, vynucuje pravidla zabezpečení na úrovni řádků, i když je zásada zakázaná.
query_language string Určuje, jak má být text dotazu interpretován. Podporované hodnoty jsou csl, kqlnebo sql. Tuto možnost nelze upravit jako součást příkazu set.
query_log_query_parameters bool Povolí protokolování parametrů dotazu pro pozdější zobrazení v deníku dotazů .show.
query_max_entities_in_union long Přepíše výchozí maximální počet sloupců, které může dotaz vytvořit.
query_now datetime Přepíše hodnotu datetime vrácenou funkcí now().
query_optimize_fts_at_relop bool Pokud je tato možnost nastavená na true, umožňuje experimentální optimalizaci pro dotazy, které provádějí nákladné operace bezplatného vyhledávání textu. Například \|where * has "pattern".
query_python_debug bool nebo int Pokud je nastavená hodnota true, vygeneruje ladicí dotaz Pythonu pro výčtový uzel Pythonu.
query_results_apply_getschema bool Pokud je nastavená hodnota true, načte schéma jednotlivých tabulkových dat ve výsledcích dotazu místo samotných dat.
query_results_cache_force_refresh bool Pokud je nastavená hodnota true, vynutí aktualizaci výsledků dotazu do mezipaměti pro konkrétní dotaz. Musí být použita v kombinaci s query_results_cache_max_agea odeslána prostřednictvím Kusto Data ClientRequestProperties třídy, ne jako set příkaz.
query_results_cache_max_age timespan Určuje maximální stáří výsledků dotazu v mezipaměti, které může služba vrátit.
query_results_cache_per_shard bool Pokud je nastavená hodnota true, povolí ukládání dotazů do mezipaměti v rozsahu .
query_results_progressive_row_count long Poskytuje nápovědu pro počet záznamů, které se mají odeslat v každé aktualizaci. Projeví se pouze v případě, že results_progressive_enabled je nastavena.
query_results_progressive_update_period timespan Poskytuje nápovědu k tomu, jak často se mají posílat snímky průběhu. Projeví se pouze v případě, že results_progressive_enabled je nastavena.
query_take_max_records long Omezí výsledky dotazu na zadaný počet záznamů.
query_weakconsistency_session_id string Nastaví ID relace slabé konzistence dotazu. Projeví se, když queryconsistency je režim nastavený na weakconsistency_by_session_id. Tuto možnost nelze upravit jako součást příkazu set.
queryconsistency string Řídí konzistenci dotazů. Podporované hodnoty jsou strongconsistency, , weakconsistency, weakconsistency_by_databaseweakconsistency_by_query, nebo weakconsistency_by_session_id. Při použití weakconsistency_by_session_idnezapomeňte také nastavit query_weakconsistency_session_id vlastnost. Tuto možnost nelze upravit jako součást příkazu set.
request_app_name string Určuje název aplikace požadavku, který se má použít při vytváření sestav. Například .show dotazy. Tuto možnost nelze upravit jako součást příkazu set.
request_block_row_level_security bool Pokud je nastavená hodnota true, zablokuje přístup k tabulkám s povolenými zásadami zabezpečení na úrovni řádků.
request_callout_disabled bool Pokud je nastavená hodnota true, zabrání popisku požadavku na službu poskytovanou uživatelem.
request_description string Umožňuje zahrnutí libovolného textu jako popisu požadavku.
request_external_data_disabled bool Pokud je nastavená hodnota true, zabrání požadavku v přístupu k externím datům pomocí operátoru externaldata nebo externích tabulek.
request_external_table_disabled bool Pokud je nastavená hodnota true, zabrání požadavku v přístupu k externím tabulkám.
request_impersonation_disabled bool Pokud je nastavená hodnota true, znamená to, že by služba neměla zosobnit identitu volajícího.
request_readonly bool Pokud je nastavená hodnota true, zabrání zápisu pro požadavek. Tuto možnost nelze upravit jako součást příkazu set.
request_readonly_hardline bool Pokud je nastavená hodnota true, požadavek funguje v přísném režimu jen pro čtení. Požadavek nemůže napsat nic a všechny nekompatibilní funkce, jako jsou moduly plug-in, jsou zakázané. Tuto možnost nelze upravit jako součást příkazu set.
request_remote_entities_disabled bool Pokud je nastavená hodnota true, zabrání požadavku v přístupu ke vzdáleným databázím a vzdáleným entitám.
request_sandboxed_execution_disabled bool Pokud je nastavená hodnota true, zabrání požadavku v vyvolání kódu v sandboxu.
request_user string Určuje uživatele požadavku, který se má použít při vytváření sestav. Například .show dotazy. Tuto možnost nelze upravit jako součást příkazu set.
results_error_reporting_placement string Určuje umístění chyb v sadě výsledků. Možnosti jsou in_data, end_of_tablea end_of_dataset.
results_progressive_enabled bool Pokud je nastavená hodnota true, povolí progresivní datový proud dotazu. Tuto možnost nelze upravit jako součást příkazu set.
results_v2_fragment_primary_tables bool Způsobí odeslání primárních tabulek v několika fragmentech, z nichž každá obsahuje podmnožinu řádků. Tuto možnost nelze upravit jako součást příkazu set.
results_v2_newlines_between_frames bool Přidá nové řádky mezi snímky ve výsledcích, aby bylo snazší je analyzovat.
servertimeout timespan Přepíše výchozí časový limit požadavku. Tuto možnost nelze upravit jako součást příkazu set. Místo toho upravte možnost pomocí nastavení řídicího panelu.
truncation_max_records long Přepíše výchozí maximální počet záznamů, které může dotaz vrátit do volajícího (zkrácení).
truncationmaxsize long Přepíše výchozí maximální velikost dat, která dotaz může vrátit do volajícího (zkrácení). Tuto možnost nelze upravit jako součást příkazu set.
validatepermissions bool Ověří oprávnění uživatele k provedení dotazu bez skutečného spuštění dotazu. Možné výsledky pro tuto vlastnost jsou: OK (oprávnění jsou přítomná a platná), Incomplete (ověření se nepodařilo dokončit kvůli dynamickému vyhodnocení schématu) nebo KustoRequestDeniedException (oprávnění nebyla nastavena).

Jak nastavit vlastnosti požadavku

Vlastnosti požadavku můžete nastavit následujícími způsoby:

Poznámka:

Následující vlastnosti požadavku nelze nastavit pomocí příkazu 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

Poznámka:

Související obsah