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

커넥터 태스크

커넥터 태스크를 통해 Integration Connectors에서 즉시 사용 가능한 커넥터를 사용하여 통합 시 다양한 Google Cloud 서비스 및 기타 비즈니스 애플리케이션에 빠르고 안전하게 연결할 수 있습니다.

Application Integration에 지원되는 모든 커넥터 목록은 커넥터 참조를 확인하세요.

시작하기 전에

  • Google Cloud 프로젝트에 커넥터 관리자(roles/connectors.admin) IAM 역할이 부여되었는지 확인합니다. 역할 부여에 대한 자세한 내용은 액세스 관리를 참조하세요.
  • Integration Connectors의 일반적인 개념을 알아봅니다.
  • 커넥터를 사용하여 Google Cloud 서비스 및 기타 비즈니스 애플리케이션에 연결하려면 통합에 사용자 관리형 서비스 계정을 연결했는지 확인합니다. 통합에 사용자 관리형 서비스 계정이 구성되어 있지 않으면 기본적으로 인증에 기본 서비스 계정(service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com)이 사용됩니다.
  • 서비스 계정에 필요한 IAM 역할이 있는지 확인합니다. 서비스 계정에 역할 부여에 대한 자세한 내용은 서비스 계정에 대한 액세스 관리를 참조하세요.

커넥터 태스크 추가

통합에 커넥터 태스크를 추가하려면 다음을 수행합니다.

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

    Application Integration으로 이동

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

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

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

    새 통합을 만드는 경우:

    1. 통합 만들기 창에 이름과 설명을 입력합니다.
    2. 통합 리전을 선택합니다.
    3. 통합을 위한 서비스 계정을 선택합니다. 통합 툴바의 통합 요약 창에서 언제든지 통합에 대한 서비스 계정 세부정보를 변경하거나 업데이트할 수 있습니다.
    4. 만들기를 클릭합니다.

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

  4. 통합 편집기 탐색 메뉴에서 태스크를 클릭하여 사용 가능한 태스크 목록을 확인합니다.
  5. 커넥터 요소를 클릭하고 통합 편집기에 배치합니다.

커넥터 태스크 구성

커넥터 태스크를 구성하려면 다음을 수행합니다.

  1. 디자이너에서 커넥터 태스크 요소를 클릭하여 커넥터 태스크 구성 창을 확인합니다.

    선택적으로 를 클릭하여 태스크 이름을 수정합니다.

  2. 커넥터 구성을 클릭합니다.
  3. 리전의 기존 연결을 선택하거나 새 연결을 생성할 수 있습니다. 기존 연결을 구성하려면 커넥터 태스크 편집기 페이지에서 다음 단계를 완료합니다.
    1. 커넥터 선택에서 연결 리전을 선택합니다.
    2. 선택한 리전의 사용 가능한 연결 목록에서 기존 연결을 선택합니다.
    3. 다음을 클릭합니다.
    4. 유형 목록에서 항목 또는 작업을 선택합니다.
      • 항목을 선택하면 연결에 지원되는 항목 목록이 항목/작업 설정 섹션에 표시됩니다. 항목을 선택하고 해당 항목에서 수행하려는 작업을 선택합니다.
      • 작업을 선택하면 연결에 지원되는 작업 목록이 항목/작업 설정 열에 표시됩니다. 연결 작업을 선택합니다.
      • 지원되는 항목 및 작업은 커넥터 유형을 기반으로 합니다. Application Integration에 지원되는 모든 커넥터 목록은 커넥터 참조를 확인하세요. 커넥터에 지원되는 작업 및 항목을 보려면 특정 커넥터 문서를 참조하세요.

        커넥터에서 커스텀 SQL 쿼리가 지원되는 경우 작업 목록에서 커스텀 쿼리 실행 옵션을 선택할 수 있습니다. 커넥터에 대해 커스텀 SQL 쿼리를 추가하는 방법에 대한 자세한 내용은 작업: 커스텀 SQL 쿼리 실행을 참조하세요.

    5. 완료를 클릭하여 연결 구성을 완료하고 창을 닫습니다.
    6. 다음 이미지는 커넥터 태스크 편집기 페이지의 샘플 레이아웃을 보여줍니다. 커넥터 태스크 구성 대화상자를 보여주는 이미지 커넥터 태스크 구성 대화상자를 보여주는 이미지

