Application Integration에 지원되는 커넥터를 참조하세요.

데이터 매핑

기업 데이터에는 다양한 소스와 형식에 있을 수 있으므로 통합 데이터 모델이나 데이터 파이프라인에 통합하기가 어렵습니다. 데이터 매핑은 여러 소스에서 데이터를 추출하고 표준화하여 소스와 대상의 관련 대상 데이터 필드 간의 관계를 설정하는 프로세스입니다. 통합에서 데이터 매핑을 사용하는 몇 가지 예시는 다음과 같습니다.

• JSON과 같은 복잡한 데이터 구조에서 필드 추출
• 데이터 소스를 대상 스키마에 매핑
• 변환 함수를 적용하여 데이터 변환
• 출력 값을 생성하고 통합 변수로 저장/사용

Application Integration을 사용하면 다음 태스크를 사용하여 데이터 매핑을 수행할 수 있습니다.

• Data Transformer 태스크(미리보기)
• 데이터 매핑 태스크

Data Transformer 태스크

Data Transformer 태스크는 Application Integration에서 사용할 수 있는 템플릿 엔진 기반 데이터 매핑 기능입니다. Google의 Jsonnet 구성 언어를 사용하여 Jsonnet 템플릿을 만들고 수정합니다. Jsonnet 템플릿은 통합에서 지정된 소스 및 대상 통합 변수의 매핑 관계를 정의합니다. Data Transformer 태스크는 통합에서 데이터 할당과 매핑을 수행할 수 있는 시각적 매핑 캔버스(다이어그램 모드)도 제공합니다.

다이어그램 모드

다이어그램 모드는 다음과 같은 통합 요소가 포함된 시각적 캔버스를 제공합니다.

• 입력. 데이터 변환 입력 변수를 표시합니다. 소스는 변수이거나 상수일 수 있습니다. 입력 변수를 할당하려면 기존 변수를 선택하거나 새 변수를 만들면 됩니다. 입력 요소를 클릭하고 관련 출력 변수와 매핑할 선을 드래그하면 이러한 변수가 관련 출력 변수와 매핑됩니다.
• 출력. 데이터 변환 출력 변수를 표시합니다. 후속 입력 행에서 매핑에 대상 변수를 사용할 수 있습니다. 출력 변수를 할당하려면 기존 변수를 선택하거나 새 변수를 만들면 됩니다.
• 캔버스. 캔버스는 입력 및 출력 변수를 시각적으로 매핑하는 데 사용됩니다.

Application Integration의 변수에 대한 자세한 내용은 Application Integration에서 변수 사용을 참조하세요.

다음 이미지에서는 Data Transformer 다이어그램 모드의 샘플 레이아웃을 보여줍니다.

변환 작업

사전 정의된 변환 작업을 사용하여 통합에서 매핑 데이터를 변환하고 표준화할 수 있습니다. 변환 작업에는 입력 파라미터가 하나 이상 있을 수 있으며 각 파라미터에는 리터럴 값이나 변수가 포함될 수 있습니다. 단일 입력 소스에 여러 매핑 함수를 사용하여 매핑 변환 표현식을 형성할 수 있습니다.

입력 소스의 최종 데이터 유형은 해당 데이터 매핑 입력 행에 정의된 변환 표현식의 반환 유형을 기반으로 합니다.

스크립트 모드

데이터 변환기 스크립트 편집기 및 지원되는 데이터 변환기 함수를 사용하면 커스텀 데이터 매핑 로직을 작성하고, 변수 할당을 수행하고, 통합 변수를 추가하거나 수정할 수 있습니다.

다음은 데이터 변환기 스크립트 편집기의 샘플 레이아웃을 보여주는 이미지입니다.

Data Transformer 태스크를 추가하고 구성하는 방법에 대한 자세한 내용은 Data Transformer 태스크를 참조하세요.

데이터 매핑 태스크

데이터 매핑 태스크는 시각적 매핑 캔버스(데이터 매핑 편집기)를 제공하여 통합에서 데이터 할당과 매핑을 수행하는 Application Integration의 노 코드(no-code) 로우 코드(low-code) 기능입니다. 또한 지원되는 매핑 함수를 사용하여 데이터를 의미 있는 변수/형식으로 추가 변환하여 통합의 다른 태스크 또는 트리거에서 액세스할 수 있습니다.

데이터 매핑 태스크에서는 다음을 수행할 수 있습니다.

• 데이터 매핑 편집기를 사용하여 단일 변수나 중첩 변수의 변수 매핑을 시각화하고 정의할 수 있습니다.
• 변수를 한 가지 데이터 유형에서 다른 데이터 유형으로 변환합니다. 데이터 매핑 태스크를 사용하면 중첩 함수를 포함하여 매핑 함수를 여러 개 적용하여 변수 데이터를 변환할 수 있습니다.

