다음을 통해 공유


매핑 데이터 흐름의 배열 함수

적용 대상: Azure Data Factory Azure Synapse Analytics

기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아보세요!

데이터 흐름은 Azure Data Factory 파이프라인과 Azure Synapse Analytics 파이프라인 모두에서 사용할 수 있습니다. 이 문서는 매핑 데이터 흐름에 적용됩니다. 변환을 접하는 경우 매핑 데이터 흐름을 사용하여 데이터 변환 소개 문서를 참조하세요.

이 문서에서는 매핑 데이터 흐름에서 Azure Data Factory 및 Azure Synapse Analytics에서 지원하는 배열 함수에 대해 자세히 설명합니다.

배열 함수 목록

배열 함수는 배열 데이터 구조에 대한 변환을 수행합니다. 특수 키워드는 배열 요소 및 인덱스를 처리합니다.

  • #acc 는 배열을 줄일 때 단일 출력에 포함하려는 값을 나타냅니다.
  • #index 는 배열 인덱스 번호와 함께 현재 배열 인덱스를 나타냅니다 #index2, #index3 ....
  • #item 는 배열의 현재 요소 값을 나타냅니다.
배열 함수 작업
array 항목의 배열을 만듭니다. 모든 항목은 동일한 형식이어야 합니다. 항목을 지정하지 않으면 빈 문자열 배열이 기본값으로 지정됩니다. [] 생성 연산자와 동일합니다.
at 배열 인덱스에서 요소를 찾습니다. 인덱스는 1부터입니다. 범위를 벗어난 인덱스는 null 값을 생성합니다. 키가 지정되면 맵에서 값을 찾습니다. 키를 찾을 수 없으면 null을 반환합니다.
contains 제공된 배열의 요소가 제공된 조건자에서 true로 평가되면 true를 반환합니다. 함수는 contains 조건자 함수의 한 요소에 대한 참조를 다음과 같이 #item예상합니다.
distinct 배열의 고유 항목 집합을 반환합니다.
except 삭제하는 다른 중복 항목에서 한 배열의 차이 집합을 반환합니다.
filter 제공된 조건자를 충족하지 않는 배열에서 요소를 필터링합니다. 함수는 filter 조건자 함수의 한 요소에 대한 참조를 다음과 같이 #item예상합니다.
find 조건과 일치하는 배열에서 첫 번째 항목을 찾습니다. 배열의 filter 항목을 다음과 같이 #item처리할 수 있는 함수를 사용합니다. 깊이 중첩된 맵의 경우 표기법을 사용하여 부모 맵을 #item_n(#item_1, #item_2...) 참조할 수 있습니다.
flatten 배열을 단일 배열로 평면화합니다. 원자성 항목의 배열은 변경되지 않은 상태로 반환됩니다. 마지막 인수는 선택 사항이며 한 수준 깊이보다 더 재귀적으로 평면화하기 위해 기본적으로 false로 설정됩니다.
in 항목이 배열에 있는지 확인합니다.
intersect 두 배열에서 고유 항목의 교차 집합을 반환합니다.
map 제공된 식을 사용하여 배열의 각 요소를 새 요소에 매핑합니다. 함수는 map 식 함수의 한 요소에 대한 참조를 다음과 같이 #item예상합니다.
mapIf 배열을 동일하거나 더 작은 길이의 다른 배열에 조건부로 매핑합니다. 값은 을 비롯한 structTypes모든 데이터 형식일 수 있습니다. 배열의 항목을 #item로 참조하고 현재 인덱스를 #index로 참조할 수 있게 하는 매핑 함수를 사용합니다. 깊이 중첩된 맵의 경우 표기법을 사용하여 부모 맵을 #item_[n](#item_1, #index_1...) 참조할 수 있습니다.
mapIndex 제공된 식을 사용하여 배열의 각 요소를 새 요소에 매핑합니다. 함수는 map 식 함수의 한 요소에 대한 참조와 요소 #item 인덱스에 대한 참조를 다음과 같이 #index예상합니다.
mapLoop 1에서 length까지 반복하여 해당 길이의 배열을 만듭니다. 배열의 인덱스 주소를 다음과 같이 #index지정할 수 있는 매핑 함수를 사용합니다. 깊이 중첩된 맵의 경우 표기법을 사용하여 부모 맵을 #index_n(#index_1, #index_2...) 참조할 수 있습니다.
reduce 배열에 요소를 누적합니다. reduce 함수는 첫 번째 식 함수의 누적기와 하나의 요소에 대한 참조를 #acc#item으로 예상합니다. 두 번째 식 함수에 사용되는 결과 값 #result 이 필요합니다.
size 배열 또는 맵 형식의 크기를 찾습니다.
slice 특정 위치에서 배열의 하위 세트를 추출합니다. 위치는 1부터 시작합니다. 길이를 생략하면 기본적으로 문자열의 끝으로 설정됩니다.
sort 제공된 조건자 함수를 사용하여 배열을 정렬합니다. 함수는 sort 식 함수에서 두 개의 연속된 요소에 대한 참조를 예상합니다#item1#item2.
unfold 배열을 행 세트로 펼치고 모든 행의 나머지 열에 대해 값을 반복합니다.
union 두 배열에서 고유 항목의 공용 구조체 집합을 반환합니다.

사용 가능한 기타 함수