Azure Data Factory 및 Synapse Analytics에서 Fail 작업 실행
파이프라인에서 의도적으로 오류를 throw하려는 경우도 있습니다. 조회 작업이 일치하는 데이터를 반환하지 않거나 사용자 지정 작업이 내부 오류로 인해 완료될 수 있습니다. 이유가 무엇이든 간에 이제 파이프라인에서 Fail 작업을 사용하고 해당 오류 메시지와 오류 코드를 모두 사용자 지정할 수 있습니다.
적용 대상: 
Azure Data Factory Azure Synapse Analytics
팁
기업용 올인원 분석 솔루션인 Microsoft Fabric의 Data Factory를 사용해 보세요. Microsoft Fabric은 데이터 이동부터 데이터 과학, 실시간 분석, 비즈니스 인텔리전스 및 보고에 이르기까지 모든 것을 다룹니다. 무료로 새 평가판을 시작하는 방법을 알아봅니다!
UI를 사용하여 Fail 작업 만들기
파이프라인에서 Fail 작업을 사용하려면 다음 단계를 완료합니다.
파이프라인 작업 창에서 Fail을 검색하고 Fail 작업을 파이프라인 캔버스로 끌어옵니다.
아직 선택하지 않은 경우 캔버스에서 새 Fail 작업 및 해당 설정 탭을 선택하여 세부 정보를 편집합니다.
오류 메시지 및 오류 코드를 입력합니다. 이러한 값은 리터럴 문자열 식이거나 동적 식, 함수, 시스템 변수 또는 다른 작업의 출력의 조합일 수 있습니다.
구문
{
"name": "MyFailActivity",
"type": "Fail",
"typeProperties": {
"errorCode": "500",
"message": "My Custom Error Message"
}
}
형식 속성
| 속성 | 설명 | 허용된 값 | 필수 |
|---|---|---|---|
| name | Fail 작업의 이름입니다. | 문자열 | 예 |
| type | Fail로 설정해야 합니다. | 문자열 | 예 |
| message | Fail 작업에서 나타난 오류 메시지입니다. 런타임에 평가할 동적 콘텐츠가 될 수 있습니다. | 문자열 | 예 |
| errorCode | Fail 작업의 오류 유형을 분류하는 오류 코드입니다. 런타임에 평가할 동적 콘텐츠가 될 수 있습니다. | 문자열 | 예 |
Fail 작업 오류 코드 이해
파이프라인 작성자는 일반적으로 실패 작업의 오류 메시지와 오류 코드를 설정합니다. 오류 코드의 구체적인 의미를 이해하려면 파이프라인 개발자에게 문의하세요. 그러나 다음 에지 사례에서 Azure Data Factory는 오류 메시지 및/또는 오류 코드를 설정합니다.
| 상황 설명 | 오류 메시지 | 오류 코드 |
|---|---|---|
message 및 errorCode의 (동적) 콘텐츠가 올바르게 해석됩니다. |
사용자가 설정한 오류 메시지 | 사용자가 설정한 오류 코드 |
message 및 errorCode의 동적 콘텐츠는 해석할 수 없습니다. |
"<activity_name> 오류 메시지 또는 오류 코드를 해석하지 못했습니다." | ErrorCodeNotString |
message의 동적 콘텐츠는 문자열로 해석할 수 없습니다. |
"<activity_name> 실패 메시지 매개 변수를 문자열로 해석할 수 없습니다." | 사용자가 설정한 오류 코드 |
message의 동적 콘텐츠는 null, 빈 문자열 또는 공백으로 확인됩니다. |
"<activity_name> 오류 메시지 또는 오류 코드를 해석하지 못했습니다." | 사용자가 설정한 오류 코드 |
errorCode의 동적 콘텐츠는 문자열로 해석할 수 없습니다. |
사용자가 설정한 오류 메시지 | ErrorCodeNotString |
errorCode의 동적 콘텐츠는 null, 빈 문자열 또는 공백으로 확인됩니다. |
사용자가 설정한 오류 메시지 | ErrorCodeNotString |
사용자가 제공한 message 또는 errorCode 값은 문자열을 사용할 수 없습니다.* |
파이프라인이 실패함: "속성 <errorCode/message>의 값이 잘못되었습니다." |
|
message 필드가 없습니다.* |
"실패 메시지가 제공되지 않았습니다" | 사용자가 설정한 오류 코드 |
errorCode 필드가 없습니다.* |
사용자가 설정한 오류 메시지 | ErrorCodeNotString |
* 파이프라인이 Data Factory의 웹 UI(사용자 인터페이스)를 사용하여 개발된 경우에는 이 상황이 발생하지 않습니다.
관련 콘텐츠
다음을 포함하여 지원되는 다른 제어 흐름 작업을 참조하세요.