serialize 연산자
적용 대상: ✅Microsoft Fabric✅✅
입력 행 집합의 순서가 창 함수에 안전하게 사용되도록 표시합니다.
연산자에는 선언적 의미가 있습니다. 입력 행 집합을 직렬화(순서 지정)로 표시하여 창 함수를 적용할 수 있습니다.
구문
serialize [Name1=Expr1 [,Name2=Expr2]...]
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | Type | 필수 | 설명 |
|---|---|---|---|
| 이름 | string |
추가하거나 업데이트할 열의 이름입니다. 생략하면 출력 열 이름이 자동으로 생성됩니다. | |
| Expr | string |
✔️ | 입력을 통해 수행할 계산입니다. |
예제
이 섹션의 예제에서는 구문을 사용하여 시작하는 방법을 보여 주었습니다.
이 문서의 예제에서는 샘플 데이터베이스의
StormEvents테이블과 같은 도움말 클러스터공개적으로 사용할 수 있는 테이블을 사용합니다.
이 문서의 예제에서는 날씨 분석 샘플 데이터
StormEvents테이블과 같이 공개적으로 사용 가능한 테이블을 사용합니다.
조건별 행 하위 집합 직렬화
이 쿼리는 특정 ClientRequestId 있는 TraceLogs 테이블에서 모든 로그 항목을 검색하고 처리 중에 이러한 항목의 순서를 유지합니다.
TraceLogs
| where ClientRequestId == "5a848f70-9996-eb17-15ed-21b8eb94bf0e"
| serialize
출력
이 표에는 상위 5개 쿼리 결과만 표시됩니다.
| 타임 스탬프 | 노드 | 구성 요소 | ClientRequestId | 메시지 |
|---|---|---|---|---|
| 2014-03-08T12:24:55.5464757Z | Engine00000000757 | INGESTOR_GATEWAY | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | $$IngestionCommand table=fogEvents format=json |
| 2014-03-08T12:24:56.0929514Z | Engine00000000757 | 다운로더 (1) | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | 파일 경로 다운로드: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz"" |
| 2014-03-08T12:25:40.3574831Z | Engine00000000341 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 완료된 수집 파일 경로: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_0.json.gz"" |
| 2014-03-08T12:25:40.9039588Z | Engine00000000341 | 다운로더 (1) | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | 파일 경로 다운로드: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz"" |
| 2014-03-08T12:26:25.1684905Z | Engine00000000057 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 완료된 수집 파일 경로: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_1.json.gz"" |
| ... | ... | ... | ... | ... |
serialize된 테이블에 행 번호 추가
serialize된 테이블에 행 번호를 추가하려면 row_number() 함수를 사용합니다.
TraceLogs
| where ClientRequestId == "5a848f70-9996-eb17-15ed-21b8eb94bf0e"
| serialize rn = row_number()
출력
이 표에는 상위 5개 쿼리 결과만 표시됩니다.
| 타임 스탬프 | rn | 노드 | 구성 요소 | ClientRequestId | 메시지 |
|---|---|---|---|---|---|
| 2014-03-08T13:00:01.6638235Z | 1 | Engine00000000899 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 완료된 수집 파일 경로: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_46.json.gz"" |
| 2014-03-08T13:00:02.2102992Z | 2 | Engine00000000899 | 다운로더 (1) | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | 파일 경로 다운로드: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz"" |
| 2014-03-08T13:00:46.4748309Z | 3 | Engine00000000584 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 완료된 수집 파일 경로: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_47.json.gz"" |
| 2014-03-08T13:00:47.0213066Z | 4 | Engine00000000584 | 다운로더 (1) | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | 파일 경로 다운로드: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz"" |
| 2014-03-08T13:01:31.2858383Z | 5 | Engine00000000380 | INGESTOR_EXECUTER | 5a848f70-9996-eb17-15ed-21b8eb94bf0e | IngestionCompletionEvent: 완료된 수집 파일 경로: ""https://benchmarklogs3.blob.core.windows.net/benchmark/2014/IMAGINEFIRST0_1399_48.json.gz"" |
| ... | ... | ... | ... | ... |
연산자의 serialization 동작
다음 연산자의 출력 행 집합은 serialize된 것으로 표시됩니다.
다음 연산자의 출력 행 집합은 비직렬화됨으로 표시됩니다.
- count
- distinct
- 평가하다
- facet
- join
- make-series
- mv-expand
- reduce by
- sample
- sample-distinct
- summarize
- 맨 위 중첩
다른 모든 연산자는 serialization 속성을 유지합니다. 입력 행 집합이 serialize되면 출력 행 집합도 serialize됩니다.