공용 속성

Microsoft SQL Server Integration Services 개체 모델의 데이터 흐름 개체에는 구성 요소 수준, 입/출력 수준 및 입/출력 열 수준의 공통 속성과 사용자 지정 속성이 있습니다. 많은 속성은 데이터 흐름 엔진이 런타임에 할당하는 읽기 전용 값을 갖습니다.

이 항목에서는 데이터 흐름 개체의 공용 속성을 나열하고 설명합니다.

  • 구성 요소

  • 입력

  • 입력 열

  • 출력

  • 출력 열

구성 요소 속성

Integration Services 개체 모델에서 데이터 흐름의 구성 요소는 IDTSComponentMetaData100 인터페이스를 구현합니다.

다음 표에서는 데이터 흐름 구성 요소의 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.

속성

데이터 형식

설명

ComponentClassID

String

구성 요소의 CLSID입니다.

ContactInfo

String

구성 요소 개발자의 연락처 정보입니다.

Description

String

데이터 흐름 구성 요소에 대한 설명입니다. 이 속성의 기본값은 데이터 흐름 구성 요소의 이름입니다.

ID

Integer

구성 요소의 인스턴스를 고유하게 식별하는 값입니다.

IdentificationString

String

구성 요소를 식별합니다.

IsDefaultLocale

Boolean

구성 요소가 속해 있는 데이터 흐름 태스크의 로캘이 구성 요소에 사용되는지 여부를 나타냅니다.

LocaleID

Integer

패키지가 실행될 때 데이터 흐름 구성 요소에서 사용하는 로캘입니다. 데이터 흐름 구성 요소에는 모든 Windows 로캘을 사용할 수 있습니다.

Name

String

데이터 흐름 구성 요소의 이름입니다.

PipelineVersion

Integer

구성 요소가 내부에서 실행되도록 디자인된 데이터 흐름 태스크의 버전입니다.

UsesDispositions

Boolean

구성 요소에 오류 출력이 있는지 여부를 나타냅니다.

ValidateExternalMetadata

Boolean

외부 열 메타데이터의 유효성이 검사되었는지 여부를 나타냅니다. 이 속성의 기본값은 True입니다.

Version

Integer

구성 요소의 버전입니다.

입력 속성

Integration Services 개체 모델에서 변환 및 대상은 입력을 포함합니다. 데이터 흐름 구성 요소의 입력은 IDTSInput100 인터페이스를 구현합니다.

다음 표에서는 데이터 흐름 구성 요소의 입력 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.

속성

데이터 형식

설명

Description

String

입력에 대한 설명입니다.

ErrorOrTruncationOperation

String

행을 처리할 때 발생할 수 있는 오류 또는 잘림 유형을 지정하는 선택적 문자열입니다.

ErrorRowDisposition

DTSRowDisposition

오류 처리를 지정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다.

HasSideEffects

Boolean

구성 요소가 다운스트림 구성 요소에 연결되어 있지 않은 경우 및 RunInOptimizedMode가 true일 경우 데이터 흐름의 실행 계획에서 구성 요소를 제거할 수 있는지 여부를 나타냅니다.

ID

Integer

입력을 고유하게 식별하는 값입니다.

IdentificationString

String

입력을 식별하는 문자열입니다.

IsSorted

Boolean

입력의 데이터가 정렬되었는지 여부를 나타냅니다.

Name

String

입력의 이름입니다.

SourceLocale

Integer

입력 데이터의 LCID(로캘 ID)입니다.

TruncationRowDisposition

DTSRowDisposition

행을 처리할 때 발생하는 잘림을 구성 요소가 처리하는 방법을 결정하는 값입니다. . 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다.

대상 및 일부 변환은 오류 출력을 지원하지 않으므로 이러한 구성 요소의 ErrorRowDispositionTruncationRowDisposition 속성은 읽기 전용입니다.

입력 열 속성

