For Each 병렬 태스크

For Each 병렬 태스크를 사용하면 기본 통합에서 다른 통합(하위 통합)을 실행할 수 있습니다. 태스크 이름에서 암시하듯이 하위 통합은 동시에 실행됩니다.

이 태스크는 API 트리거 ID를 핸들로 사용하여 실행할 통합을 식별합니다. 예를 들어 API 트리거 ID를 api_trigger/APITriggerX로 지정하면 태스크는 api_trigger/APITriggerX 트리거 ID를 가진 모든 하위 통합을 실행합니다.

하위 통합을 실행한 후 기본 통합에서 하위 통합의 응답을 읽을 수도 있습니다. 이 태스크를 사용하여 하위 통합을 기본 통합의 종속 항목으로 실행합니다.

시작하기 전에

For Each 병렬 태스크 구성

For Each 병렬 태스크를 구성하려면 다음 안내를 따르세요.

  1. Apigee UI에서 Apigee 조직을 선택합니다.
  2. 개발 > 통합을 클릭합니다.
  3. 기존 통합을 선택하거나 통합 만들기를 클릭하여 새 통합을 만듭니다.

    새 통합을 만드는 경우:

    1. 통합 만들기 대화상자에 이름과 설명을 입력합니다.
    2. 지원되는 리전 목록에서 통합에 대한 리전을 선택합니다.
    3. 만들기를 클릭합니다.

    통합 디자이너 페이지에서 통합이 열립니다.

  4. 통합 설계자 탐색 메뉴에서 +태스크/트리거 추가 > 태스크를 클릭하여 사용 가능한 태스크 목록을 봅니다.
  5. 통합 편집기에 있는 For Each 병렬 태스크 요소를 클릭하여 배치합니다.
  6. 디자이너에서 For Each 병렬 태스크 요소를 클릭하여 For Each 병렬 태스크 구성 창을 엽니다.
  7. 다음 표의 설명대로 태스크의 구성 속성을 사용하여 표시된 필드를 구성합니다.

    모든 변경사항은 자동으로 저장됩니다.

구성 속성

이 섹션에서는 For Each 병렬l 태스크의 구성 속성을 설명합니다.

입력 속성

속성 이름 매개변수 이름 데이터 유형 Description(설명)
배열 선택 List to iterate 문자열, 정수, Double 또는 JSON 유형의 배열입니다. 하위 통합을 실행해야 하는 값의 목록입니다. 목록의 각 값에 대해 별도의 하위 통합 스레드가 실행되고 모든 스레드가 병렬로 실행됩니다.

개별 배열 요소를 매핑할 위치 필드를 설정하여 반복 값을 하위 통합으로 전달할 수 있습니다.

기본 통합에서 하위 통합으로 추가 값을 추가 하위 통합 입력에 매핑 필드에 전달할 수도 있습니다.

하위 통합 세부정보 API Trigger ID 문자열 실행할 게시된 하위 통합의 트리거 ID입니다.

이 값은 하위 통합의 API 트리거의 트리거 ID 필드에서 확인할 수 있습니다.

Execution strategy N/A

SYNC - 동기 모드로 하위 통합을 실행합니다. 이 모드에서 기본 통합은 하위 통합이 완료될 때까지 기다린 후 다운스트림 태스크를 계속 진행합니다.

ASYNC - 비동기 모드로 하위 통합을 실행합니다. 이 모드에서 기본 통합은 하위 통합이 완료될 때까지 기다리지 않습니다. 하위 통합을 호출한 직후에는 기본 통합에서 다운스트림 태스크를 실행합니다.
Run all integrations with this API Trigger ID N/A 동일한 API 트리거 ID가 있는 모든 통합을 실행합니다.

예를 들어 통합 A 및 통합 B에 동일한 API 트리거 ID가 있는 경우 A 및 B 통합 모두가 반복 목록의 항목마다 실행됩니다.

