커넥터 태스크를 통해 Integration Connectors에서 즉시 사용 가능한 커넥터를 사용하여 통합 시 다양한 Google Cloud 서비스 및 기타 비즈니스 애플리케이션에 빠르고 안전하게 연결할 수 있습니다.
Apigee Integration에 지원되는 모든 커넥터 목록은 커넥터 참조를 확인하세요.시작하기 전에
- Google Cloud 프로젝트에 커넥터 관리자(
roles/connectors.admin) IAM 역할이 부여되었는지 확인합니다. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요. - Integration Connectors의 일반적인 개념을 알아봅니다.
- 커넥터를 사용하여 Google Cloud 서비스 및 기타 비즈니스 애플리케이션에 연결하려면 통합에 사용자 관리형 서비스 계정을 연결했는지 확인합니다. 통합에 사용자 관리형 서비스 계정이 구성되어 있지 않으면 기본적으로 인증에 기본 서비스 계정(
service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com)이 사용됩니다. - 서비스 계정에 필요한 IAM 역할이 있는지 확인합니다. 서비스 계정에 역할 부여에 대한 자세한 내용은 서비스 계정에 대한 액세스 관리를 참조하세요.
커넥터 태스크 추가
통합에 커넥터 태스크를 추가하려면 다음을 수행합니다.
- Apigee UI에서 Apigee 조직을 선택합니다.
- 개발 > 통합을 클릭합니다.
- 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.
새 통합을 만드는 경우:
- 통합 만들기 대화상자에 이름과 설명을 입력합니다.
- 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
- 만들기를 클릭합니다.
통합 디자이너 페이지에서 통합이 열립니다.
- 통합 설계자 탐색 메뉴에서 +태스크/트리거 추가 > 태스크를 클릭하여 사용 가능한 태스크 목록을 봅니다.
- 커넥터 요소를 클릭하고 통합 편집기에 배치합니다.
커넥터 태스크 구성
커넥터 태스크를 구성하려면 다음을 수행합니다.
- 디자이너에서 커넥터 태스크 요소를 클릭하여 커넥터 태스크 구성 창을 확인합니다.
선택적으로 를 클릭하여 태스크 이름을 수정합니다.
- 커넥터 구성을 클릭합니다.
- 리전의 기존 연결을 선택하거나 새 연결을 생성할 수 있습니다. 기존 연결을 구성하려면 커넥터 태스크 편집기 페이지에서 다음 단계를 완료합니다.
- 커넥터 선택에서 연결 리전을 선택합니다.
- 선택한 리전의 사용 가능한 연결 목록에서 기존 연결을 선택합니다.
- 다음을 클릭합니다.
- 유형 목록에서 항목 또는 작업을 선택합니다.
- 항목을 선택하면 연결에 지원되는 항목 목록이 항목/작업 설정 섹션에 표시됩니다. 항목을 선택하고 해당 항목에서 수행하려는 작업을 선택합니다.
- 작업을 선택하면 연결에 지원되는 작업 목록이 항목/작업 설정 열에 표시됩니다. 연결 작업을 선택합니다. 지원되는 항목 및 작업은 커넥터 유형을 기반으로 합니다. Apigee Integration에 지원되는 모든 커넥터 목록은 커넥터 참조를 확인하세요. 커넥터에 지원되는 작업과 항목을 보려면 특정 커넥터 문서를 참조하세요.
커넥터에서 커스텀 SQL 쿼리가 지원되는 경우 작업 목록에서 커스텀 쿼리 실행 옵션을 선택할 수 있습니다. 예를 들어 BigQuery 커넥터에 대해 커스텀 SQL 쿼리를 추가하는 방법은 커스텀 SQL 쿼리 실행을 참조하세요.
항목 및 작업에 대한 자세한 내용은 항목, 운영, 작업을 참조하세요.
- 완료를 클릭하여 연결 구성을 완료하고 창을 닫습니다.
다음 이미지는 커넥터 태스크 편집기 페이지의 샘플 레이아웃을 보여줍니다.
태스크 입력 및 출력 변수 구성
커넥터 태스크 구성 창에는 커넥터 태스크 구성 대화상자에서 선택한 항목 및 작업 또는 조치를 기반으로 자동 생성된 태스크 입력 및 태스크 출력 변수가 표시됩니다. 이러한 변수는 구성 가능하며, 현재 태스크에 대한 입력 또는 현재 통합에 후속 태스크 또는 조건에 대한 출력으로 액세스될 수 있습니다.
태스크 입력 또는 태스크 출력 변수를 구성하려면 해당 변수를 클릭하여 변수 구성 창을 열고 다음 단계를 수행합니다.
- 기본값 필드에 변수 값을 입력합니다.
- (선택사항) 통합의 입력으로 사용 또는 통합의 출력으로 사용을 선택합니다.
- 저장을 클릭합니다.
커넥터 태스크의 입력 및 출력 매개변수에 대한 자세한 내용은 항목 작업을 참조하세요.
항목 작업
커넥터의 항목에서 CRUD(만들기, 읽기, 업데이트, 삭제) 작업을 수행할 수 있습니다. 이러한 각 항목 작업에는 서로 다른 입력 및 출력 매개변수 집합이 있습니다. 다음 표에는 다양한 항목 작업의 입력 및 출력 매개변수가 나와 있습니다.
| 작업 이름 | 입력 매개변수 | 출력 매개변수 |
|---|---|---|
| 목록 |
|
|
| 설치 | entityId | connectorOutputPayload |
| 만들기 | connectorInputPayload | connectorOutputPayload |
| 업데이트 |
|
connectorOutputPayload |
| 삭제 |
|
해당 사항 없음 |
입력 매개변수
다음 표에서는 다양한 항목 작업의 입력 매개변수를 설명합니다.
| 매개변수 이름 | 데이터 유형 | 설명 |
|---|---|---|
| entityId | 문자열 | 액세스하려는 행의 고유 식별자입니다. 일반적으로 예를 들어 MySQL 테이블에서 특정 행을 가져오려면 |
| connectorInputPayload | JSON | 항목에 추가하거나 업데이트할 실제 데이터입니다. 다음 예시에서는 테이블에 추가할 행 데이터의 JSON 스니펫을 보여줍니다.
{
"employee_first_name": "John",
"employee_emailID": "test-05@test.com"
}
이 예시에서 |
| filterClause | 문자열 | 조건에 따라 작업 결과를 제한합니다. 필터 절 추가에 대한 자세한 내용은 작업용 필터 추가를 참조하세요. |
| listEntitiesPageSize | 정수 |
페이지에서 반환되어야 하는 결과의 수를 지정합니다. 페이지는 결과 세트의 레코드를 논리적으로 그룹화한 것입니다. 페이지 개념은 결과 세트에 많은 수의 레코드가 있을 것으로 예상되는 경우 유용합니다. 결과 세트가 크면 커넥터 작업이 처리할 수 있는 데이터 크기가 제한되므로 커넥터 작업이 실패할 수 있습니다. 결과 세트를 더 작은 단위로 분할하면 이 문제를 방지할 수 있습니다. 예를 들어 결과 세트에 레코드가 1,000개 있을 것으로 예상되는 경우 |
| listEntitiesPageToken | 문자열 | 특정 페이지에 액세스할 수 있는 페이지 식별자(토큰)입니다.
|
| listEntitiesSortByColumns | 문자열 배열 | 결과 세트를 정렬하려는 열 이름입니다.
|
출력 매개변수
다음 표에서는 다양한 항목 작업의 출력 매개변수를 설명합니다.
| 매개변수 이름 | 데이터 유형 | 설명 |
|---|---|---|
| connectorOutputPayload | JSON | JSON 형식의 작업 출력 |
| listEntitiesNextPageToken | 문자열 |
시스템에 대한 생성된 페이지 식별자입니다. 토큰은 결과 세트의 특정 페이지에 액세스할 수 있는 포인터라고 생각하면 됩니다.
예를 들어 결과 세트에 페이지 수가 많으면 각 루프용 태스크를 사용하여 커넥터 태스크를 반복해서 호출하고 데이터 매핑 태스크를 실행하여 각 실행 후 |
항목 작업의 필터 절
태스크 입력으로 사용 가능한 필터 절 변수로 커넥터 태스크에서 처리되는 레코드를 제한할 수 있습니다. 예를 들어 삭제 작업의 경우 특정 orderId로 레코드를 삭제하는 필터 절을 추가할 수 있습니다.
필터 절은 다음 항목 작업의 경우에만 적용될 수 있습니다.
- 목록
- 삭제
- 업데이트
이러한 작업을 선택하면 커넥터 태스크의 태스크 입력 섹션에 필터 절 필드가 자동으로 표시됩니다.
필터 절 추가
필터 절을 추가하려면 다음 단계를 수행하세요.
- 디자이너에서 커넥터 태스크 요소를 클릭하여 커넥터 태스크 구성 창을 확인합니다.
- 태스크 입력 섹션을 펼치고 filterClause(커넥터) 문자열 변수를 클릭합니다.
변수 구성 대화상자가 나타납니다.
- 기본값 필드에 필터 절(절 구문 뒤에 있음)을 입력합니다.
- 저장을 클릭합니다.
필터 절 구문 및 예시
필터 절의 형식은 다음과 같습니다.
FIELD_NAME CONDITION FILTER_VALUE
Examples
OwnerId = '0053t000007941XAAQ'
PoNumber < 2345
OrderNumber = 00110 AND StatusCode = 'Draft'
TotalAmount > 2500
ShippingPostalCode = 94043 OR ShippingPostalCode = 77002
필터 절에서 변수 사용
필터 절에서 통합 변수를 직접 사용할 수 없습니다. 통합 변수를 사용하려면 먼저 데이터 매핑 태스크를 구성하여 통합 변수와 필터 절 사이에 매핑을 만들어야 합니다.다음 표는 통합 변수와 filterClause(Connectors) 변수 간의 샘플 매핑을 보여줍니다.
| 입력 | 출력 |
|---|---|
PRIMARY_KEY_ID = ' .CONCAT(INTEGRATION_VARIABLE) .CONCAT(') |
filterClause(Connectors) |
PRIMARY_KEY_ID = '는 입력 행에 값으로 입력됩니다.
인라인 연결 만들기
커넥터 태스크를 사용하여 Integration Connectors에서 새 연결을 직접 만들 수 있습니다.
시작하기 전에
새 연결 만들기
Apigee Integration에서 새 연결을 만들려면 다음 단계를 수행합니다.
- 디자이너에서 커넥터 태스크 요소를 클릭하여 커넥터 태스크 구성 창을 확인합니다.
- 커넥터 구성을 클릭합니다.
커넥터 태스크 편집기 페이지가 나타납니다.
- 리전 필드를 건너뜁니다.
- 연결을 클릭하고 드롭다운 메뉴에서 연결 만들기 옵션을 선택합니다.
- 연결 만들기 창에서 다음 단계를 완료합니다.
- 위치 단계에서 연결 위치를 선택합니다.
- 리전을 클릭하고 드롭다운 목록에서 위치를 선택합니다.
- 다음을 클릭합니다.
- 연결 세부정보 단계에서 연결에 대한 세부정보를 제공합니다.
- 커넥터: 드롭다운 목록에서 만들려는 커넥터 유형을 선택합니다. 지원되는 커넥터 목록은 모든 Integration Connectors를 참조하세요.
- 커넥터 버전: 드롭다운 목록에서 선택한 커넥터 유형의 사용 가능한 버전을 선택합니다.
- 연결 이름: 연결 인스턴스의 이름을 입력합니다.
- (선택사항) 연결 인스턴스에 대한 설명을 입력합니다.
- (선택사항) Cloud Logging 사용 설정을 선택하여 연결 인스턴스의 로그 데이터를 저장합니다.
- 서비스 계정: 필수 역할이 있는 서비스 계정을 선택합니다.
- (선택사항) 고급 설정을 클릭하여 연결 노드 설정을 구성합니다.
자세한 내용은 Integration Connectors의 해당 연결 문서를 참조하세요.
- (선택사항) + 라벨 추가를 클릭하여 키/값 쌍의 형식으로 연결에 라벨을 추가합니다.
- 다음을 클릭합니다.
-
인증 단계에서 연결의 인증 세부정보를 제공합니다.
- 이 단계에서 입력되는 인증 방식은 생성 중인 연결 유형에 기반합니다.
연결 유형에 따라 인증 방식이 달라집니다. 자세한 내용은 Integration Connectors에서 해당 연결 문서의 인증 구성 섹션을 참조하세요.
- 다음을 클릭합니다.
- 이 단계에서 입력되는 인증 방식은 생성 중인 연결 유형에 기반합니다.
- 검토: 연결 및 인증 세부정보를 검토합니다.
- 만들기를 클릭합니다.
- 위치 단계에서 연결 위치를 선택합니다.
권장사항
- 커넥터 태스크에 적용되는 사용량 한도에 대한 자세한 내용은 사용량 한도를 참조하세요.
- 실패한 커넥터 태스크 문제 해결 방법에 대한 자세한 내용은 로그를 사용하여 커넥터 오류 문제 해결 및 추적을 참조하세요.
오류 처리 전략
태스크의 오류 처리 전략은 일시적인 오류로 인해 태스크가 실패할 경우 수행할 태스크를 지정합니다. 오류 처리 전략을 사용하는 방법과 다양한 유형의 오류 처리 전략에 대한 자세한 내용은 오류 처리 전략을 참조하세요.