Właściwości żądania

Dotyczy: ✅Microsoft Fabric✅Azure Data Explorer

Żądanie właściwości kontroluje sposób wykonywania zapytania lub polecenia i zwraca wyniki.

Obsługiwane właściwości żądania

W poniższej tabeli omówiono obsługiwane właściwości żądania.

Uwaga

Właściwości query_weakconsistency_session_id żądania i queryconsistency nie są dostępne w systemie Fabic.

Nazwa właściwości	Typ	Opis
best_effort	bool	Jeśli jest ustawiona wartość true, umożliwia rozwiązanie rozmyte i problemy z łącznością źródeł danych (nogi unii). Zestaw źródeł unii jest zredukowany do zestawu odwołań do tabeli, które istnieją i są dostępne w czasie wykonywania. Jeśli zostanie znaleziona co najmniej jedna dostępna tabela, zapytanie zostanie wykonane. Wszelkie błędy dają ostrzeżenie w wynikach stanu zapytania, ale nie uniemożliwia wykonywania zapytania.
client_max_redirect_count	long	Określa maksymalną liczbę przekierowań HTTP, które następuje po kliencie podczas przetwarzania.
client_results_reader_allow_varying_row_widths	bool	Jeśli ustawiono wartość true, czytnik wyników toleruje tabele, których szerokość wiersza różni się w różnych wierszach.
deferpartialqueryfailures	bool	Jeśli ustawiono wartość true, pomija raportowanie częściowych niepowodzeń zapytań w zestawie wyników.
materialized_view_shuffle_query	dynamic	Zawiera wskazówkę dotyczącą używania strategii mieszania dla zmaterializowanych widoków w zapytaniu. Ta właściwość ma wyłączny wpływ na zmaterializowane widoki, a nie na żadne kolejne operacje, takie jak sprzężenia, w zapytaniu. Przyjmuje ona tablicę zmaterializowanych nazw widoków i odpowiadających im kluczy mieszania. Na przykład dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }]) wskazuje widok mieszania według kluczy K1 i K2, podczas gdy dynamic([ { "Name": "V1" } ]) tasuje V1 widok V1 według wszystkich kluczy.
max_memory_consumption_per_query_per_node	long	Zastępuje domyślną maksymalną ilość pamięci, którą zapytanie może przydzielić na węzeł.
maxmemoryconsumptionperiterator	long	Zastępuje domyślną maksymalną ilość pamięci, którą może przydzielić operator zapytania.
maxoutputcolumns	long	Zastępuje domyślną maksymalną liczbę kolumn, które może utworzyć zapytanie.
norequesttimeout	bool	Ustawia limit czasu żądania na wartość maksymalną. Tej opcji nie można zmodyfikować w ramach instrukcji set.
notruncation	bool	Wyłącza obcinanie wyników zapytania zwróconych do obiektu wywołującego.
push_selection_through_aggregation	bool	Jeśli jest ustawiona wartość true, umożliwia wypychanie prostego wyboru przez agregację.
query_bin_auto_at	literal	Określa wartość początkową, która ma być używana podczas oceniania funkcji bin_auto().
query_bin_auto_size	literal	Określa wartość rozmiaru pojemnika do użycia podczas oceniania funkcji bin_auto().
query_cursor_after_default	string	Ustawia domyślną wartość parametru dla funkcji cursor_after(), gdy jest wywoływana bez parametrów.
query_cursor_before_or_at_default	string	Ustawia domyślną wartość parametru dla funkcji cursor_before_or_at(), gdy jest wywoływana bez parametrów.
query_cursor_current	string	Zastępuje wartość kursora zwróconą przez funkcję cursor_current().
query_cursor_disabled	bool	Wyłącza użycie funkcji kursora w kontekście zapytania.
query_cursor_scoped_tables	dynamic	Wyświetla listę nazw tabel, które mają być ograniczone do cursor_after_default .. cursor_before_or_at() (górna granica jest opcjonalna).
query_datascope	string	Określa dane, do których ma zastosowanie zapytanie. Obsługiwane wartości to default, alllub hotcache.
query_datetimescope_column	string	Określa nazwę kolumny dla zakresu daty i godziny zapytania (query_datetimescope_to / query_datetimescope_from).
query_datetimescope_from	datetime	Ustawia minimalny limit daty i godziny dla zakresu zapytania. Jeśli jest zdefiniowana, służy jako filtr automatycznie zastosowany w pliku query_datetimescope_column.
query_datetimescope_to	datetime	Ustawia maksymalny limit daty i godziny dla zakresu zapytania. Jeśli jest zdefiniowana, służy jako filtr automatycznie zastosowany w pliku query_datetimescope_column.
query_distribution_nodes_span	int	Steruje zachowaniem scalania podzapytania. Węzeł wykonujący wprowadza dodatkowy poziom w hierarchii zapytań dla każdej podgrupy węzłów, a ta opcja ustawia rozmiar podgrupy.
query_fanout_nodes_percent	int	Określa wartość procentową węzłów do wykonywania wentylatora.
query_fanout_threads_percent	int	Określa procent wątków do wykonywania wentylatora.
query_force_row_level_security	bool	Jeśli ustawiono wartość true, wymusza reguły zabezpieczeń na poziomie wiersza, nawet jeśli zasady są wyłączone.
query_language	string	Określa sposób interpretowania tekstu zapytania. Obsługiwane wartości to csl, kqllub sql. Tej opcji nie można zmodyfikować w ramach instrukcji set.
query_log_query_parameters	bool	Włącza rejestrowanie parametrów zapytań w celu późniejszego wyświetlania w dzienniku zapytań .show.
query_max_entities_in_union	long	Zastępuje domyślną maksymalną liczbę kolumn, które może utworzyć zapytanie.
query_now	datetime	Zastępuje wartość daty/godziny zwróconą przez funkcję now().
query_optimize_fts_at_relop	bool	Po ustawieniu wartości truena wartość umożliwia eksperymentalną optymalizację zapytań, które wykonują kosztowne operacje wyszukiwania bez tekstu. Przykład: \|where * has "pattern".
query_python_debug	bool lub int	Jeśli ustawiono truewartość , generuje zapytanie debugowania języka Python dla wyliczonego węzła języka Python.
query_results_apply_getschema	bool	Jeśli ustawiono truewartość , pobiera schemat poszczególnych danych tabelarycznych w wynikach zapytania zamiast samych danych.
query_results_cache_force_refresh	bool	Jeśli ustawiono wartość true, wymusza odświeżanie pamięci podręcznej wyników zapytania dla określonego zapytania. Należy używać w połączeniu z elementami query_results_cache_max_agei wysyłanych za pośrednictwem klasy Kusto Data ClientRequestProperties, a nie jako instrukcji set.
query_results_cache_max_age	timespan	Określa maksymalny wiek buforowanych wyników zapytań, które usługa może zwrócić.
query_results_cache_per_shard	bool	Jeśli ustawiono wartość true, włącza buforowanie zapytań w zakresie .
query_results_progressive_row_count	long	Zawiera wskazówkę dotyczącą liczby rekordów do wysłania w każdej aktualizacji. Działa tylko wtedy, gdy results_progressive_enabled jest ustawiona.
query_results_progressive_update_period	timespan	Zawiera wskazówkę dotyczącą częstotliwości wysyłania ramek postępu. Działa tylko wtedy, gdy results_progressive_enabled jest ustawiona.
query_take_max_records	long	Ogranicza wyniki zapytania do określonej liczby rekordów.
query_weakconsistency_session_id	string	Ustawia identyfikator sesji słabej spójności zapytania. Ma zastosowanie, gdy queryconsistency tryb jest ustawiony na weakconsistency_by_session_id. Tej opcji nie można zmodyfikować w ramach instrukcji set.
queryconsistency	string	Steruje spójnością zapytań. Obsługiwane wartości to strongconsistency, , weakconsistency, weakconsistency_by_query, weakconsistency_by_databaselub weakconsistency_by_session_id. W przypadku korzystania z weakconsistency_by_session_idelementu upewnij się, że właściwość jest również ustawiona query_weakconsistency_session_id . Tej opcji nie można zmodyfikować w ramach instrukcji set.
request_app_name	string	Określa nazwę aplikacji żądania, która ma być używana w raportowaniu. Na przykład .show queries (Pokaż zapytania). Tej opcji nie można zmodyfikować w ramach instrukcji set.
request_block_row_level_security	bool	Jeśli ustawiono wartość true, blokuje dostęp do tabel z włączonymi zasadami zabezpieczeń na poziomie wiersza.
request_callout_disabled	bool	Jeśli jest ustawiona wartość true, uniemożliwia wywołanie żądania do usługi dostarczonej przez użytkownika.
request_description	string	Umożliwia dołączenie dowolnego tekstu jako opisu żądania.
request_external_data_disabled	bool	Jeśli jest ustawiona wartość true, uniemożliwia żądaniu uzyskiwanie dostępu do danych zewnętrznych przy użyciu operatora externaldata lub tabel zewnętrznych.
request_external_table_disabled	bool	Jeśli jest ustawiona wartość true, uniemożliwia żądaniu uzyskiwanie dostępu do tabel zewnętrznych.
request_impersonation_disabled	bool	Jeśli ustawiono wartość true, wskazuje, że usługa nie powinna personifikować tożsamości osoby wywołującej.
request_readonly	bool	Jeśli ustawiono wartość true, uniemożliwia dostęp do zapisu dla żądania. Tej opcji nie można zmodyfikować w ramach instrukcji set.
request_readonly_hardline	bool	Jeśli jest ustawiona wartość true, żądanie działa w trybie tylko do odczytu. Żądanie nie może napisać niczego, a wszystkie niezgodne funkcje, takie jak wtyczki, są wyłączone. Tej opcji nie można zmodyfikować w ramach instrukcji set.
request_remote_entities_disabled	bool	Jeśli jest ustawiona wartość true, uniemożliwia żądaniu uzyskiwanie dostępu do zdalnych baz danych i jednostek zdalnych.
request_sandboxed_execution_disabled	bool	Jeśli ustawiono truewartość , uniemożliwia wywołanie kodu w piaskownicy przez żądanie.
request_user	string	Określa użytkownika żądania, który ma być używany w raportowaniu. Na przykład .show queries (Pokaż zapytania). Tej opcji nie można zmodyfikować w ramach instrukcji set.
results_error_reporting_placement	string	Określa umieszczanie błędów w zestawie wyników. Opcje to in_data, end_of_tablei end_of_dataset.
results_progressive_enabled	bool	Jeśli jest ustawiona wartość true, włącza progresywny strumień zapytań. Tej opcji nie można zmodyfikować w ramach instrukcji set.
results_v2_fragment_primary_tables	bool	Powoduje wysyłanie tabel podstawowych w wielu fragmentach, z których każda zawiera podzbiór wierszy. Tej opcji nie można zmodyfikować w ramach instrukcji set.
results_v2_newlines_between_frames	bool	Dodaje nowe wiersze między ramkami w wynikach, aby ułatwić ich analizowanie.
servertimeout	timespan	Zastępuje domyślny limit czasu żądania. Tej opcji nie można zmodyfikować w ramach instrukcji set. Zamiast tego zmodyfikuj opcję przy użyciu ustawień pulpitu nawigacyjnego.
truncation_max_records	long	Zastępuje domyślną maksymalną liczbę rekordów, które zapytanie może wrócić do obiektu wywołującego (obcinanie).
truncationmaxsize	long	Zastępuje domyślny maksymalny rozmiar danych, który zapytanie może wrócić do obiektu wywołującego (obcinanie). Tej opcji nie można zmodyfikować w ramach instrukcji set.
validatepermissions	bool	Weryfikuje uprawnienia użytkownika do wykonywania zapytania bez faktycznego uruchamiania zapytania. Możliwe wyniki dla tej właściwości to: OK (uprawnienia są obecne i prawidłowe), Incomplete (nie można ukończyć walidacji z powodu dynamicznej oceny schematu) lub KustoRequestDeniedException (uprawnienia nie zostały ustawione).

Jak ustawić właściwości żądania

Właściwości żądania można ustawić na następujące sposoby:

• Treść POST żądania HTTP
• Instrukcja zestawu język zapytań Kusto
• Metoda ClientRequestProperties opcji zestawu klasy

Uwaga

Nie można ustawić następujących właściwości żądania za pomocą instrukcji 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

Powiązana zawartość

• Dostosowywanie zachowania zapytania za pomocą właściwości żądania klienta