PipelineComponent.Validate 메서드

정의

네임스페이스:

Microsoft.SqlServer.Dts.Pipeline

어셈블리:

Microsoft.SqlServer.PipelineHost.dll

중요

이 API는 CLS 규격이 아닙니다.

구성 요소가 제대로 구성되었는지 확인합니다.

public:
 virtual Microsoft::SqlServer::Dts::Pipeline::Wrapper::DTSValidationStatus Validate();

[System.CLSCompliant(false)]
public virtual Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus Validate ();

[<System.CLSCompliant(false)>]
abstract member Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus
override this.Validate : unit -> Microsoft.SqlServer.Dts.Pipeline.Wrapper.DTSValidationStatus

Public Overridable Function Validate () As DTSValidationStatus

반환

DTSValidationStatus

구성 요소의 상태를 나타내는 DTSValidationStatus 열거형의 값입니다.

특성

CLSCompliantAttribute

설명

Validate 구성 요소가 올바르게 구성되었는지 확인하기 위해 구성 요소 개발자가 메서드를 재정의합니다. 패키지 디자인 중에 반복적으로 호출되고 구성 요소를 실행하기 전에 한 번 호출됩니다. 구성 요소는 .ComponentMetaDataValidate

속성이 Validate 업스트림 구성 요소의 속성과 일치하지 LineageIDIDTSOutputColumn100 않는 개체 LineageID 가 IDTSInputColumn100 있는지 확인하는 기본 클래스 구현입니다. 구성 요소 개발자는 에 대한 ComponentMetaData추가 검사를 수행하여 기본 클래스 Validate 기능을 확장해야 합니다. 각 구성 요소의 유효성 검사에 대한 요구 사항은 서로 다르지만 다음 목록에서는 유효성을 검사해야 하는 몇 가지 일반적인 항목을 제공합니다.

• 구성 요소에 예상되는 개수와 IDTSOutput100 개체가 IDTSInput100 있는지 확인합니다.

• 개체 IDTSCustomProperty100 가 계속 존재하고 올바른 값을 포함하는지 확인합니다.

• 구성 요소에서 연결을 사용하는 경우 해당 연결이 지정되었는지, 패키지에 ConnectionManager 있는지 확인해야 IDTSRuntimeConnection100 합니다.

유효성 검사에 실패하면 구성 요소가 사용자에게 피드백을 제공해야 합니다. 피드백은 반환 값과 FireWarning 메서드 DTSValidationStatus 를 FireError 통해 제공됩니다. FireErrorFireWarning 호출은 SQL Server Data Tools(SSDT)의 오류 목록 창에 표시되며 유효성 검사 실패에 대한 사용자 지침을 제공해야 합니다. 열거형의 4개 값 DTSValidationStatus 중 유효성 검사 성공만 VS_ISVALID 나타냅니다. 다른 세 값은 서로 다른 실패 수준을 나타냅니다. 다음 표에서는 열거형의 실패 값과 SSIS 디자이너에서 오류 값을 해석하는 방법을 설명합니다.

상태	설명
VS_ISBROKEN	구성 요소가 잘못 구성되지 않았지만 사용자가 구성 요소를 변경하면 ComponentMetaData 문제가 해결됨을 나타냅니다.
VS_NEEDSNEWMETADATA	메서드 구현 ReinitializeMetaData 의 구성 요소에서 유효성 검사 오류를 수정할 수 있음을 나타냅니다. SSIS 디자이너는 구성 요소가 나중에 호출될 때 VS_NEEDSNEWMETADATA자체적으로 복구할 수 있다는 메시지를 사용자에게 표시합니다 ReinitializeMetaData .
VS_ISCORRUPT	구성 요소에 ComponentMetaData 대한 호출 ReinitializeMetaData 또는 편집을 통해 손상되어 복구할 수 없음을 나타냅니다.

DelayValidation 데이터 흐름 태스크의 속성이 있으면 true디자인 타임 호출 Validate 이 제거되고 구성 요소가 실행되기 전에 메서드가 호출됩니다.

자세한 내용은 데이터 흐름 구성 요소에 대한 유효성 검사를 참조하세요.