참고: 이 옵션을 선택하면 하위 통합의 응답을 기본 통합에서 사용할 수 없습니다. 하위 통합 응답을 사용하려면 단일 통합 실행 옵션을 선택합니다.

Run a single integration N/A 통합 이름 필드에 지정된 통합만 실행합니다. 하위 통합 출력에서 값 수집 섹션을 구성하여 하위 통합의 응답을 사용할 수 있습니다.

각 실행 Where to map individual array elements 문자열 배열 요소를 매핑해야 하는 하위 통합 입력 변수의 이름입니다. 배열 요소를 하위 통합 입력 변수에 직접 매핑할 수 있습니다. 단일 하위 통합을 선택하면 드롭다운 목록에서 하위 통합 입력 변수를 선택할 수 있습니다.
Map to additional sub-integration input(s) 문자열 추가 하위 통합 매핑 옵션입니다.
  • 매핑할 통합 변수: 현재 통합 변수의 이름으로, 하위 통합의 입력 변수에 전달됩니다.
  • 매핑할 하위 통합 입력: 매핑할 하위 통합 입력 변수의 이름입니다.

이 필드는 키-값 쌍의 형태로 값을 사용합니다. 여기서 키는 기본 통합의 변수이며 값은 하위 통합의 해당 입력 변수입니다.

예를 들어 기본 통합에 subIntProductID 하위 통합 변수에 매핑하려는 productID 변수가 있다고 가정해 보겠습니다. 매핑할 통합 변수 필드에서 productID를 선택하고 매핑할 하위 통합 입력 필드에 subIntProductID를 입력합니다.
Collect values from sub-integration output(s) 문자열 실행 전략이 동기식(SYNC)이고 단일 하위 통합(단일 통합 실행)이 선택된 경우 하위 통합의 출력을 현재 통합의 배열 변수로 수집할 수 있습니다.
  • 수집할 하위 통합 출력: 집계할 하위 통합 출력 변수의 이름입니다.
  • 수집할 통합 변수: 집계 출력을 수집할 현재 통합의 변수 이름입니다.
실행 설정 Integrations to execute at a time (parallel) 정수 하위 통합에 허용되는 최대 동시 실행 수입니다. 기본값은 50(최대 10000)입니다.

동질 집단의 모든 하위 통합이 하위 통합의 다음 동질 집단이 실행되기 전에 완전히 실행됩니다.

Ignore failures 불리언

다음 값 중 하나를 지정할 수 있습니다.

  • True: 태스크가 하위 통합 실패를 무시하고 모든 실행을 실행합니다.
  • False: 하위 통합 실패로 인해 태스크가 실패하고 모든 실행이 종료됩니다.

권장사항

For Each 병렬 태스크를 사용할 때 다음 권장사항을 따르는 것이 좋습니다.

  • 하위 통합에 따라 적용되는 할당량 제한을 토대로 동질 집단 크기를 설정합니다.
  • 나중에 사용할 하위 통합의 출력을 수집하려면 SYNC 실행 전략을 사용합니다.
  • 하위 통합이 2분 넘게 실행될 수 있는 경우 ASYNC 실행 전략을 사용합니다.

For Each 병렬 태스크에 적용되는 사용량 한도에 대한 자세한 내용은 사용량 한도를 참조하세요.

고려사항

일반적으로 하위 통합이 실행하는 데 2분 넘게 걸리거나 이 태스크를 승인 태스크와 같은 자연 비동기 태스크와 함께 사용할 계획이 있는 경우 SYNC 실행 전략을 사용하지 마세요.

오류 처리 전략

태스크의 오류 처리 전략은 일시적인 오류로 인해 태스크가 실패할 경우 수행할 태스크를 지정합니다. 오류 처리 전략을 사용하는 방법과 다양한 유형의 오류 처리 전략에 대한 자세한 내용은 오류 처리 전략을 참조하세요.