런타임 변수 편집

파이프라인 작업의 런타임 매개변수로 사용할 수 있는 변수 세트를 선택하는 방법을 보여줍니다.

변수 페이지에서 파이프라인 작업의 런타임 매개변수로 사용할 수 있는 변수 세트를 선택할 수 있습니다. 파이프라인을 실행하는 경우 해당 변수에 대한 입력 값이 제공됩니다. 이 값은 미리 정의된 값 또는 런타임 값 세트로 이 매개변수 값을 개별 작업에 대해 사용할 수 있습니다. 변수는 "기간", "임포트 모드" 또는 "익스포트 모드"와 같은 사전 정의된 유형일 수 있습니다.

사용자정의 변수 매개변수를 작업 매개변수로 추가할 수도 있습니다. 예를 들어 시작 기간에 대해 대체 변수를 사용하여 정적 값을 전달하려는 경우 변수 유형을 "텍스트"로 변경한 후 대체 변수를 통합 REST API에서 허용되는 매개변수(예: &ThisMonth#&ThisYear)로 지정합니다. 대체 변수는 앞에 앰퍼샌드(&)가 한 개 또는 두 개 있는 사용자 변수 이름입니다.

기본 런타임 변수는 다음과 같습니다.

  • 시작 기간
  • 종료 기간
  • 임포트 모드
  • 익스포트 모드
  • 메일 전송
  • 전송 대상
  • 로그 첨부
  • 단계 실행

파이프라인 런타임 변수를 수정하려면 다음을 수행합니다.

  1. Data Integration 홈 페이지에서 파이프라인 오른쪽에 있는 선택 아이콘 이미지을 누르고 파이프라인 세부정보를 선택합니다.

  2. 파이프라인 페이지에서 변수 탭을 선택합니다.

  3. 수정할 변수를 선택합니다.

  4. 변수 이름에서 사전 정의된 변수 이름을 추가 또는 수정하려면 해당 이름을 지정합니다.

    변수 이름을 작업 매개변수로 참조할 수 있습니다. 이름에는 최대 20자를 사용할 수 있으며 공백을 포함할 수 없습니다.

  5. 표시 이름에서 변수의 표시 프롬프트 이름을 지정합니다.

  6. 표시 순서에서 변수 표시 순서를 지정합니다.

  7. 파이프라인을 실행하려면 변수 값이 필수인 경우 필수를 선택합니다.

  8. 검증 유형 드롭다운에서 변수 검증에 사용되는 값 유형을 선택합니다.

    검증 유형은 다음과 같습니다.

    • 목록—LOV 쿼리를 사용하며 바인드 값이 필수입니다.
    • 텍스트—무형식 텍스트 필드입니다.
    • 파일—파일 이름입니다. 파일 브라우저 창에서 파일을 선택할 수 있습니다.

    • 사용자정의 목록—사용자정의 값 목록입니다.

      이 검증 유형을 사용하려면 검증 매개변수 창에서 값 목록을 제공합니다. 값은 값,레이블 형식으로 지정해야 하며 모든 라인은 줄바꿈 문자로 종료되어야 합니다. 예를 들어 다음과 같습니다.

      M,Month
      Q,Quarter
      Y,Year
    • 룩업—사용가능한 룩업 값을 사용합니다.

  9. 검증 매개변수 드롭다운에서 검증 유형을 기반으로 변수의 사전 정의된 매개변수를 선택합니다.

    예를 들어 목록 검증 유형을 기반으로 다음과 같은 시작 기간 변수 매개변수를 선택할 수 있습니다.

    • 파이프라인 상태
    • 파이프라인 익스포트 모드 LOV 쿼리
    • 글로벌 기간 이름 LOV 쿼리
    • 위치 보안 없음 LOV 쿼리
    • Trial Balance Converted by Target Entity/Account Query
    • 프로세스 모니터 쿼리
  10. 기본값에서 변수의 기본값을 선택합니다.

    기본값은 정적 값일 수도 있고 Planning 대체 변수일 수도 있습니다.

    기본 런타임 변수 및 해당 설명은 다음 표에 나와 있습니다.

    Table 12-40 기본 런타임 변수 및 설명

    변수 이름 사용가능한 값
    시작 기간 파이프라인의 임포트/익스포트 처리 범위에 포함된 첫번째 기간을 지정합니다. 데이터 교환 단계에서 처리할 기간의 데이터를 결정하기 위해 사용하는 기간 범위의 시작 부분을 설정합니다(종종 종료 기간과 함께 사용됨).
    종료 기간 파이프라인의 임포트/익스포트 처리 범위에 포함된 마지막 기간을 지정합니다. 데이터 교환 단계에서 처리할 기간의 데이터를 정의하기 위해 사용하는 기간 범위의 종료 부분을 설정합니다(시작 기간과 함께 사용됨).
    임포트 모드

    임포트 단계 중 데이터 교환 파이프라인에서 수신 데이터 로드를 처리하는 방법, 즉 임포트가 기존 데이터를 대체하는지 또는 타겟의 기존 데이터를 추가하거나 업데이트하는지 지정합니다.

    • 바꾸기: (기본값) 임포트 범위에 대한 기존 타겟 데이터를 바꾼 다음 새 데이터를 로드합니다.
    • 추가: 기존 타겟 데이터를 유지하고 새 레코드를 추가하거나 임포트 규칙을 기반으로 일치하는 레코드를 업데이트합니다.
    • 임포트 안함: 데이터를 로드하지 않습니다.
    • 매핑 및 검증: 정의된 매핑 및 검증 규칙을 사용하여 임포트를 실행함으로써 소스 데이터를 변환 및 검증하지만 데이터를 타겟에 기록하지는 않습니다. 로드/커밋 모드를 수행하기 전에 파일/형식, 매핑 적용 범위 및 규칙 검증을 확인하고 오류 또는 경고를 검토하는 데 사용됩니다.
    익스포트 모드

    데이터 교환 파이프라인이 데이터를 익스포트하는 방법을 지정합니다.

    • 병합: (기본값) 현재 실행 범위의 데이터만 익스포트하고 타겟 파일/위치의 기존 익스포트 출력과 결합합니다. 키가 일치하는 경우 기존 레코드를 업데이트할 수 있으며 새 레코드가 추가됩니다.
    • 누적: 현재 실행의 익스포트 출력을 기존 출력에 추가 레코드 세트(추가만 가능)로 추가하여 이전에 익스포트된 콘텐츠를 보존합니다.
    • 바꾸기: 현재 실행 범위에 대한 새 익스포트 출력을 생성하고 타겟 위치의 기존 익스포트 파일/콘텐츠를 덮어씁니다.
    • 가상 실행: 최종 익스포트 출력을 생성하거나 작성하지 않고 익스포트 프로세스(범위 선택, 형식 지정, 검증)를 실행하여 파일을 생성하기 전에 결과를 확인하고 문제를 감지할 수 있습니다.
    • 익스포트 안함: 데이터를 익스포트하지 않습니다.
    메일 전송

    파이프라인이 파이프라인 실행에 대한 전자메일 통지를 전송할지 여부를 제어합니다.

    • 항상: 결과(성공, 경고 또는 실패)에 관계없이 모든 파이프라인 실행에 대한 전자메일 통지를 전송합니다.
    • 아니요: (기본값) 파이프라인 실행에 대한 전자메일 통지를 전송하지 않습니다.
    • 실패 시: 파이프라인 실행이 실패하거나 오류 상태로 끝나는 경우에만 전자메일 통지를 전송합니다.
    • 성공 시: 파이프라인 실행이 성공적으로 완료된 경우에만 전자메일 통지를 전송합니다.
    전송 대상 메일 전송이 사용으로 설정된 경우 파이프라인 실행 통지에 대한 전자메일 수신자 목록을 지정합니다.
    로그 첨부

    파이프라인 실행에 대한 실행 로그가 파이프라인 결과/통지와 함께 첨부파일로 포함되는지 여부를 제어합니다(예: 작업 출력 또는 구성된 전자메일/통지 페이로드).

    • 아니요: (기본값) 로그를 첨부하지 않습니다.
    • 예: 로그를 첨부합니다.
    단계 실행
    • 처음부터 시작: (기본값) 파이프라인이 실패하면 프로세스를 처음부터 다시 시작합니다.
    • 실패 지점부터 시작: 파이프라인이 실패하면 프로세스를 재시작하는 대신 마지막으로 실패한 단계부터 작업이 시작됩니다. 실패한 단계부터 파이프라인을 재시작하면 이전 단계의 작업 상태가 새 파이프라인 실행으로 그대로 이어집니다.

    Note:

    실패 지점부터 시작을 선택했지만 파이프라인이 성공한 경우 파이프라인이 실행되지 않습니다.
  11. 저장을 누릅니다.