Integration Services 개체 모델에서 입력은 입력 열 모음을 포함합니다. 데이터 흐름 구성 요소의 입력 열은 IDTSInputColumn100 인터페이스를 구현합니다.

다음 표에서는 데이터 흐름 구성 요소의 입력 열 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.

속성

데이터 형식

설명

ComparisonFlags

Integer

문자 데이터 형식을 갖는 열의 비교를 지정하는 플래그 집합입니다. 자세한 내용은 문자열 데이터 비교를 참조하십시오.

Description

String

입력 열에 대해 설명합니다.

ErrorOrTruncationOperation

String

행을 처리할 때 발생할 수 있는 오류 또는 잘림 유형을 지정하는 선택적 문자열입니다.

ErrorRowDisposition

DTSRowDisposition

오류 처리를 지정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다.

ExternalMetadataColumnID

IDTSExternalMetadataColumn100

입력 열에 할당된 외부 메타데이터 열의 ID입니다.

ID

Integer

입력 열을 고유하게 식별하는 값입니다.

IdentificationString

String

입력 열을 식별하는 문자열입니다.

LineageID

Integer

업스트림 열의 ID입니다.

Name

String

입력 열의 이름입니다.

SortKeyPosition

Integer

열 정렬 여부, 정렬 순서 및 여러 열이 정렬되는 순서를 나타내는 값입니다. 값 0은 열이 정렬되어 있지 않음을 나타냅니다. 자세한 내용은 방법: 병합 및 병합 조인 변환을 위한 데이터 정렬을 참조하십시오.

TruncationRowDisposition

DTSRowDisposition

행을 처리할 때 발생하는 잘림을 구성 요소가 처리하는 방법을 결정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다.

UpstreamComponentName

String

업스트림 구성 요소의 이름입니다.

UsageType

DTSUsageType

입력 열이 구성 요소에서 사용되는 방식을 결정하는 값입니다.

입력 열은 "데이터 형식 속성"에 설명된 데이터 형식 속성도 포함합니다.

출력 속성

Integration Services 개체 모델에서 원본 및 변환은 출력을 포함합니다. 데이터 흐름 구성 요소의 출력은 IDTSOutput100 인터페이스를 구현합니다.

다음 표에서는 데이터 흐름 구성 요소의 출력 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.

속성

데이터 형식

설명

DeleteOutputOnPathDetached

Boolean

경로에서 출력이 분리될 경우 데이터 흐름 엔진이 출력을 삭제할지 여부를 결정하는 값입니다.

Description

String

출력에 대해 설명합니다.

ErrorOrTruncationOperation

String

행을 처리할 때 발생할 수 있는 오류 또는 잘림 유형을 지정하는 선택적 문자열입니다.

ErrorRowDisposition

DTSRowDisposition

오류 처리를 지정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다.

ExclusionGroup

Integer

함께 사용할 수 없는 출력 그룹을 식별하는 값입니다.

HasSideEffects

Boolean

구성 요소가 업스트림 구성 요소에 연결되어 있지 않은 경우 및 RunInOptimizedMode가 true일 경우 데이터 흐름의 실행 계획에서 구성 요소를 제거할 수 있는지 여부를 나타내는 값입니다.

ID

Integer

출력을 고유하게 식별하는 값입니다.

IdentificationString

String

출력을 식별하는 문자열입니다.

IsErrorOut

Boolean

출력이 오류 출력인지 여부를 나타냅니다.

IsSorted

Boolean

출력이 정렬되었는지 여부를 나타냅니다. 기본값은 False입니다.

중요 정보중요
IsSorted 속성의 값을 True로 설정해도 데이터가 정렬되지는 않습니다. 이 속성은 데이터가 이전에 정렬되었다는 정보를 다운스트림 구성 요소에 제공하기만 합니다. 자세한 내용은 방법: 병합 및 병합 조인 변환을 위한 데이터 정렬을 참조하십시오.

Name

String

