미리보기 — Data Transformer Script task

이 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

데이터 변환기 스크립트 태스크

데이터 변환기 스크립트 태스크를 사용하면 커스텀 Jsonnet 템플릿을 작성, 수정, 평가하여 통합에서 데이터 매핑을 수행할 수 있습니다.

Application Integration의 데이터 매핑에 대한 자세한 내용은 데이터 매핑 개요를 참조하세요.

데이터 변환기 스크립트 태스크 구성

데이터 변환기 스크립트 태스크를 통합에 추가하려면 다음 단계를 수행하세요.

1. Google Cloud 콘솔에서 Application Integration 페이지로 이동합니다.

   Application Integration으로 이동

2. 탐색 메뉴에서 통합을 클릭합니다.

   Google Cloud 프로젝트에서 사용할 수 있는 모든 통합이 나열된 통합 페이지가 나타납니다.

3. 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.

   새 통합을 만드는 경우:

   1. 통합 만들기 창에 이름과 설명을 입력합니다.
   2. 통합 리전을 선택합니다.
      참고: 리전 드롭다운에는 Google Cloud 프로젝트에 프로비저닝된 리전만 나열됩니다. 새 리전을 프로비저닝하려면 리전 사용 설정을 클릭합니다. 자세한 내용은 새 리전 사용 설정을 참조하세요.
   3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
      참고: 서비스 계정 선택 옵션은 선택한 리전에 대해 통합 거버넌스를 사용 설정한 경우에만 표시됩니다.
   4. 만들기를 클릭합니다.

   통합 편집기 페이지에서 통합이 열립니다.

4. 통합 편집기 탐색 메뉴에서 태스크를 클릭하여 사용 가능한 태스크 목록을 확인합니다.
5. 데이터 변환기 스크립트 요소를 클릭하고 통합 편집기에 배치합니다.
6. 디자이너에서 데이터 변환기 스크립트 요소를 클릭하여 데이터 변환기 스크립트 태스크 구성 창을 봅니다.
7. 데이터 변환기 스크립트 편집기 열기를 클릭합니다.
8. 데이터 변환기 스크립트 편집기가 표시되면 기본 주석이 지정된 Jsonnet 템플릿 예시가 표시됩니다.
9. Jsonnet 코드를 작성하고 완료되면 편집기를 닫습니다. 모든 변경사항이 자동 저장됩니다.

데이터 변환기 스크립트 편집기 사용

데이터 변환기 스크립트 편집기를 사용하여 통합 변수에 액세스하고, 변수 할당을 수행하고, 통합에서 변수를 추가하거나 수정할 수 있습니다. 데이터 변환기 스크립트 편집기는 스크립트 작성 환경을 보강하는 다음과 같은 기능을 제공합니다.

• 향상된 코드 가독성과 구조 인식을 위한 구문/코드 강조표시, 들여쓰기, 라인 번호 지정
• 스크립트 코드의 대략적인 개요를 표시하고 빠른 탐색에 도움이 되는 미니맵
• 스크립트 코드를 클립보드에 복사할 수 있는 클릭하여 복사 옵션

편집기를 열려면 데이터 변환기 스크립트 태스크 구성 창으로 이동하고 데이터 변환기 스크립트 편집기 열기를 클릭합니다.

데이터 변환기 스크립트 편집기는 기본적으로 Application Integration에서 데이터 매핑을 위한 Jsonnet 함수 집합이 포함된 사전 정의된 커스텀 라이브러리인 functions를 가져옵니다. 사용 가능한 커스텀 함수에 대한 자세한 내용은 데이터 변환기 함수를 참조하세요.

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

통합 변수에 액세스

데이터 변환기 스크립트 편집기에서 기존 통합 변수를 읽으려면 사전 정의된 functions 라이브러리의 extVar 함수를 사용합니다.

주의: Jsonnet은 식별자 이름의 일부로 하이픈(-) 사용을 허용하지 않습니다. 예를 들어 변수 이름이나 함수 이름이 있습니다. 변수 이름의 일부로 하이픈(-)을 사용하려면 다음 예와 같이 변수를 큰따옴표로 묶고 선언해야 합니다.

예: 데이터 변환기 스크립트 편집기를 사용하여 기존 통합 변수 읽기 및 업데이트

Jsonnet 스크립트

local f = import "functions"; // Import predefined Data Transformer function library

local str1 = f.extVar("inputVar1"); // Access integration input variable "Inputstr1" with value "Hello"
local str2 = f.extVar("inputVar2"); // Access integration input variable "Inputstr2" with value "World"
{
  OutputVar: str1 + " " + str2 + "!", // Write to Jsonnet output variable "OutputVar"
  "output-str-var": str1 + " Integration " + str2 + "!", // Write to Jsonnet output variable "output-str-var"
}

출력

권장사항

데이터 변환기 스크립트 태스크에 적용되는 사용량 한도에 대한 자세한 내용은 사용량 한도를 참조하세요.

다음 단계

• 데이터 변환기 함수 참조(미리보기)