태스크 입력 및 출력 변수 구성

커넥터 태스크 구성 창에는 커넥터 태스크 구성 대화상자에서 선택한 항목 및 작업 또는 조치를 기반으로 자동 생성된 태스크 입력태스크 출력 변수가 표시됩니다. 이러한 변수는 구성 가능하며, 현재 태스크에 대한 입력 또는 현재 통합에 후속 태스크 또는 조건에 대한 출력으로 액세스될 수 있습니다.

태스크 입력 또는 태스크 출력 변수를 구성하려면 해당 변수를 클릭하여 변수 구성 창을 열고 다음 단계를 수행합니다.

  1. 기본값 필드에 변수 값을 입력합니다.
  2. (선택사항) 통합의 입력으로 사용 또는 통합의 출력으로 사용을 선택합니다.
  3. 저장을 클릭합니다.

커넥터 태스크의 입력 및 출력 매개변수에 대한 자세한 내용은 항목 작업을 참조하세요.

항목 작업 및 조치

커넥터의 항목에서 CRUD(만들기, 읽기, 업데이트, 삭제) 작업을 수행할 수 있습니다. 이러한 각 항목 작업에는 서로 다른 입력 및 출력 매개변수 집합이 있습니다. 다음 표에는 다양한 항목 작업의 입력 및 출력 매개변수가 나와 있습니다.

작업 이름 입력 매개변수 출력 매개변수
목록
  • listEntitiesPageSize
  • listEntitiesPageToken
  • listEntitiesSortByColumns
  • filterClause
  • connectorOutputPayload
  • listEntitiesNextPageToken
설치 entityId connectorOutputPayload
만들기 connectorInputPayload connectorOutputPayload
업데이트
  • connectorInputPayload
  • entityId
  • filterClause
connectorOutputPayload
삭제
  • entityId
  • filterClause
해당 사항 없음

입력 매개변수

다음 표에서는 다양한 항목 작업의 입력 매개변수를 설명합니다.

매개변수 이름 데이터 유형 설명
entityId 문자열

액세스하려는 행의 고유 식별자입니다.

일반적으로 entityId는 테이블 또는 데이터 세트의 기본 키 값입니다. entityId에 값을 지정하고 테이블 또는 데이터 세트에 기본 키 열이 없는 경우 통합에서 런타임 오류를 보고하고 커넥터 작업이 실패합니다.

예를 들어 MySQL 테이블에서 특정 행을 가져오려면 entityId가 테이블의 기본 키 값입니다.

connectorInputPayload JSON 항목에 추가하거나 업데이트할 실제 데이터입니다. 다음 예시에서는 테이블에 추가할 행 데이터의 JSON 스니펫을 보여줍니다.
{
"employee_first_name": "John",
"employee_emailID": "test-05@test.com"
}
      

이 예시에서 employee_first_nameemployee_emailID는 해당 값이 Johntest-05@test.com인 열 이름입니다.

filterClause 문자열 조건에 따라 작업 결과를 제한합니다. 필터 절 추가에 대한 자세한 내용은 작업용 필터 추가를 참조하세요.
listEntitiesPageSize 정수

페이지에서 반환되어야 하는 결과의 수를 지정합니다.

페이지는 결과 세트의 레코드를 논리적으로 그룹화한 것입니다. 페이지 개념은 결과 세트에 많은 수의 레코드가 있을 것으로 예상되는 경우 유용합니다. 결과 세트가 크면 커넥터 작업이 처리할 수 있는 데이터 크기가 제한되므로 커넥터 작업이 실패할 수 있습니다. 결과 세트를 더 작은 단위로 분할하면 이 문제를 방지할 수 있습니다.

예를 들어 결과 세트에 레코드가 1,000개 있을 것으로 예상되는 경우 listEntitiesPageSize를 100으로 설정할 수 있습니다. 따라서 커넥터 태스크가 처음 실행되면 처음 100개의 레코드를 반환하고, 두 번째 실행 시 다음 100개의 레코드가 반환되는 식입니다.

listEntitiesPageToken 문자열

특정 페이지에 액세스할 수 있는 페이지 식별자(토큰)입니다.

listEntitiesNextPageToken 출력 매개변수에서 페이지 토큰 값을 가져올 수 있습니다. 페이지마다 고유한 토큰이 있으므로 결과 집합에서 원하는 페이지에 유연하게 액세스할 수 있습니다. 이 매개변수 사용을 이해하려면 listEntitiesNextPageToken 출력 매개변수 설명도 참조하세요.

