요청 속성

적용 대상: ✅Microsoft Fabric✅Azure Data Explorer

요청 속성은 쿼리 또는 명령이 실행되고 결과를 반환하는 방법을 제어합니다.

지원되는 요청 속성

다음 표에서는 지원되는 요청 속성을 간략하게 설명합니다.

참고 항목

요청 속성 query_weakconsistency_session_id 이며 queryconsistency Fabic에서 사용할 수 없습니다.

Property name	형식	설명
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 나타내고K2, dynamic([ { "Name": "V1" } ]) 모든 키 K1 로 보기를 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	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하면 특정 쿼리에 대한 쿼리 결과의 캐시 새로 고침을 강제로 적용합니다. set 문이 아니라 Kusto Data ClientRequestProperties 클래스를 통해 전송되는 것과 함께 query_results_cache_max_age사용해야 합니다.
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	쿼리 약한 일관성 세션 ID를 설정합니다. 모드가 .로 설정된 경우 queryconsistency 적용됩니다 weakconsistency_by_session_id. 이 옵션은 set 문의 일부로 수정할 수 없습니다.
queryconsistency	string	쿼리 일관성을 제어합니다. 지원되는 값은 strongconsistency, weakconsistency, weakconsistency_by_databaseweakconsistency_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설정하면 서비스에서 호출자의 ID를 가장해서는 안 되었음을 나타냅니다.
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 (사용 권한이 설정되지 않음)

요청 속성을 설정하는 방법

다음과 같은 방법으로 요청 속성을 설정할 수 있습니다.

• HTTP 요청의 POST 본문
• Kusto 쿼리 언어 set 문
• 클래스의 ClientRequestProperties set 옵션 메서드

참고 항목

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

관련 콘텐츠

• 클라이언트 요청 속성을 사용하여 쿼리 동작 사용자 지정