共用方式為

要求屬性

  • 發行項

適用於： ✅Microsoft網狀架構✅Azure 數據總管

要求屬性會控制查詢或命令的執行方式，並傳回結果。

支援的要求屬性

下表概觀支援的要求屬性。

注意

要求屬性 query_weakconsistency_session_id 和 queryconsistency 無法在 Fabic 中使用。

屬性名稱 類型​ 描述
best_effort bool 如果設定為 true，則允許數據源的模糊解決和聯機問題（聯集腿）。聯集來源集合會縮減為一組存在且在執行時可存取的數據表參考。 如果找到至少一個可存取數據表，查詢就會執行。 任何失敗都會產生查詢狀態結果中的警告，但不會防止查詢執行。
client_max_redirect_count long 控制客戶端在處理期間所遵循的 HTTP 重新導向數目上限。
client_results_reader_allow_varying_row_widths bool 如果設定為 true，結果讀取器會容許數據列寬度因數據列而異的數據表。
deferpartialqueryfailures bool 如果設定為 true，則會隱藏結果集中部分查詢失敗的報告。
materialized_view_shuffle_query dynamic 提供提示，以針對查詢中參考的具體化檢視使用隨機策略。 此屬性只會影響具體化檢視，而不會影響查詢內的任何後續作業，例如聯結。 它會採用具體化檢視名稱及其對應的隨機索引鍵數位。

