Поделиться через

Свойства запроса

  • Статья

Область применения: ✅Microsoft Fabric✅Azure Data Explorer

Свойства запроса управляют выполнением запроса или команды и возвращают результаты.

Поддерживаемые свойства запроса

В следующей таблице приведены общие сведения о поддерживаемых свойствах запроса.

Примечание.

Свойства query_weakconsistency_session_id запроса и queryconsistency недоступны в Fabic.

Имя свойства Type Описание
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" ] }]) указывает на перетасовку представления V1 по ключам K1 и K2при dynamic([ { "Name": "V1" } ]) перемешивание V1 представлений по всем ключам.
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 литерал Указывает начальное значение, используемое при оценке функции bin_auto().
query_bin_auto_size литерал Указывает значение размера ячейки, используемое при оценке функции bin_auto().
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 Переопределяет значение datetime, возвращаемое функцией now().
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 Задает идентификатор сеанса слабой согласованности запроса. Вступает в силу при queryconsistency установке weakconsistency_by_session_idрежима. Этот параметр нельзя изменить как часть инструкции set.
queryconsistency string Управляет согласованностью запросов. Поддерживаемые значения: strongconsistency, , weakconsistency_by_databaseweakconsistencyweakconsistency_by_queryили 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

Примечание.

Связанный контент