Поделиться через

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 переопределяется разработчиками компонентов, чтобы убедиться, что компонент настроен правильно. Он вызывается многократно во время разработки пакета и один раз перед выполнением компонента. Компоненты не должны изменять его ComponentMetaData во время Validate.

Реализация Validate базового класса проверяет наличие IDTSInputColumn100 объектов, свойство которых LineageID не соответствует LineageID вышестоящему IDTSOutputColumn100 компоненту. Разработчики компонентов должны расширить функциональные возможности базового классаValidate, выполняя дополнительные проверки.ComponentMetaData Каждый компонент имеет разные требования к успешной проверке, но в следующем списке приведены некоторые распространенные элементы, которые должны быть проверены.

  • Убедитесь, что компонент имеет ожидаемое количество IDTSInput100 и IDTSOutput100 объекты.

  • Убедитесь, что все IDTSCustomProperty100 объекты продолжают существовать и содержат правильные значения.

  • Если компонент использует соединение, он должен убедиться, что IDTSRuntimeConnection100 он указан и что ConnectionManager он существует в пакете.

Компоненты должны предоставлять пользователям обратную связь при сбое проверки. Обратная связь предоставляется с помощью FireError методов и FireWarning возвращаемого DTSValidationStatus значения. FireError Вызовы и FireWarning отображаются в окне списка ошибок в SQL Server Data Tools (SSDT) и должны предоставлять пользователям рекомендации по сбою проверки. Из четырех значений перечисления DTSValidationStatus указывает только VS_ISVALID на успешную проверку. Остальные три значения указывают на различные уровни сбоя. В следующей таблице описаны значения сбоев в перечислении и их интерпретация конструктором служб SSIS.

Состояние Описание
VS_ISBROKEN Указывает, что компонент не настроен неправильно, но изменения, внесенные пользователем в ComponentMetaData решение проблем.
VS_NEEDSNEWMETADATA Указывает, что ошибки проверки могут быть устранены компонентом в его реализации ReinitializeMetaData метода. Конструктор служб SSIS предложит пользователям, что компонент может восстановить себя при VS_NEEDSNEWMETADATAвызове и последующем ReinitializeMetaData вызове.
VS_ISCORRUPT Указывает, что ComponentMetaData поврежден и не может быть исправлен вызовом ReinitializeMetaData или изменениями компонента.

DelayValidation Если свойство задачи потока данных имеет значениеtrue, вызовы Validate времени разработки исключаются и метод вызывается перед выполнением компонента.

Дополнительные сведения см. в разделе Проверка компонента потока данных.

Применяется к