데이터 흐름 구성 요소의 디자인 타임 메서드

적용 대상: Azure Data Factory SSIS Integration Runtime SQL Server

실행 전 데이터 흐름 태스크에서 증분 변경 작업이 수행될 때 해당 데이터 흐름 태스크는 디자인 타임 상태에 있다고 합니다. 변경 작업에는 구성 요소의 추가 또는 제거, 구성 요소를 연결하는 경로 개체의 추가 또는 제거, 구성 요소의 메타데이터 변경 등이 포함됩니다. 메타데이터가 변경되면 구성 요소에서는 변경 내용을 모니터링하고 그에 따라 반응할 수 있습니다. 예를 들어 변경에 대한 응답으로 구성 요소에서는 특정 변경 작업을 허용하지 않거나 추가 변경 작업을 수행할 수 있습니다. 디자인 타임에 디자이너는 디자인 타임 IDTSDesigntimeComponent100 인터페이스를 통해 구성 요소와 상호 작용합니다.

디자인 타임 구현

구성 요소의 디자인 타임 인터페이스는 IDTSDesigntimeComponent100 인터페이스에 의해 기술됩니다. 이 인터페이스를 명시적으로 구현하지는 않지만 이 인터페이스에 정의된 메서드를 잘 알고 있으면 구성 요소의 디자인 타임 인스턴스에 해당하는 PipelineComponent 기본 클래스의 메서드를 쉽게 이해할 수 있습니다.

구성 요소를 SSDT(SQL Server Data Tools)에 로드하면 구성 요소의 디자인 타임 인스턴스가 인스턴스화되고 구성 요소를 편집할 때 IDTSDesigntimeComponent100 인터페이스의 메서드가 호출됩니다. 기본 클래스의 구현을 사용하여 구성 요소에서 필요한 메서드만 재정의할 수 있습니다. 대부분의 경우 이러한 메서드를 재정의하여 구성 요소가 적절하지 않게 편집되는 것을 방지할 수 있습니다. 예를 들어 사용자가 구성 요소에 출력을 추가할 수 없도록 하려면 InsertOutput 메서드를 재정의합니다. 이 메서드를 재정의하지 않고 기본 클래스에 구현된 메서드를 호출하면 구성 요소에 출력이 추가됩니다.

구성 요소의 목적 또는 기능에 관계없이 ProvideComponentProperties, Validate 및 ReinitializeMetaData 메서드를 재정의해야 합니다. Validate 및 ReinitializeMetaData에 대한 자세한 내용은 데이터 흐름 구성 요소의 유효성 검사를 참조하세요.

ProvideComponentProperties 메서드

구성 요소는 ProvideComponentProperties 메서드에서 초기화됩니다. 이 메서드는 클래스 생성자와 비슷하며 데이터 흐름 태스크에 구성 요소를 추가하면 SSIS 디자이너에서 이 메서드가 호출됩니다. 구성 요소 개발자는 이 메서드가 호출될 때 구성 요소의 입력, 출력 및 사용자 지정 속성을 만들고 초기화해야 합니다. ProvideComponentProperties 메서드가 생성자와 다른 점은 구성 요소의 디자인 타임 인스턴스나 런타임 인스턴스가 인스턴스화될 때마다 호출되지는 않는다는 점입니다.

이 메서드의 기본 클래스 구현에서는 구성 요소에 입력 및 출력을 추가하고 SynchronousInputID 속성에 입력의 ID를 할당합니다. 그러나 SQL Server에서 기본 클래스에 의해 추가된 입력 및 출력 개체에는 이름이 지정되지 않습니다. 패키지의 구성 요소에 Name 속성이 설정되지 않은 입력 또는 출력 개체가 있는 경우 해당 패키지는 성공적으로 로드되지 않습니다. 따라서 기본 구현을 사용할 때는 기본 입력 및 출력의 Name 속성에 값을 명시적으로 할당해야 합니다.

public override void ProvideComponentProperties()  
{  
    /// TODO: Reset the component.  
    /// TODO: Add custom properties.  
    /// TODO: Add input objects.  
    /// TODO: Add output objects.  
}  

