PipelineComponent.Validate 메서드

정의

네임스페이스:: Microsoft.SqlServer.Dts.Pipeline

어셈블리:: Microsoft.SqlServer.PipelineHost.dll

중요

일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

Important

이 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 이 메서드는 컴포넌트 개발자가 컴포넌트가 올바르게 구성되었는지 검증하기 위해 덮어씁니다. 패키지 설계 중에는 반복적으로 호출되며, 컴포넌트 실행 전에 한 번 호출됩니다. 구성 요소는 그 기간 동안 ComponentMetaData변경 Validate 해서는 안 됩니다.

기본 클래스 구현 Validate 은 상위 구성 요소의 속성이 와 IDTSOutputColumn100 일치 LineageID 하지 않는 객체 LineageID 의 IDTSInputColumn100 존재 여부를 검사합니다. 컴포넌트 개발자는 .Validate ComponentMetaData 각 구성 요소마다 성공적인 검증을 위한 요구사항이 다르지만, 다음 목록은 검증되어야 하는 일반적인 항목들을 제공합니다.

컴포넌트가 기대되는 수의 IDTSInput100 와 IDTSOutput100 객체를 가지고 있는지 확인하세요.
객체가 IDTSCustomProperty100 계속 존재하는지, 올바른 값을 포함하는지 확인하세요.
컴포넌트가 연결을 사용한다면, 해당 IDTSRuntimeConnection100 가 지정되어 있고 패키지 ConnectionManager 에 존재하는지 확인해야 합니다.

컴포넌트는 검증에 실패할 때 사용자에게 피드백을 제공해야 합니다. 피드백은 and FireError 메서드와 반환값을 FireWarning 통해 DTSValidationStatus 제공됩니다. 와 에 대한 FireError 호출은 SQL Server Data Tools(SSDT)의 오류 목록 창에 표시되며, 검증 실패에 대한 사용자 안내를 제공해야 합니다.FireWarning 열거 중 네 가지 값 DTSValidationStatus 중 는 오직 검증 성공을 VS_ISVALID 나타냅니다. 나머지 세 가지 값은 서로 다른 고장 수준을 나타냅니다. 다음 표는 열거 내에서의 실패 값과 SSIS 디자이너가 이를 어떻게 해석하는지 설명합니다.

상태	Description
VS_ISBROKEN	구성 요소가 잘못 설정되어 있지 않으며, 사용자가 ComponentMetaData 변경하여 문제를 해결할 수 있음을 나타냅니다.
VS_NEEDSNEWMETADATA	검증 오류가 컴포넌트가 메서드 구현 ReinitializeMetaData 시 수정할 수 있음을 나타냅니다. SSIS 디자이너는 , 그리고 이후 ReinitializeMetaData 호출될 때 VS_NEEDSNEWMETADATA해당 컴포넌트가 스스로 복구할 수 있음을 사용자에게 안내합니다.
VS_ISCORRUPT	이 코드가 손상되었음을 나타내며, 컴포넌트에 호출 ReinitializeMetaData 하거나 편집을 통해 복구할 수 없음을 나타냅니다ComponentMetaData.

데이터 흐름 작업의 속성이 DelayValidation 일 true때, 설계 시간 호출 Validate 이 제거되고 메서드는 구성 요소 실행 전에 호출됩니다.

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

적용 대상