적용 대상:
Azure Data Factory Azure Synapse Analytics
팁
기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아보세요!
데이터 흐름은 Azure Data Factory 파이프라인과 Azure Synapse Analytics 파이프라인 모두에서 사용할 수 있습니다. 이 문서는 매핑 데이터 흐름에 적용됩니다. 변환을 접하는 경우 매핑 데이터 흐름을 사용하여 데이터 변환 소개 문서를 참조하세요.
이 문서에서는 매핑 데이터 흐름에서 Azure Data Factory 및 Azure Synapse Analytics에서 지원하는 메타 함수에 대해 자세히 설명합니다.
메타 함수 목록
메타 함수는 주로 데이터 흐름의 메타데이터에서 작동합니다.
| 메타 함수 | 작업 |
|---|---|
| byItem | 구조체 또는 구조체의 배열 내에서 하위 항목을 찾습니다. 일치하는 항목이 여러 개 있는 경우 첫 번째 일치 항목을 반환합니다. 일치하는 항목이 없으면 값이 NULL 반환됩니다. 반환된 값은 형식 변환 작업(예: ? date 및 ? string)에 의해 변환된 형식이어야 합니다. 디자인 타임에 알려진 열 이름은 이름으로만 처리합니다. 계산된 입력은 지원되지 않지만 매개 변수 대체를 사용할 수 있습니다. |
| byOrigin | 원본 스트림에서 이름별 열 값을 선택합니다. 두 번째 인수는 원본 스트림 이름입니다. 일치하는 항목이 여러 개 있는 경우 첫 번째 일치 항목을 반환합니다. 일치하는 항목이 없으면 값이 NULL 반환됩니다. 반환된 값은 형식 변환 함수(예: TO_DATE 및 TO_STRING)로 변환된 형식이어야 합니다. 디자인 타임에 알려진 열 이름은 이름으로만 처리합니다. 계산된 입력은 지원되지 않지만 매개 변수 대체를 사용할 수 있습니다. |
| byOrigins | 스트림에서 이름별 열 배열을 선택합니다. 두 번째 인수는 인수가 시작된 스트림입니다. 일치하는 항목이 여러 개 있는 경우 첫 번째 일치 항목을 반환합니다. 일치하는 항목이 없으면 값이 NULL 반환됩니다. 반환된 값은 형식 변환 함수(예: TO_DATE 및 TO_STRING)로 변환된 형식이어야 합니다. 디자인 타임에 알려진 열 이름은 이름으로만 처리합니다. 계산된 입력은 지원되지 않지만 매개 변수 대체를 사용할 수 있습니다. |
| byName | 스트림에서 이름을 기준으로 열 값을 선택합니다. 선택적 스트림 이름을 두 번째 인수로 전달할 수 있습니다. 일치하는 항목이 여러 개 있는 경우 첫 번째 일치 항목을 반환합니다. 일치하는 항목이 없으면 값이 NULL 반환됩니다. 반환된 값은 형식 변환 함수(예: TO_DATE 및 TO_STRING)로 변환된 형식이어야 합니다. 디자인 타임에 알려진 열 이름은 이름으로만 처리합니다. 계산된 입력은 지원되지 않지만 매개 변수 대체를 사용할 수 있습니다. |
| byNames | 스트림에서 이름별 열 배열을 선택합니다. 선택적 스트림 이름을 두 번째 인수로 전달할 수 있습니다. 일치하는 항목이 여러 개 있는 경우 첫 번째 일치 항목을 반환합니다. 열에 일치하는 항목이 없으면 전체 출력이 NULL 값입니다. 반환된 값에는 형식 변환 함수(예: toDate 및 toString)가 필요합니다. 디자인 타임에 알려진 열 이름은 이름으로만 처리합니다. 계산된 입력은 지원되지 않지만 매개 변수 대체를 사용할 수 있습니다. |
| byPath | 스트림에서 이름별 계층 경로를 찾습니다. 선택적 스트림 이름을 두 번째 인수로 전달할 수 있습니다. 이러한 경로가 없으면 값을 반환합니다 NULL . 설계 시 이름이나 점 표기법 경로로만 알려진 열 이름/경로를 할당합니다. 계산된 입력은 지원되지 않지만 매개 변수 대체를 사용할 수 있습니다. |
| byPosition | 스트림 내에서 상대적인 위치(1부터)에 따라 열 값을 선택합니다. 위치가 범위를 벗어나면 값을 반환 NULL 합니다. 반환된 값은 형식 변환 함수(예: TO_DATE 및 TO_STRING)로 변환된 형식이어야 합니다. 계산된 입력은 지원되지 않지만 매개 변수 대체를 사용할 수 있습니다. |
| hasPath | 특정 계층 경로가 스트림에 이름별로 존재하는지 확인합니다. 선택적 스트림 이름을 두 번째 인수로 전달할 수 있습니다. 디자인 타임에 이름 또는 점 표기법 경로로만 알려진 열 이름/경로의 주소를 지정합니다. 계산된 입력은 지원되지 않지만 매개 변수 대체를 사용할 수 있습니다. |
| originColumns | 열을 만든 원본 스트림에 대한 모든 출력 열을 가져옵니다. 다른 함수로 묶어야 합니다. |
| hex | 이진 값의 16진수 문자열 표현을 반환합니다. |
| unhex | 16진 문자열 표현을 이진 값으로 표시합니다. 문자열을 이진 표현으로 변환하기 위해 sha2 및 md5와 함께 사용할 수 있습니다. |