공용 속성
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 |
오류 처리를 지정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다. |
|
HasSideEffects |
Boolean |
구성 요소가 다운스트림 구성 요소에 연결되어 있지 않은 경우 및 RunInOptimizedMode가 true일 경우 데이터 흐름의 실행 계획에서 구성 요소를 제거할 수 있는지 여부를 나타냅니다. |
ID |
Integer |
입력을 고유하게 식별하는 값입니다. |
IdentificationString |
String |
입력을 식별하는 문자열입니다. |
IsSorted |
Boolean |
입력의 데이터가 정렬되었는지 여부를 나타냅니다. |
Name |
String |
입력의 이름입니다. |
SourceLocale |
Integer |
입력 데이터의 LCID(로캘 ID)입니다. |
TruncationRowDisposition |
행을 처리할 때 발생하는 잘림을 구성 요소가 처리하는 방법을 결정하는 값입니다. . 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다. |
대상 및 일부 변환은 오류 출력을 지원하지 않으므로 이러한 구성 요소의 ErrorRowDisposition 및 TruncationRowDisposition 속성은 읽기 전용입니다.
입력 열 속성
Integration Services 개체 모델에서 입력은 입력 열 모음을 포함합니다. 데이터 흐름 구성 요소의 입력 열은 IDTSInputColumn100 인터페이스를 구현합니다.
다음 표에서는 데이터 흐름 구성 요소의 입력 열 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.
속성 |
데이터 형식 |
설명 |
---|---|---|
ComparisonFlags |
Integer |
문자 데이터 형식을 갖는 열의 비교를 지정하는 플래그 집합입니다. 자세한 내용은 문자열 데이터 비교를 참조하십시오. |
Description |
String |
입력 열에 대해 설명합니다. |
ErrorOrTruncationOperation |
String |
행을 처리할 때 발생할 수 있는 오류 또는 잘림 유형을 지정하는 선택적 문자열입니다. |
ErrorRowDisposition |
오류 처리를 지정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다. |
|
ExternalMetadataColumnID |
입력 열에 할당된 외부 메타데이터 열의 ID입니다. |
|
ID |
Integer |
입력 열을 고유하게 식별하는 값입니다. |
IdentificationString |
String |
입력 열을 식별하는 문자열입니다. |
LineageID |
Integer |
업스트림 열의 ID입니다. |
Name |
String |
입력 열의 이름입니다. |
SortKeyPosition |
Integer |
열 정렬 여부, 정렬 순서 및 여러 열이 정렬되는 순서를 나타내는 값입니다. 값 0은 열이 정렬되어 있지 않음을 나타냅니다. 자세한 내용은 방법: 병합 및 병합 조인 변환을 위한 데이터 정렬을 참조하십시오. |
TruncationRowDisposition |
행을 처리할 때 발생하는 잘림을 구성 요소가 처리하는 방법을 결정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다. |
|
UpstreamComponentName |
String |
업스트림 구성 요소의 이름입니다. |
UsageType |
입력 열이 구성 요소에서 사용되는 방식을 결정하는 값입니다. |
입력 열은 "데이터 형식 속성"에 설명된 데이터 형식 속성도 포함합니다.
출력 속성
Integration Services 개체 모델에서 원본 및 변환은 출력을 포함합니다. 데이터 흐름 구성 요소의 출력은 IDTSOutput100 인터페이스를 구현합니다.
다음 표에서는 데이터 흐름 구성 요소의 출력 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.
속성 |
데이터 형식 |
설명 |
---|---|---|
DeleteOutputOnPathDetached |
Boolean |
경로에서 출력이 분리될 경우 데이터 흐름 엔진이 출력을 삭제할지 여부를 결정하는 값입니다. |
Description |
String |
출력에 대해 설명합니다. |
ErrorOrTruncationOperation |
String |
행을 처리할 때 발생할 수 있는 오류 또는 잘림 유형을 지정하는 선택적 문자열입니다. |
ErrorRowDisposition |
오류 처리를 지정하는 값입니다. 가능한 값은 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 |
행을 처리할 때 발생하는 잘림을 구성 요소가 처리하는 방법을 결정하는 값입니다. 가능한 값은 Fail component, Ignore failure 및 Redirect row입니다. |
출력 열 속성
Integration Services 개체 모델에서 출력은 출력 열 모음을 포함합니다. 데이터 흐름 구성 요소의 출력 열은 IDTSOutputColumn100 인터페이스를 구현합니다.
다음 표에서는 데이터 흐름 구성 요소의 출력 열 속성에 대해 설명합니다. 일부 속성에는 데이터 흐름 엔진이 런타임에 할당한 읽기 전용 값이 있습니다.
속성 |
데이터 형식 |
설명 |
---|---|---|
ComparisonFlags |
Integer |
문자 데이터 형식을 갖는 열의 비교를 지정하는 플래그 집합입니다. 자세한 내용은 문자열 데이터 비교를 참조하십시오. |
Description |
String |
출력 열에 대해 설명합니다. |
ErrorOrTruncationOperation |
String |
행을 처리할 때 발생할 수 있는 오류 또는 잘림 유형을 지정하는 선택적 문자열입니다. |
ErrorRowDisposition |
오류 처리를 지정하는 값입니다. 가능한 값은 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 |
행을 처리할 때 발생하는 잘림을 구성 요소가 처리하는 방법을 결정하는 값입니다. 가능한 값은 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 |
숫자 열의 소수 자릿수입니다. |