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


Общие свойства

Объекты потока данных в объектной модели служб Microsoft SQL Server Integration Services имеют общие свойства и пользовательские свойства на уровне компонента, входы и выходы, а также входные и выходные столбцы. Многие свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.

Этот раздел содержит список и описание пользовательских свойств объектов потоков данных.

  • Компоненты

  • Входы

  • Входные столбцы

  • Выходы

  • Выходные столбцы

Свойства компонента

В объектной модели служб Integration Services компонент потока данных реализует интерфейс IDTSComponentMetaData100.

В следующей таблице показаны свойства компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.

Свойство

Тип данных

Описание

ComponentClassID

String

Идентификатор CLSID компонента.

ContactInfo

String

Контактные данные разработчика компонента.

Description

String

Описание компонента потока данных. Значением по умолчанию для этого свойства является имя компонента потока данных.

ID

Целое число

Значение, являющееся уникальным идентификатором данного экземпляра компонента.

IdentificationString

String

Идентифицирует компонент.

IsDefaultLocale

Логическое выражение

Указывает, используется ли компонентом языковой стандарт задачи потока данных, которой он принадлежит.

LocaleID

Целое число

Языковой стандарт, используемый компонентом потока данных при запуске пакета. Все языковые стандарты Windows доступны для использования компонентами потока данных.

Name

String

Имя компонента потока данных.

PipelineVersion

Целое число

Версия задачи потока данных, в которой должен выполняться компонент.

UsesDispositions

Логическое выражение

Указывает, имеет ли компонент вывод ошибок на выходе.

ValidateExternalMetadata

Логическое выражение

Указывает, проверены ли метаданные внешних столбцов. По умолчанию для этого свойства устанавливается значение True.

Version

Целое число

Версия компонента.

Свойства входа

В объектной модели служб Integration Services преобразования и назначения имеют входы. Вход компонента потока данных реализует интерфейс IDTSInput100.

В следующей таблице показаны свойства входов компонентов в потоке данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.

Свойство

Тип данных

Описание

Description

String

Описание входа.

ErrorOrTruncationOperation

String

Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки.

ErrorRowDisposition

DTSRowDisposition

Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failure и Redirect row.

HasSideEffects

Логическое выражение

Показывает, можно ли удалять компонент из плана выполнения потока данных, если он не присоединен к нисходящему компоненту, а свойство RunInOptimizedMode установлено в true.

ID

Целое число

Значение, уникально определяющее вход.

IdentificationString

String

Строка, определяющая вход.

IsSorted

Логическое выражение

Указывает, сортируются ли данные на входе.

Name

String

Имя входа.

SourceLocale

Целое число

Код языка данных входа.

TruncationRowDisposition

DTSRowDisposition

Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failure и Redirect row.

Назначения и некоторые преобразования не поддерживают вывод ошибок на выходе, а свойства ErrorRowDisposition и TruncationRowDisposition этих компонентов доступны только для чтения.

Свойства входного столбца

В объектной модели служб Integration Services вход содержит коллекцию входных столбцов. Входной столбец компонента потока данных реализует интерфейс IDTSInputColumn100.

В следующей таблице показаны свойства входных столбцов компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.

Свойство

Тип данных

Описание

ComparisonFlags

Целое число

Набор флагов, задающий правила сравнения столбцов, имеющих символьный тип данных. Дополнительные сведения см. в разделе Сравнение строковых данных.

Description

String

Описывает входной столбец.

ErrorOrTruncationOperation

String

Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки.

ErrorRowDisposition

DTSRowDisposition

Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failure и Redirect row.

ExternalMetadataColumnID

IDTSExternalMetadataColumn100

Идентификатор столбца внешних метаданных, присвоенный входному столбцу.

ID

Целое число

Значение, уникально определяющее входной столбец.

IdentificationString

String

Строка, определяющая входной столбец.

LineageID

Целое число

Идентификатор восходящего столбца.

Name

String

Имя входного столбца.

SortKeyPosition

Целое число

Значение, которое указывает, является ли столбец отсортированным, порядок его сортировки и последовательность, в которой отсортированы несколько столбцов. Значение 0 означает, что столбец не отсортирован. Дополнительные сведения см. в разделе Как отсортировать данные для преобразований «Слияние» и «Соединение слиянием».

TruncationRowDisposition

DTSRowDisposition

Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failure и Redirect row.

UpstreamComponentName

String

Имя компонента восходящего потока данных.

UsageType

DTSUsageType

Значение, определяющее, как входной столбец используется компонентом.

Входной столбец также использует свойства типа данных, описанные в разделе "Свойства типа данных".

Свойства выхода

В объектной модели служб Integration Services преобразования и назначения имеют выходы. Выход компонента потока данных реализует интерфейс IDTSOutput100.

