.set stored_query_result 명령

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

최대 24시간 동안 서비스에 쿼리 결과를 저장하는 메커니즘을 설정합니다.

저장된 쿼리 결과 이름이 이미 있는 경우 실패합니다 .set . 대신 기존 저장된 쿼리 결과를 삭제하고 이름이 같은 새 쿼리 결과를 만드는 를 사용합니다 .set-or-replace.

사용 권한

이러한 명령을 실행하려면 데이터베이스 뷰어 권한이 있어야 합니다.

.set[async] stored_query_result StoredQueryResultName [with( PropertyName = PropertyValue [, ...]] <| )쿼리

.set-or-replace[async] stored_query_result StoredQueryResultName [with( PropertyName = PropertyValue [, ...]] <| )쿼리

이름	Type	필수	설명
`async`	`string`		지정하면 명령이 반환되고 백그라운드에서 수집을 계속합니다. 명령과 함께 반환 `OperationId` 된 `.show operations` 명령을 사용하여 수집 완료 상태 및 결과를 검색합니다.
StoredQueryResultName	`string`	✔️	엔터티 이름 규칙을 준수하는 저장된 쿼리 결과 이름 입니다.
PropertyName, PropertyValue	`string`		하나 이상의 지원되는 속성입니다.
쿼리	`string`	✔️	결과를 저장할 쿼리의 텍스트입니다.

속성	Type	설명
`expiresAfter`	`timespan`	저장된 쿼리 결과가 만료되는 시기를 결정합니다. 최대 24시간입니다.
`previewCount`	`int`	미리 보기로 반환할 행 수입니다. 이 속성을 `0` (기본값)로 설정하면 명령이 모든 쿼리 결과 행을 반환합니다. 모드를 사용하여 `async` 명령을 호출하면 속성이 무시됩니다.

"미리 보기" 또는 모든 레코드라고 하는 쿼리에서 생성된 레코드의 테이블 형식 하위 집합입니다. 반환에 표시되는 레코드 수에 관계없이 모든 레코드가 저장됩니다.

쿼리에서 문자가 포함된 엔터티 이름을 생성하면 명령이 $ 실패합니다. 엔터티 이름은 명명 규칙을 준수해야 하므로 수집 명령이 $ 성공하려면 문자를 제거해야 합니다.

예를 들어 다음 쿼리에서 연산자는 search 열을 $table생성합니다. 쿼리 결과를 저장하려면 프로젝트 이름 바꾸기를 사용하여 열의 이름을 바꿉니다 .

.set stored_query_result Texas <| search ['State']:'Texas' | project-rename tableName=$table

다음 예제에서는 라는 Numbers저장된 쿼리 결과를 만듭니다.

.set stored_query_result Numbers <| range X from 1 to 1000000 step 1

출력