스크립트 구성 요소를 사용하여 오류 출력 향상
적용 대상: Azure Data Factory의 
SQL Server SSIS Integration Runtime
기본적으로 Integration Services 오류 출력의 추가 열인 ErrorCode 및 ErrorColumn에는 오류 번호를 나타내는 숫자 코드와 오류가 발생한 열의 ID만 포함됩니다. 이러한 숫자 값은 해당 오류 설명과 열 이름이 없으므로 사용이 제한될 수 있습니다.
이 항목에서는 스크립트 구성 요소를 사용하여 데이터 흐름의 기존 오류 출력 데이터에 오류 설명 및 열 이름을 추가하는 방법을 설명합니다. 이 예제에서는 스크립트 구성 요소의 ComponentMetaData 속성을 통해 사용할 수 있는 IDTSComponentMetaData100 인터페이스의 GetErrorDescription 메서드를 사용하여 미리 정의된 특정 Integration Services 오류 코드에 해당하는 오류 설명을 추가합니다. 그런 다음, 동일한 인터페이스의 메서드를 사용하여 GetIdentificationStringByID 캡처된 계보 ID에 해당하는 열 이름을 추가하는 예제입니다.
참고 항목
여러 데이터 흐름 태스크 및 여러 패키지에서 쉽게 다시 사용할 수 있는 구성 요소를 만들려면 이 스크립트 구성 요소 예제에 있는 코드를 바탕으로 사용자 지정 데이터 흐름 구성 요소를 만들어 보십시오. 자세한 내용은 사용자 지정 데이터 흐름 구성 요소 개발을 참조하세요.
예시
여기에 표시된 예제에서는 변환으로 구성된 스크립트 구성 요소를 사용하여 데이터 흐름의 기존 오류 출력 데이터에 오류 설명 및 열 이름을 추가합니다.
데이터 흐름에서 변환으로 사용할 스크립트 구성 요소를 구성하는 방법에 대한 자세한 내용은 스크립트 구성 요소를 사용하여 동기 변환 만들기 및 스크립트 구성 요소를 사용하여 비동기 변환 만들기를 참조하세요.
스크립트 구성 요소 예를 구성하려면
새 스크립트 구성 요소를 만들기 전에 데이터 흐름의 업스트림 구성 요소에서 오류 또는 잘림이 발생할 경우 행을 오류 출력으로 리디렉션하도록 구성합니다. 테스트를 위해 예를 들어 조회가 실패하는 두 테이블 간에 조회 변환을 구성하여 오류가 발생하도록 하는 방식으로 구성 요소를 구성할 수 있습니다.
데이터 흐름 디자이너 화면에 새 스크립트 구성 요소를 추가하고 변환으로 구성합니다.
업스트림 구성 요소의 오류 출력을 새 스크립트 구성 요소에 연결합니다.
스크립트 변환 편집기를 열고 스크립트 페이지에서 ScriptLanguage 속성에 대해 스크립트 언어를 선택합니다.
스크립트 편집을 클릭하여 VSTA(Microsoft Visual Studio Tools for Applications) IDE를 열고 아래에 표시된 샘플 코드를 추가합니다.
VSTA를 닫습니다.
스크립트 변환 편집기에서 입력 열 페이지에서 ErrorCode 및 ErrorColumn 열을 선택합니다.
입력 및 출력 페이지에서 두 개의 새 열을 추가합니다.
ErrorDescription이라는 문자열 형식의 새 출력 열을 추가합니다. 긴 메시지를 지원하려면 새 열의 기본 길이를 255로 늘입니다.
ColumnName이라는 문자열 형식의 또 다른 새 출력 열을 추가합니다. 긴 값을 지원할 수 있도록 새 열의 기본 길이를 255로 늘립니다.
스크립트 변환 편집기를 닫습니다.
스크립트 구성 요소의 출력을 적절한 대상에 연결합니다. 플랫 파일 대상은 임시 테스트를 위해 구성하는 가장 쉬운 대상입니다.
패키지를 실행합니다.
Public Class ScriptMain ' VB
Inherits UserComponent
Public Overrides Sub Input0_ProcessInputRow(ByVal Row As Input0Buffer)
Row.ErrorDescription = _
Me.ComponentMetaData.GetErrorDescription(Row.ErrorCode)
Dim componentMetaData130 = TryCast(Me.ComponentMetaData, IDTSComponentMetaData130)
If componentMetaData130 IsNot Nothing Then
If Row.ErrorColumn = 0 Then
' 0 means no specific column is identified by ErrorColumn, this time.
Row.ColumnName = "Check the row for a violation of a foreign key constraint."
ELSE If Row.ErrorColumn = -1 Then
' -1 means you are using Table Lock for a Memory Optimised destination table which is not supported.
Row.ColumnName = "Table lock is not compatible with Memory Optimised tables."
Else
Row.ColumnName = componentMetaData130.GetIdentificationStringByID(Row.ErrorColumn)
End If
End If
End Sub
End Class
public class ScriptMain: // C#
UserComponent
{
public override void Input0_ProcessInputRow(Input0Buffer Row)
{
Row.ErrorDescription = this.ComponentMetaData.GetErrorDescription(Row.ErrorCode);
var componentMetaData130 = this.ComponentMetaData as IDTSComponentMetaData130;
if (componentMetaData130 != null)
{
// 0 means no specific column is identified by ErrorColumn, this time.
if (Row.ErrorColumn == 0)
{
Row.ColumnName = "Check the row for a violation of a foreign key constraint.";
}
// -1 means you are using Table Lock for a Memory Optimised destination table which is not supported.
else if (Row.ErrorColumn == -1)
{
Row.ColumnName = "Table lock is not compatible with Memory Optimised tables.";
}
else
{
Row.ColumnName = componentMetaData130.GetIdentificationStringByID(Row.ErrorColumn);
}
}
}
}
참고 항목
데이터 오류 처리
데이터 흐름 구성 요소에서 오류 출력 사용
스크립트 구성 요소를 사용하여 동기 변환 만들기