데이터 매핑 태스크를 추가하고 구성하는 방법에 대한 자세한 내용은 데이터 매핑 태스크를 참조하세요.

데이터 매핑 편집기 및 레이아웃

데이터 매핑 편집기는 다음과 같은 통합 요소가 포함된 시각적 캔버스를 제공합니다.

• 변수 창: 통합에 사용할 수 있는 다양한 유형의 변수를 표시합니다.
  • 입력. 통합 입력 변수입니다.
  • 출력. 통합 출력 변수입니다.
  • 로컬 변수. 통합 범위 내에 있는 변수입니다.

  변수가 나열되지 않았으면 추가 +를 클릭하여 새 변수를 구성합니다.

  chevron_right (확장)을 클릭하여 각 변수를 확장하고 해당 변수의 사용 가능한 하위 필드를 봅니다. 사용 가능한 변수 목록에서 변수나 하위 필드를 검색하려면 search (변수 검색)을 클릭합니다.

  Application Integration의 변수에 대한 자세한 내용은 변수를 참조하세요.

• 입력 열: 데이터 매핑 입력의 소스가 포함된 입력 매핑 행을 표시합니다. 소스는 리터럴 값, 기본 함수 또는 매핑 함수가 있는 입력 변수일 수 있습니다. 입력 매핑 행에서 변수 또는 값을 클릭하여 소스를 추가합니다.
• 출력 열: 각 입력 매핑 행에 관련 대상 변수가 포함된 출력 매핑 행을 표시합니다. 후속 입력 행에서 매핑에 대상 변수를 사용할 수 있습니다. 출력 변수를 할당하려면 새 변수를 만들거나 변수 열에서 기존 출력 변수를 직접 드래그 앤 드롭합니다.

다음은 데이터 매핑 편집기의 샘플 레이아웃을 보여주는 이미지입니다.

매핑 함수

데이터 매핑 태스크는 통합에서 매핑 데이터를 변환하고 표준화하는 다양한 사전 정의된 매핑 함수를 제공합니다. 매핑 함수에는 입력 매개변수가 하나 이상 있을 수 있으며, 각 매개변수에는 리터럴 값, 변수 또는 매핑 함수가 적용된 기본 함수가 추가로 포함될 수 있습니다. 단일 입력 소스에 여러 매핑 함수를 사용하여 매핑 변환 표현식을 형성할 수 있습니다.

입력 소스의 최종 데이터 유형은 해당 데이터 매핑 입력 행에 정의된 변환 표현식의 반환 유형을 기반으로 합니다. 입력 소스의 반환 유형이 해당 출력 매핑 대상 변수의 반환 유형과 일치하지 않는 경우 데이터 매핑 편집기가 해당 데이터 매핑 입력 행 아래에 검증 오류 error 를 표시합니다.

변환 표현식

변환 표현식은 연속으로 또는 중첩 구조로 연결된 여러 매핑 함수의 조합입니다. 데이터 매핑 편집기를 사용하면 정의된 변환 표현식에서 함수 또는 함수 매개변수를 쉽게 삽입, 수정, 삭제할 수 있습니다. 정의된 변환 표현식이 잘못된 경우 데이터 매핑 편집기에서 표현식의 오류를 일으키는 각 함수 또는 함수 매개변수 옆에 검증 오류 error 가 표시됩니다. 전체 오류 메시지를 보려면 검증 오류 error 아이콘 위에 마우스 포인터를 올려놓습니다.

다음 이미지는 데이터 매핑 편집기에서 검증 오류가 있는 샘플 매핑을 보여줍니다.

데이터 매핑 태스크에서 매핑을 구성하는 방법에 대한 자세한 내용은 매핑 추가를 참조하세요.

Application Integration에서 지원되는 사전 정의된 매핑 함수에 대한 자세한 내용은 지원되는 데이터 유형 및 매핑 함수를 참조하세요.

매핑 순서

데이터 매핑 편집기에 지정된 매핑은 위에서 아래 순서로 실행됩니다. 예를 들어 이전 이미지에서 Num1은 첫 번째 행의 Num1ToInt에 매핑되므로, 후속 행에서 Num1ToInt를 매핑에 사용할 수 있습니다.

할당량 및 한도

할당량 및 한도에 대한 자세한 내용은 할당량 및 한도를 참조하세요.

다음 단계

• Data Transformer 태스크 추가 및 구성(미리보기)
• Data Transformer 함수 알아보기 (미리보기)
• 데이터 매핑 태스크 추가 및 구성