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

  • 아티클

적용 대상: Azure Data Factory Azure Synapse Analytics

팁

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

데이터 흐름은 Azure Data Factory 및 Azure Synapse Pipelines 모두에서 사용할 수 있습니다. 이 문서는 매핑 데이터 흐름에 적용됩니다. 변환을 처음 사용하는 경우 매핑 데이터 흐름을 사용하여 데이터 변환 소개 문서를 참조하세요.

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

배열 함수 목록

배열 함수는 배열인 데이터 구조에서 변환을 수행합니다. 여기에는 배열 요소 및 인덱스를 해결하기 위한 특수 키워드(keyword) 포함됩니다.

  • #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개 배열에서 고유 항목의 합집합을 반환합니다.

관련 콘텐츠