Public Overrides Sub ProvideComponentProperties()  
    ' TODO: Reset the component.  
    ' TODO: Add custom properties.  
    ' TODO: Add input objects.  
    ' TODO: Add output objects.  
End Sub  

사용자 지정 속성 만들기

구성 요소 개발자는 ProvideComponentProperties 메서드가 호출될 때 구성 요소에 사용자 지정 속성(IDTSCustomProperty100)을 추가해야 합니다. 사용자 지정 속성에는 데이터 형식 속성이 없습니다. 사용자 지정 속성의 데이터 형식은 Value 속성에 할당한 값의 데이터 형식에 따라 설정됩니다. 그러나 사용자 지정 속성에 초기 값을 할당한 후에는 데이터 형식이 다른 값을 할당할 수 없습니다.

다음 예제와 같이 ExpressionType 속성을 DTSCustomPropertyExpressionType 열거형의 CPET_NOTIFY로 설정하여 사용자 지정 속성이 속성 식을 지원하도록 지정할 수 있습니다. 사용자가 입력한 속성 식을 처리하거나 유효성을 검사하기 위한 코드를 추가할 필요는 없습니다. 속성의 기본값을 설정하고 해당 값의 유효성을 검사한 다음 값을 정상적으로 읽고 사용할 수 있습니다.

IDTSCustomProperty100 myCustomProperty;  
...  
myCustomProperty.ExpressionType = DTSCustomPropertyExpressionType.CPET_NOTIFY;  

Dim myCustomProperty As IDTSCustomProperty100  
...  
myCustomProperty.ExpressionType = DTSCustomPropertyExpressionType.CPET_NOTIFY  

다음 예와 같이 TypeConverter 속성을 사용하여 사용자가 열거형의 사용자 지정 속성 값만 선택하도록 제한할 수 있습니다. 이 예에서는 MyValidValues라는 공용 열거형을 정의했다고 가정합니다.

IDTSCustomProperty100 customProperty = outputColumn.CustomPropertyCollection.New();  
customProperty.Name = "My Custom Property";  
// This line associates the type with the custom property.  
customProperty.TypeConverter = typeof(MyValidValues).AssemblyQualifiedName;  
// Now you can use the enumeration values directly.  
customProperty.Value = MyValidValues.ValueOne;    

Dim customProperty As IDTSCustomProperty100 = outputColumn.CustomPropertyCollection.New   
customProperty.Name = "My Custom Property"   
' This line associates the type with the custom property.  
customProperty.TypeConverter = GetType(MyValidValues).AssemblyQualifiedName   
' Now you can use the enumeration values directly.  
customProperty.Value = MyValidValues.ValueOne  

자세한 내용은 MSDN Library의 "일반화된 형식 변환" 및 "방법: 형식 변환기 구현"을 참조하세요.

다음 예와 같이 UITypeEditor 속성을 사용하여 사용자 지정 속성의 값에 사용자 지정 편집기 대화 상자를 지정할 수 있습니다. 요구 사항에 맞는 기존 UI 형식 편집기 클래스를 찾을 수 없는 경우 먼저 System.Drawing.Design.UITypeEditor에서 상속하는 사용자 지정 형식 편집기를 만들어야 합니다.

public class MyCustomTypeEditor : UITypeEditor  
{  
...  
}  

Public Class MyCustomTypeEditor  
  Inherits UITypeEditor   
  ...  
End Class  

그런 다음 이 클래스를 사용자 지정 속성의 UITypeEditor 속성 값으로 지정합니다.

IDTSCustomProperty100 customProperty = outputColumn.CustomPropertyCollection.New();  
customProperty.Name = "My Custom Property";  
// This line associates the editor with the custom property.  
customProperty.UITypeEditor = typeof(MyCustomTypeEditor).AssemblyQualifiedName;  

Dim customProperty As IDTSCustomProperty100 = outputColumn.CustomPropertyCollection.New   
customProperty.Name = "My Custom Property"   
' This line associates the editor with the custom property.  
customProperty.UITypeEditor = GetType(MyCustomTypeEditor).AssemblyQualifiedName  

자세한 내용은 MSDN Library의 "방법: UI 형식 편집기 구현"을 참조하세요.

참고 항목

데이터 흐름 구성 요소의 런타임 메서드