출력의 이름입니다.

SynchronousInputID

Integer

출력과 동시에 수행되는 입력의 ID입니다.

TruncationRowDisposition

DTSRowDisposition

행을 처리할 때 발생하는 잘림을 구성 요소가 처리하는 방법을 결정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다.

출력 열 속성

Integration Services 개체 모델에서 출력은 출력 열 모음을 포함합니다. 데이터 흐름 구성 요소의 출력 열은 IDTSOutputColumn100 인터페이스를 구현합니다.

다음 표에서는 데이터 흐름 구성 요소의 출력 열 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.

속성

데이터 형식

설명

ComparisonFlags

Integer

문자 데이터 형식을 갖는 열의 비교를 지정하는 플래그 집합입니다. 자세한 내용은 문자열 데이터 비교를 참조하십시오.

Description

String

출력 열에 대해 설명합니다.

ErrorOrTruncationOperation

String

행을 처리할 때 발생할 수 있는 오류 또는 잘림 유형을 지정하는 선택적 문자열입니다.

ErrorRowDisposition

DTSRowDisposition

오류 처리를 지정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다. 기본값은 Fail component입니다.

ExternalMetadataColumnID

Integer

입력 열에 할당된 외부 메타데이터 열의 ID입니다.

ID

Integer

출력 열을 고유하게 식별하는 값입니다.

IdentificationString

String

출력 열을 식별하는 문자열입니다.

LineageID

Integer

출력 열의 ID입니다. 다운스트림 구성 요소는 이 값을 사용하여 열을 참조합니다.

Name

String

출력 열의 이름입니다.

SortKeyPosition

Integer

열 정렬 여부, 정렬 순서 및 여러 열이 정렬되는 순서를 나타내는 값입니다. 값 0은 열이 정렬되어 있지 않음을 나타냅니다. 자세한 내용은 방법: 병합 및 병합 조인 변환을 위한 데이터 정렬을 참조하십시오.

SpecialFlags

Integer

출력 열의 특수 플래그를 포함하는 값입니다.

TruncationRowDisposition

DTSRowDisposition

행을 처리할 때 발생하는 잘림을 구성 요소가 처리하는 방법을 결정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다. 기본값은 Fail component입니다.

출력 열은 데이터 형식 속성 집합도 포함합니다.

외부 메타데이터 열 속성

Integration Services 개체 모델에서 입력 및 출력은 외부 메타데이터 열 모음을 포함할 수 있습니다. 데이터 흐름 구성 요소의 외부 메타데이터 열은 IDTSExternalMetadataColumn100 인터페이스를 구현합니다.

다음 표에서는 데이터 흐름 구성 요소의 외부 메타데이터 열 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.

속성

데이터 형식

설명

Description

String

외부 열에 대해 설명합니다.

ID

Integer

열을 고유하게 식별하는 값입니다.

IdentificationString

String

열을 식별하는 문자열입니다.

Name

String

외부 열의 이름입니다.

외부 메타데이터 열은 데이터 형식 속성 집합도 포함합니다.

데이터 형식 속성

출력 열과 외부 메타데이터 열은 데이터 형식 속성 집합을 포함합니다. 열의 데이터 형식에 따라 읽기/쓰기 속성 또는 읽기 전용 속성이 될 수 있습니다.

다음 표에서는 출력 열 및 외부 메타데이터 열의 데이터 형식 속성에 대해 설명합니다.

속성

데이터 형식

설명

CodePage

Integer

유니코드가 아닌 문자열 데이터에 대한 코드 페이지를 지정합니다.

DataType

Integer(열거형)

열의 Integration Services 데이터 형식입니다. 자세한 내용은 Integration Services 데이터 형식을 참조하십시오.

Length

Integer

열의 길이(문자 수)입니다.

Precision

Integer

숫자 열의 전체 자릿수입니다.

Scale

Integer

숫자 열의 소수 자릿수입니다.