例如，dynamic([{ "Name": "V1", "Keys" : [ "K1", "K2" ] }])會依索引鍵K1和 K2表示隨機檢視，而dynamic([ { "Name": "V1" } ])隨機檢視V1V1則表示所有索引鍵。
max_memory_consumption_per_query_per_node long 覆寫查詢可為每個節點配置的預設記憶體數量上限。
maxmemoryconsumptionperiterator long 覆寫查詢運算符可以配置的預設記憶體數量上限。
maxoutputcolumns long 覆寫允許查詢產生的預設數據行數目上限。
norequesttimeout bool 將要求逾時設定為其最大值。 此選項無法修改為 set 語句的一部分。
notruncation bool 停用傳回給呼叫端的查詢結果截斷。
push_selection_through_aggregation bool 如果設定為 true，則允許透過匯總推送簡單的選取範圍。
query_bin_auto_at literal 指定評估 bin_auto（） 函式時要使用的開始值。
query_bin_auto_size literal 指定評估 bin_auto（） 函式時要使用的 bin 大小值。
query_cursor_after_default string 在沒有參數的情況下呼叫時， 設定 cursor_after（） 函式的預設參數值。
query_cursor_before_or_at_default string 在沒有參數的情況下呼叫時， 設定 cursor_before_or_at（） 函式的預設參數值。
query_cursor_current string 覆寫 cursor_current（） 函式所傳回的數據指標值。
query_cursor_disabled bool 停用查詢內容中的數據指標函式使用方式。
query_cursor_scoped_tables dynamic 列出要限定為 cursor_after_default .的數據表名稱。 cursor_before_or_at() （上限為選擇性）。
query_datascope string 控制查詢套用的數據。 支援的值為 default、 all或 hotcache。
query_datetimescope_column string 指定查詢日期時間範圍 （query_datetimescope_to / query_datetimescope_from） 的資料列名稱。
query_datetimescope_from datetime 設定查詢範圍的最小日期和時間限制。 如果已定義，它會做為 上的 query_datetimescope_column自動套用篩選。
query_datetimescope_to datetime 設定查詢範圍的最大日期和時間限制。 如果已定義，它會做為 上的 query_datetimescope_column自動套用篩選。
query_distribution_nodes_span int 控制子查詢合併的行為。 執行中的節點會在每個節點子群組的查詢階層中引進額外的層級，而此選項會設定子群組大小。
query_fanout_nodes_percent int 指定執行展開傳送的節點百分比。
query_fanout_threads_percent int 指定執行展開傳送的線程百分比。
query_force_row_level_security bool 如果設定為 true，則會強制執行 數據列層級安全性 規則，即使原則已停用也一樣。
query_language string 決定查詢文字的解譯方式。 支援的值為 csl、 kql或 sql。 此選項無法修改為 set 語句的一部分。
query_log_query_parameters bool 啟用查詢參數記錄，以便稍後在 .show 查詢日誌中檢視。
query_max_entities_in_union long 覆寫允許查詢產生的預設數據行數目上限。
query_now datetime 覆寫 now（） 函式所傳回的 datetime 值。
query_optimize_fts_at_relop bool 當設定為 true時，會針對執行成本高昂的任意文字搜尋作業的查詢啟用實驗性優化。 例如 \|where * has "pattern"。
query_python_debug bool 或 int 如果設定為 true，則會產生列舉 Python 節點的 Python 偵錯查詢。
query_results_apply_getschema bool 如果設定為 true，則會擷取查詢結果中每個表格式數據的架構，而不是數據本身。
query_results_cache_force_refresh bool 如果設定為 true，則會強制對特定查詢的查詢結果進行快取重新整理。 必須與 搭配 query_results_cache_max_age使用，並且透過 Kusto Data ClientRequestProperties 類別傳送，而不是做為 set 語句。
query_results_cache_max_age timespan 控制允許服務傳回之快取查詢結果的最長存留期。
query_results_cache_per_shard bool 如果設定為 true，則會啟用範圍查詢快取。
query_results_progressive_row_count long 提供每個更新中要傳送多少筆記錄的提示。 只有在設定時 results_progressive_enabled 才會生效。
query_results_progressive_update_period timespan 提供傳送進度畫面的頻率提示。 只有在設定時 results_progressive_enabled 才會生效。
query_take_max_records long 將查詢結果限製為指定的記錄數目。
query_weakconsistency_session_id string 設定查詢弱式一致性會話標識碼。 當模式設定為weakconsistency_by_session_id時queryconsistency生效。 此選項無法修改為 set 語句的一部分。
queryconsistency string 控制查詢一致性。 支援的值為 strongconsistency、、weakconsistencyweakconsistency_by_query、 weakconsistency_by_database或 weakconsistency_by_session_id。 使用 weakconsistency_by_session_id時，請確定也設定 query_weakconsistency_session_id 屬性。 此選項無法修改為 set 語句的一部分。
request_app_name string 指定要用於報告的要求應用程式名稱。 例如， .show 查詢。 此選項無法修改為 set 語句的一部分。
request_block_row_level_security bool 如果設定為 true，則會封鎖已啟用數據列層級安全策略的數據表存取。
request_callout_disabled bool 如果設定為 true，則會防止要求使用者提供服務的圖說文字。
request_description string 允許以要求描述的形式包含任意文字。
request_external_data_disabled bool 如果設定為 true，則防止要求使用 externaldata 運算符或外部資料表存取外部數據。
request_external_table_disabled bool 如果設定為 true，則防止要求存取外部數據表。
request_impersonation_disabled bool 如果設定為 true，表示服務不應該模擬呼叫端的身分識別。
request_readonly bool 如果設定為 true，則會防止要求的寫入存取權。 此選項無法修改為 set 語句的一部分。
request_readonly_hardline bool 如果設定為 true，則要求會以嚴格的唯讀模式運作。 要求無法寫入任何專案，而且會停用任何不相容的功能，例如外掛程式。 此選項無法修改為 set 語句的一部分。
request_remote_entities_disabled bool 如果設定為 true，則防止要求存取遠端資料庫和遠端實體。
request_sandboxed_execution_disabled bool 如果設定為 true，則防止要求在沙箱中叫用程序代碼。
request_user string 指定要用於報告的要求使用者。 例如， .show 查詢。 此選項無法修改為 set 語句的一部分。
results_error_reporting_placement string 決定結果集中的錯誤位置。 選項為 in_data、end_of_table 和 end_of_dataset。
results_progressive_enabled bool 如果設定為 true，則會啟用漸進式查詢數據流。 此選項無法修改為 set 語句的一部分。
results_v2_fragment_primary_tables bool 讓主數據表在多個片段中傳送，每個片段都包含數據列的子集。 此選項無法修改為 set 語句的一部分。
results_v2_newlines_between_frames bool 在結果中新增框架之間的新行，以便更輕鬆地剖析它們。
servertimeout timespan 覆寫預設要求逾時。 此選項無法修改為 set 語句的一部分。 請改用儀錶板設定來修改 選項。
truncation_max_records long 覆寫允許查詢傳回給呼叫端的默認記錄數目上限（截斷）。
truncationmaxsize long 覆寫允許查詢傳回給呼叫端的預設數據大小上限（截斷）。 此選項無法修改為 set 語句的一部分。
validatepermissions bool 驗證使用者執行查詢的許可權，而不需要實際執行查詢。 此屬性的可能結果包括： OK （許可權存在且有效）、（由於動態架構評估而無法完成驗證）， Incomplete 或 KustoRequestDeniedException （未設定許可權）。

如何設定要求屬性

您可以透過下列方式設定要求屬性：

注意

下列要求屬性無法使用 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

注意

相關內容