listEntitiesSortByColumns 문자열 배열 결과 세트를 정렬하려는 열 이름입니다.

출력 매개변수

다음 표에서는 다양한 항목 작업의 출력 매개변수를 설명합니다.

매개변수 이름 데이터 유형 설명
connectorOutputPayload JSON JSON 형식의 작업 출력
listEntitiesNextPageToken 문자열

시스템에 대한 생성된 페이지 식별자입니다. 토큰은 결과 세트의 특정 페이지에 액세스할 수 있는 포인터라고 생각하면 됩니다.

listEntitiesPageSize 매개변수를 설정하여 결과 집합을 여러 페이지로 분할한 경우 페이지를 탐색하는 메커니즘이 필요합니다. listEntitiesNextPageToken 출력 매개변수를 사용하면 이를 정확하게 수행할 수 있습니다. 커넥터 태스크가 실행될 때마다 시스템은 다음 페이지의 토큰을 생성하고 listEntitiesNextPageToken 값을 새로 생성된 토큰으로 설정합니다. 그런 다음 이 토큰을 사용하여 결과 집합의 다음 페이지에 액세스할 수 있습니다. 다음 페이지에 액세스하려면 listEntitiesPageToken 입력 매개변수를 다음 페이지의 토큰 값으로 설정해야 합니다.

예를 들어 listEntitiesPageSize 매개변수를 2로 설정하고 커넥터 태스크를 처음 실행하면 listEntitiesNextPageTokenChoKC2VtcGxveWVlX2lkEgkRAAAAAAAA8D8YDw== 토큰 값으로 설정되었다고 가정합니다. 그런 다음 listEntitiesPageToken 입력 매개변수를 이 토큰 값으로 설정하여 이후에 커넥터 태스크의 후속 실행에서 다음 페이지를 가져올 수 있습니다.

결과 세트에 페이지 수가 많으면 각 루프용 태스크를 사용하여 커넥터 태스크를 반복해서 호출하고 데이터 매핑 태스크를 실행하여 각 실행 후 listEntitiesPageToken 입력 매개변수에 자동으로 토큰 값을 할당합니다.

항목 작업의 필터 절

태스크 입력으로 사용 가능한 필터 절 변수로 커넥터 태스크에서 처리되는 레코드를 제한할 수 있습니다. 예를 들어 삭제 작업의 경우 특정 orderId로 레코드를 삭제하는 필터 절을 추가할 수 있습니다.

필터 절은 다음 항목 작업의 경우에만 적용될 수 있습니다.

  • 목록
  • 삭제
  • 업데이트

이러한 작업을 선택하면 커넥터 태스크의 태스크 입력 섹션에 필터 절 필드가 자동으로 표시됩니다.

필터 절 추가

필터 절을 추가하려면 다음 단계를 수행하세요.

  1. 디자이너에서 커넥터 태스크 요소를 클릭하여 커넥터 태스크 구성 창을 확인합니다.
  2. 태스크 입력 섹션을 펼치고 filterClause(커넥터) 문자열 변수를 클릭합니다.

    변수 구성 대화상자가 나타납니다.

  3. 기본값 필드에 필터 절(절 구문 뒤에 있음)을 입력합니다.
  4. 저장을 클릭합니다.

필터 절 구문 및 예시

필터 절의 형식은 다음과 같습니다.

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 = '는 입력 행에 으로 입력됩니다.

작업: 커스텀 SQL 쿼리 실행

