이 페이지에서는 데이터 매핑에 대한 일반적인 개요와 Apigee Integration에서 데이터 매핑을 수행하는 다양한 방법을 제공합니다.
기업 데이터에는 다양한 소스와 형식에 있을 수 있으므로 통합 데이터 모델 또는 데이터 파이프라인에 통합하기가 매우 어렵습니다. 데이터 매핑은 여러 소스에서 데이터를 추출하고 표준화하여 소스와 대상의 관련 대상 데이터 필드 간의 관계를 설정하는 프로세스입니다. 통합에서 데이터 매핑을 사용하는 몇 가지 예시는 다음과 같습니다.
- JSON과 같은 복잡한 데이터 구조에서 필드 추출
- 데이터 소스를 대상 스키마에 매핑
- 변환 함수를 적용하여 데이터 변환
- 출력 값을 생성하고 통합 변수로 저장/사용
Apigee Integration을 사용하면 다음 태스크를 사용하여 데이터 매핑을 수행할 수 있습니다.
데이터 변환기 스크립트 태스크
데이터 변환기 스크립트 태스크는 Apigee Integration에서 사용할 수 있는 템플릿 엔진 기반 데이터 매핑 기능입니다. Google의 Jsonnet 구성 언어를 사용하여 통합에서 지정된 소스 및 대상 통합 변수의 매핑 관계를 정의하는 Jsonnet 템플릿을 만들고 수정합니다.
데이터 변환기 스크립트 편집기 및 지원되는 데이터 변환기 함수를 사용하면 커스텀 데이터 매핑 로직을 작성하고, 변수 할당을 수행하고, 통합 변수를 추가하거나 수정할 수 있습니다.
다음은 데이터 변환기 스크립트 편집기의 샘플 레이아웃을 보여주는 이미지입니다.
데이터 변환기 스크립트 태스크를 추가하고 구성하는 방법은 데이터 변환기 스크립트 태스크를 참조하세요.
데이터 매핑 태스크
데이터 매핑 태스크는 시각적 매핑 캔버스(데이터 매핑 편집기)를 제공하여 통합에서 데이터 할당 및 매핑을 수행하는 Apigee Integration의 코드 없는 로우 코드 기능입니다. 또한 지원되는 매핑 함수를 사용하여 데이터를 의미 있는 변수/형식으로 추가 변환하여 통합의 다른 태스크 또는 트리거에서 액세스할 수 있습니다.
데이터 매핑 태스크에서는 다음을 수행할 수 있습니다.
- 데이터 매핑 편집기를 사용하여 단일 변수나 중첩 변수의 변수 매핑을 시각화하고 정의할 수 있습니다.
- 변수를 한 가지 데이터 유형에서 다른 데이터 유형으로 변환합니다. 데이터 매핑 태스크를 사용하면 중첩 함수를 포함하여 매핑 함수를 여러 개 적용하여 변수 데이터를 변환할 수 있습니다.
데이터 매핑 편집기 및 레이아웃
데이터 매핑 편집기는 다음과 같은 통합 요소가 포함된 시각적 캔버스를 제공합니다.
- 변수 창: 통합에 사용할 수 있는 다양한 유형의 변수를 표시합니다.
- 입력. 통합 입력 변수입니다.
- 출력. 통합 출력 변수입니다.
- 로컬 변수. 통합 범위 내에 있는 변수입니다.
변수가 나열되지 않았으면 추가 +를 클릭하여 새 변수를 구성합니다.
(확장)을 클릭하여 각 변수를 확장하고 해당 변수의 사용 가능한 하위 필드를 봅니다. 사용 가능한 변수 목록에서 변수나 하위 필드를 검색하려면 (변수 검색)을 클릭합니다.Apigee Integration의 변수에 대한 자세한 내용은 Apigee Integration에서 변수 사용을 참조하세요.
- 입력 열: 데이터 매핑 입력의 소스가 포함된 입력 매핑 행을 표시합니다. 소스는 리터럴 값, 기본 함수 또는 매핑 함수가 있는 입력 변수일 수 있습니다. 입력 매핑 행에서 변수 또는 값을 클릭하여 소스를 추가합니다.
- 출력 열: 각 입력 매핑 행에 관련 대상 변수가 포함된 출력 매핑 행을 표시합니다. 후속 입력 행에서 매핑에 대상 변수를 사용할 수 있습니다. 출력 변수를 할당하려면 새 변수를 만들거나 변수 열에서 기존 출력 변수를 직접 드래그 앤 드롭합니다.
매핑 함수
데이터 매핑 태스크는 통합에서 매핑 데이터를 변환하고 표준화하는 다양한 사전 정의된 매핑 함수를 제공합니다. 매핑 함수에는 입력 매개변수가 하나 이상 있을 수 있으며, 각 매개변수에는 리터럴 값, 변수 또는 매핑 함수가 적용된 기본 함수가 추가로 포함될 수 있습니다. 단일 입력 소스에 여러 매핑 함수를 사용하여 매핑 변환 표현식을 형성할 수 있습니다.
입력 소스의 최종 데이터 유형은 해당 데이터 매핑 입력 행에 정의된 변환 표현식의 반환 유형을 기반으로 합니다. 입력 소스의 반환 유형이 해당 출력 매핑 대상 변수의 반환 유형과 일치하지 않는 경우 데이터 매핑 편집기가 해당 데이터 매핑 입력 행 아래에 검증 오류 를 표시합니다.
변환 표현식
변환 표현식은 연속으로 또는 중첩 구조로 연결된 여러 매핑 함수의 조합입니다. 데이터 매핑 편집기를 사용하면 정의된 변환 표현식에서 함수 또는 함수 매개변수를 쉽게 삽입, 수정, 삭제할 수 있습니다. 정의된 변환 표현식이 잘못된 경우 데이터 매핑 편집기에서 표현식의 오류를 일으키는 각 함수 또는 함수 매개변수 옆에 검증 오류 가 표시됩니다. 전체 오류 메시지를 보려면 검증 오류 아이콘 위에 마우스 포인터를 올려놓습니다.
다음 이미지는 데이터 매핑 편집기에서 검증 오류가 있는 샘플 매핑을 보여줍니다.
데이터 매핑 작업에서 매핑을 구성하는 방법에 대한 자세한 내용은 매핑 추가를 참조하세요.
Apigee Integration에서 지원되는 사전 정의된 매핑 함수에 대한 자세한 내용은 지원되는 데이터 유형 및 매핑 함수를 참조하세요.
매핑 순서
데이터 매핑 편집기에 지정된 매핑은 위에서 아래 순서로 실행됩니다. 예를 들어 이전 이미지에서Num1은 첫 번째 행의 Num1ToInt에 매핑되므로, 후속 행에서 Num1ToInt를 매핑에 사용할 수 있습니다.