매핑 데이터 흐름의 배열 함수
적용 대상: Azure Data Factory Azure Synapse Analytics
팁
기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!
데이터 흐름은 Azure Data Factory 및 Azure Synapse Pipelines 모두에서 사용할 수 있습니다. 이 문서는 매핑 데이터 흐름에 적용됩니다. 변환을 처음 사용하는 경우 매핑 데이터 흐름을 사용하여 데이터 변환 소개 문서를 참조하세요.
다음 문서에서는 Azure Data Factory 및 Azure Synapse Analytics에서 지원하는 매핑 데이터 흐름의 배열 함수에 관해 자세히 설명합니다.
배열 함수 목록
배열 함수는 배열 데이터 구조에 대한 변환을 수행합니다. 여기에는 배열 요소 및 인덱스를 처리하기 위한 특수 키워드가 포함됩니다.
#acc
는 배열을 줄일 때 단일 출력에 포함하려는 값을 나타냅니다.#index
는 배열 인덱스 번호#index2, #index3 ...
와 함께 현재 배열 인덱스를 나타냅니다.#item
은 배열의 현재 요소 값을 나타냅니다.
배열 함수 | 작업 |
---|---|
array | 항목의 배열을 만듭니다. 모든 항목은 동일한 형식이어야 합니다. 항목을 지정하지 않으면 빈 문자열 배열이 기본값으로 지정됩니다. [] 생성 연산자와 동일합니다. |
at | 배열 인덱스에서 요소를 찾습니다. 인덱스는 1부터 시작합니다. 인덱스가 범위를 벗어나면 null 값이 발생합니다. 키가 지정된 맵에서 값을 찾습니다. 키를 찾을 수 없으면 null이 반환됩니다. |
contains | 제공된 배열의 요소가 제공된 조건자에서 true로 평가되면 true를 반환합니다. Contains는 조건자 함수의 한 요소에 대한 참조를 #item으로 예상합니다. |
distinct | 배열의 고유 항목 집합을 반환합니다. |
제외 | 삭제하는 다른 중복 항목에서 한 배열의 차이 집합을 반환합니다. |
filter | 제공된 조건자를 충족하지 않는 배열에서 요소를 필터링합니다. 필터는 조건자 함수의 한 요소에 대한 참조를 #item으로 예상합니다. |
find | 배열에서 조건과 일치하는 첫 번째 항목을 찾습니다. 배열 항목을 #item으로 지정할 수 있는 필터 함수가 필요합니다. 깊게 중첩된 맵의 경우 #item_n(# item_1, # item_2 ...) 표기법을 사용하여 상위 맵을 참조할 수 있습니다. |
flatten | 하나 이상의 배열을 단일 배열로 평면화합니다. 원자성 항목의 배열은 변경되지 않은 상태로 반환됩니다. 마지막 인수는 선택 사항이며 한 수준 깊이보다 더 재귀적으로 평면화하기 위해 기본적으로 false로 설정됩니다. |
in | 항목이 배열에 있는지 확인합니다. |
intersect | 2개 배열에서 고유 항목의 교차 집합을 반환합니다. |
map | 제공된 식을 사용하여 배열의 각 요소를 새 요소에 매핑합니다. 맵에는 #item으로 식 함수에서 하나의 요소에 대한 참조가 필요합니다. |
mapIf | 배열을 같거나 더 짧은 길이의 다른 배열에 조건부로 매핑합니다. 값은 structTypes을 포함한 모든 데이터 형식이 될 수 있습니다. 배열의 항목을 #item으로, 현재 인덱스를 #index로 지정할 수 있는 매핑 함수를 사용합니다. 깊게 중첩된 맵의 경우 #item_[n](#item_1, #index_1...) 표기법을 사용하여 부모 맵을 참조할 수 있습니다. |
mapIndex | 제공된 식을 사용하여 배열의 각 요소를 새 요소에 매핑합니다. 맵에는 #item으로 식 함수에서 하나의 요소에 대한 참조가 필요하며 #index로 요소 색인에 대한 참조가 필요합니다. |
mapLoop | 1에서 length까지 반복하여 해당 길이의 배열을 만듭니다. 배열의 인덱스를 #index로 지정할 수 있는 매핑 함수를 사용합니다. 깊게 중첩된 맵의 경우 #index_n(#index_1, #index_2...) 표기법을 사용하여 부모 맵을 참조할 수 있습니다. |
reduce | 배열에 요소를 누적합니다. Reduce는 #acc 및 #item으로 첫 번째 식 함수에서 누적기 및 하나의 요소에 대한 참조가 필요하며 두 번째 식 함수에 사용될 #result로 결과 값이 필요합니다. |
size | 배열 또는 맵 형식의 크기를 찾습니다. |
slice | 특정 위치에서 배열의 하위 세트를 추출합니다. 위치는 1부터 시작합니다. 길이를 생략하면 기본적으로 문자열 끝까지입니다. |
sort | 제공된 조건자 함수를 사용하여 배열을 정렬합니다. 정렬에는 #item1 및 #item2로 식 함수에서 두 개의 연속 요소에 대한 참조가 필요합니다. |
unfold | 배열을 행 세트로 펼치고 모든 행의 나머지 열에 대해 값을 반복합니다. |
union | 2개 배열에서 고유 항목의 합집합을 반환합니다. |
관련 콘텐츠
- 모든 집계 함수 목록입니다.
- 모든 캐시된 조회 함수 목록입니다.
- 모든 변환 함수 목록입니다.
- 모든 날짜 및 시간 함수 목록입니다.
- 모든 식 함수 목록입니다.
- 모든 맵 함수 목록입니다.
- 모든 메타함수 목록입니다.
- 모든 창 함수 목록입니다.
- 모든 데이터 변환 식의 사용량 세부 정보입니다.
- 식 작성기를 사용하는 방법을 알아보세요.