커스텀 쿼리를 만들려면 다음 단계를 수행합니다.

  1. 자세한 안내에 따라 커넥터 태스크를 추가합니다.
  2. 커넥터 태스크를 구성할 때 수행할 작업 유형에서 작업을 선택합니다.
  3. 작업 목록에서 커스텀 쿼리 실행을 선택한 후 완료를 클릭합니다.

    execute-custom-query-action을 보여주는 이미지 execute-custom-query-action을 보여주는 이미지

  4. 태스크 입력 섹션을 펼친 후 다음을 수행합니다.
    1. 다음 이후 시간 초과 필드에 쿼리가 실행될 때까지 대기할 시간(초)을 입력합니다.

      기본값: 180

    2. 최대 행 수 필드에 데이터베이스에서 반환될 최대 행 수를 입력합니다.

      기본값은 25입니다.

    3. 커스텀 쿼리를 업데이트하려면 커스텀 스크립트 수정을 클릭합니다. 스크립트 편집기 대화상자가 열립니다.

      custom-sql-query를 보여주는 이미지 custom-sql-query를 보여주는 이미지

    4. 스크립트 편집기 대화상자에서 SQL 쿼리를 입력하고 저장을 클릭합니다.

      SQL 문에서 물음표(?)를 사용하여 쿼리 매개변수 목록에 지정해야 하는 단일 매개변수를 나타낼 수 있습니다. 예를 들어 다음 SQL 쿼리는 Employees 테이블에서 LastName 열에 지정된 값과 일치하는 모든 행을 선택합니다.

      SELECT * FROM Employees where LastName=?

    5. SQL 쿼리에 물음표를 사용한 경우에는 물음표마다 + 매개변수 이름 추가를 클릭하여 매개변수를 추가해야 합니다. 통합을 실행하는 동안 이 매개변수는 SQL 쿼리의 물음표(?)를 순차적으로 대체합니다. 예를 들어 물음표(?) 3개를 추가한 경우 매개변수 3개를 순서대로 추가해야 합니다.

      add-query-param을 보여주는 이미지 add-query-param을 보여주는 이미지

      쿼리 매개변수를 추가하려면 다음을 수행합니다.

      1. 유형 목록에서 매개변수 데이터 유형을 선택합니다.
      2. 필드에 매개변수 값을 입력합니다.
      3. 여러 매개변수를 추가하려면 + 쿼리 매개변수 추가를 클릭합니다.

인라인 연결 만들기

커넥터 태스크를 사용하여 Integration Connectors에서 새 연결을 직접 만들 수 있습니다.

시작하기 전에

새 연결 만들기

Application Integration에서 새 연결을 만들려면 다음 단계를 수행합니다.

  1. 디자이너에서 커넥터 태스크 요소를 클릭하여 커넥터 태스크 구성 창을 확인합니다.
  2. 커넥터 구성을 클릭합니다.

    커넥터 태스크 편집기 페이지가 나타납니다.

  3. 리전 필드를 건너뜁니다.
  4. 연결을 클릭하고 드롭다운 메뉴에서 연결 만들기 옵션을 선택합니다.
  5. 연결 만들기 창에서 다음 단계를 완료합니다.
    1. 위치 단계에서 연결 위치를 선택합니다.
      1. 리전을 클릭하고 드롭다운 목록에서 위치를 선택합니다.
      2. 다음을 클릭합니다.
    2. 연결 세부정보 단계에서 연결에 대한 세부정보를 제공합니다.
      1. 커넥터: 드롭다운 목록에서 만들려는 커넥터 유형을 선택합니다. 지원되는 커넥터 목록은 모든 Integration Connectors를 참조하세요.
      2. 커넥터 버전: 드롭다운 목록에서 선택한 커넥터 유형의 사용 가능한 버전을 선택합니다.
      3. 연결 이름: 연결 인스턴스의 이름을 입력합니다.
      4. (선택사항) 연결 인스턴스에 대한 설명을 입력합니다.
      5. (선택사항) Cloud Logging 사용 설정을 선택하여 연결 인스턴스의 로그 데이터를 저장합니다.
      6. 서비스 계정: 필수 역할이 있는 서비스 계정을 선택합니다.
      7. (선택사항) 고급 설정을 클릭하여 연결 노드 설정을 구성합니다.

        자세한 내용은 Integration Connectors의 해당 연결 문서를 참조하세요.

      8. (선택사항) + 라벨 추가를 클릭하여 키/값 쌍의 형식으로 연결에 라벨을 추가합니다.
      9. 다음을 클릭합니다.
    3. 인증 단계에서 연결의 인증 세부정보를 제공합니다.
      1. 이 단계에서 입력되는 인증 방식은 생성 중인 연결 유형에 기반합니다.

        연결 유형에 따라 인증 방식이 달라집니다. 자세한 내용은 Integration Connectors에서 해당 연결 문서의 인증 구성 섹션을 참조하세요.

      2. 다음을 클릭합니다.
    4. 검토: 연결 및 인증 세부정보를 검토합니다.
    5. 만들기를 클릭합니다.

권장사항

오류 처리 전략

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