Общие свойства
Объекты потока данных в объектной модели служб MicrosoftSQL ServerIntegration 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 |
Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failure и Redirect row. |
|
HasSideEffects |
Логическое выражение |
Показывает, можно ли удалять компонент из плана выполнения потока данных, если он не присоединен к нисходящему компоненту, а свойство RunInOptimizedMode установлено в true. |
ID |
Целое число |
Значение, уникально определяющее вход. |
IdentificationString |
String |
Строка, определяющая вход. |
IsSorted |
Логическое выражение |
Указывает, сортируются ли данные на входе. |
Name |
String |
Имя входа. |
SourceLocale |
Целое число |
Код языка данных входа. |
TruncationRowDisposition |
Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failure и Redirect row. |
Назначения и некоторые преобразования не поддерживают вывод ошибок на выходе, а свойства ErrorRowDisposition и TruncationRowDisposition этих компонентов доступны только для чтения.
Свойства входного столбца
В объектной модели служб Integration Services вход содержит коллекцию входных столбцов. Входной столбец компонента потока данных реализует интерфейс IDTSInputColumn100.
В следующей таблице показаны свойства входных столбцов компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
Свойство |
Тип данных |
Описание |
|---|---|---|
ComparisonFlags |
Целое число |
Набор флагов, задающий правила сравнения столбцов, имеющих символьный тип данных. Дополнительные сведения см. в разделе Сравнение строковых данных. |
Description |
String |
Описывает входной столбец. |
ErrorOrTruncationOperation |
String |
Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки. |
ErrorRowDisposition |
Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failure и Redirect row. |
|
ExternalMetadataColumnID |
Идентификатор столбца внешних метаданных, присвоенный входному столбцу. |
|
ID |
Целое число |
Значение, уникально определяющее входной столбец. |
IdentificationString |
String |
Строка, определяющая входной столбец. |
LineageID |
Целое число |
Идентификатор восходящего столбца. |
Name |
String |
Имя входного столбца. |
SortKeyPosition |
Целое число |
Значение, которое указывает, является ли столбец отсортированным, порядок его сортировки и последовательность, в которой отсортированы несколько столбцов. Значение 0 означает, что столбец не отсортирован. Дополнительные сведения см. в разделе Как отсортировать данные для преобразований «Слияние» и «Соединение слиянием». |
TruncationRowDisposition |
Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failure и Redirect row. |
|
UpstreamComponentName |
String |
Имя компонента восходящего потока данных. |
UsageType |
Значение, определяющее, как входной столбец используется компонентом. |
Входной столбец также использует свойства типа данных, описанные в разделе "Свойства типа данных".
Свойства выхода
В объектной модели служб Integration Services преобразования и назначения имеют выходы. Выход компонента потока данных реализует интерфейс IDTSOutput100.
В следующей таблице показаны свойства выходов компонентов в потоке данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
Свойство |
Тип данных |
Описание |
|---|---|---|
DeleteOutputOnPathDetached |
Логическое выражение |
Определяет, удаляет ли подсистема обработки потока данных выход при отключении от пути. |
Description |
String |
Описывает выход. |
ErrorOrTruncationOperation |
String |
Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки. |
ErrorRowDisposition |
Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failure и Redirect row. |
|
ExclusionGroup |
Целое число |
Значение, определяющее группу взаимоисключающих выводов. |
HasSideEffects |
Логическое выражение |
Указывает, можно ли удалять компонент из плана выполнения потока данных, если он не присоединен к компоненту восходящего потока данных, а свойство RunInOptimizedMode установлено в true. |
ID |
Целое число |
Значение, уникально определяющее выход. |
IdentificationString |
String |
Строка, определяющая выход. |
IsErrorOut |
Логическое выражение |
Указывает, используется ли выход для вывода ошибок. |
IsSorted |
Логическое выражение |
Указывает, отсортирован ли выход. По умолчанию устанавливается значение False. .gif "Важное примечание") Важно!
Установка свойства IsSorted в значение True не приводит к сортировке данных. Это свойство только подсказывает компонентам нисходящего потока, что данные раньше были отсортированы. Дополнительные сведения см. в разделе Как отсортировать данные для преобразований «Слияние» и «Соединение слиянием».
|
Name |
String |
Имя выхода. |
SynchronousInputID |
Целое число |
Идентификатор синхронного с выходом входа. |
TruncationRowDisposition |
Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failure и Redirect row. |
Свойства выходного столбца
В объектной модели служб Integration Services выход содержит коллекцию выходных столбцов. Выходной столбец компонента потока данных реализует интерфейс IDTSOutputColumn100.
В следующей таблице показаны свойства выходных столбцов компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
Свойство |
Тип данных |
Описание |
|---|---|---|
ComparisonFlags |
Целое число |
Набор флагов, задающий правила сравнения столбцов, имеющих символьный тип данных. Дополнительные сведения см. в разделе Сравнение строковых данных. |
Description |
String |
Описывает выходной столбец. |
ErrorOrTruncationOperation |
String |
Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки. |
ErrorRowDisposition |
Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failure и Redirect row. Значение по умолчанию: Fail component. |
|
ExternalMetadataColumnID |
Целое число |
Идентификатор столбца внешних метаданных, присвоенный входному столбцу. |
ID |
Целое число |
Значение, уникально определяющее выходной столбец. |
IdentificationString |
String |
Строка, определяющая выходной столбец. |
LineageID |
Целое число |
Идентификатор выходного столбца. Компоненты нисходящего потока данных ссылаются на столбец при помощи этого значения. |
Name |
String |
Имя выходного столбца. |
SortKeyPosition |
Целое число |
Значение указывает, является ли столбец отсортированным, порядок его сортировки и последовательность, в которой отсортированы несколько столбцов. Значение 0 указывает на то, что столбец не отсортирован. Дополнительные сведения см. в разделе Как отсортировать данные для преобразований «Слияние» и «Соединение слиянием». |
SpecialFlags |
Целое число |
Значение, содержащее специальные флаги выходного столбца. |
TruncationRowDisposition |
Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — 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 |
Целое число |
Масштаб числового столбца. |