В следующей таблице показаны свойства выходов компонентов в потоке данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.

Свойство

Тип данных

Описание

DeleteOutputOnPathDetached

Логическое выражение

Определяет, удаляет ли подсистема обработки потока данных выход при отключении от пути.

Description

String

Описывает выход.

ErrorOrTruncationOperation

String

Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки.

ErrorRowDisposition

DTSRowDisposition

Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failure и Redirect row.

ExclusionGroup

Целое число

Значение, определяющее группу взаимоисключающих выводов.

HasSideEffects

Логическое выражение

Указывает, можно ли удалять компонент из плана выполнения потока данных, если он не присоединен к компоненту восходящего потока данных, а свойство RunInOptimizedMode установлено в true.

ID

Целое число

Значение, уникально определяющее выход.

IdentificationString

String

Строка, определяющая выход.

IsErrorOut

Логическое выражение

Указывает, используется ли выход для вывода ошибок.

IsSorted

Логическое выражение

Указывает, отсортирован ли выход. По умолчанию устанавливается значение False.

Важное примечаниеВажно!
Установка свойства IsSorted в значение True не приводит к сортировке данных. Это свойство только подсказывает компонентам нисходящего потока, что данные раньше были отсортированы. Дополнительные сведения см. в разделе Как отсортировать данные для преобразований «Слияние» и «Соединение слиянием».

Name

String

Имя выхода.

SynchronousInputID

Целое число

Идентификатор синхронного с выходом входа.

TruncationRowDisposition

DTSRowDisposition

Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failure и Redirect row.

Свойства выходного столбца

В объектной модели служб Integration Services выход содержит коллекцию выходных столбцов. Выходной столбец компонента потока данных реализует интерфейс IDTSOutputColumn100.

В следующей таблице показаны свойства выходных столбцов компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.

Свойство

Тип данных

Описание

ComparisonFlags

Целое число

Набор флагов, задающий правила сравнения столбцов, имеющих символьный тип данных. Дополнительные сведения см. в разделе Сравнение строковых данных.

Description

String

Описывает выходной столбец.

ErrorOrTruncationOperation

String

Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки.

ErrorRowDisposition

DTSRowDisposition

Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failure и Redirect row. Значение по умолчанию: Fail component.

ExternalMetadataColumnID

Целое число

Идентификатор столбца внешних метаданных, присвоенный входному столбцу.

ID

Целое число

Значение, уникально определяющее выходной столбец.

IdentificationString

String

Строка, определяющая выходной столбец.

LineageID

Целое число

Идентификатор выходного столбца. Компоненты нисходящего потока данных ссылаются на столбец при помощи этого значения.

Name

String

Имя выходного столбца.

SortKeyPosition

Целое число

Значение указывает, является ли столбец отсортированным, порядок его сортировки и последовательность, в которой отсортированы несколько столбцов. Значение 0 указывает на то, что столбец не отсортирован. Дополнительные сведения см. в разделе Как отсортировать данные для преобразований «Слияние» и «Соединение слиянием».

SpecialFlags

Целое число

Значение, содержащее специальные флаги выходного столбца.

TruncationRowDisposition

DTSRowDisposition

Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failure и Redirect row. Значение по умолчанию: Сбой компонента.

Выходные столбцы также содержат набор свойств типа данных.

Свойства столбца внешних метаданных

В объектной модели служб Integration Services выходы и входы могут содержать коллекцию столбцов внешних метаданных. Столбец внешних метаданных компонента потока данных реализует интерфейс IDTSExternalMetadataColumn100.

В следующей таблице показаны свойства столбцов внешних метаданных компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.

Свойство

Тип данных

Описание

Description

String

Описывает внешний столбец.

ID

Целое число

Значение, уникально определяющее столбец.

IdentificationString

String

Строка, определяющая столбец.

Name

String

Имя внешнего столбца.

Столбцы внешних метаданных также содержат набор свойств типа данных.

Свойства типа данных

Выходные столбцы и столбцы внешних метаданных также содержат набор свойств типа данных. В зависимости от типа данных столбца, свойства могут быть доступны либо для чтения и для записи, либо только для чтения.

В следующей таблице описываются свойства типов данных внешних столбцов и столбцов внешних метаданных.

Свойство

Тип данных

Описание

CodePage

Целое число

Определяет кодовую страницу данных строки, записанных не в Юникоде.

DataType

Integer (перечисление)

Тип данных столбца служб Integration Services. Дополнительные сведения см. в разделе Типы данных служб Integration Services.

Length

Целое число

Длина столбца, измеренная в символах.

Precision

Целое число

Точность числового столбца.

Scale

Целое число

Масштаб числового столбца.