Установление свойств компонента потока данных
Область применения: 
среда выполнения интеграции SSIS SQL Server в Фабрика данных Azure
Чтобы задать свойства компонентов потока данных, которые включают источники, целевые объекты и преобразования, можно использовать следующие компоненты.
Редакторы компонентов, предоставляемые службами Integration Services. В редакторы компонентов включены только пользовательские свойства каждого компонента потока данных.
В окне " Свойства " перечислены характерные свойства каждого компонента, а также общие свойства для всех элементов потока данных.
Диалоговое окно Расширенный редактор предоставляет доступ к пользовательским свойствам каждого компонента. Диалоговое окно Расширенный редактор также предоставляет доступ к общим свойствам всех компонентов потока данных — к свойствам входов, выходов, выводов ошибок на выходе, а также к свойствам столбцов и внешних столбцов.
Задание свойств для компонента потока данных с помощью редактора компонентов
В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.
Чтобы открыть пакет, дважды щелкните его в обозревателе решений.
Выберите вкладку Поток управления и дважды щелкните задачу потока данных, содержащую компонент, который необходимо просмотреть и изменить.
Дважды щелкните компонент потока данных.
В редакторе компонента просмотрите или измените значения свойств, затем закройте редактор.
Чтобы сохранить измененный пакет, в меню Файл выберите команду Сохранить выбранные элементы.
Задание свойств для компонента потока данных в окне "Свойства"
В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.
Чтобы открыть пакет, дважды щелкните его в обозревателе решений.
Выберите вкладку Поток управления и дважды щелкните задачу потока данных, содержащую компонент, который необходимо просмотреть и изменить.
Щелкните правой кнопкой мыши компонент потока данных и выберите Свойства.
Просмотрите или измените значения свойств, затем закройте окно Свойства .
Примечание.
Многие свойства доступны только для чтения, и их нельзя изменить.
Чтобы сохранить измененный пакет, в меню Файл выберите команду Сохранить выбранные элементы.
Задание свойств для компонента потока данных с помощью Расширенного редактора
В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.
Чтобы открыть пакет, дважды щелкните его в обозревателе решений.
Выберите вкладку Поток управления и дважды щелкните задачу потока данных, содержащую компонент, который необходимо просмотреть или изменить.
В конструкторе потока данных щелкните компонент потока данных правой кнопкой и выберите Показать расширенный редактор.
Примечание.
В SQL Server компоненты потока данных, поддерживающие несколько входных данных, не могут использовать Расширенный редактор.
В диалоговом окне Расширенный редактор выполните одно из следующих действий.
Перейдите на вкладку Диспетчеры соединений , чтобы просмотреть и определить соединение, которое использует компонент.
Примечание.
На вкладке Диспетчеры соединений доступны только компоненты потоков данных, которые используют диспетчеры соединений для подключения к источникам данных, таким как файлы или базы данных.
Перейдите на вкладку Свойства компонента , чтобы просмотреть и изменить свойства уровня компонента.
Перейдите на вкладку Сопоставления столбцов , чтобы просмотреть сопоставления между внешними столбцами и доступными выходами.
Примечание.
Вкладка Сопоставление столбцов доступна только для просмотра и редактирования источников и назначений.
Щелкните вкладку Входные столбцы для просмотра списка доступных входных столбцов и обновления имен выходных столбцов.
Примечание.
Вкладка «Входные столбцы» доступна только при работе с преобразованиями и назначениями. Дополнительные сведения см. в статье Integration Services Transformations.
Выберите вкладку Свойства входов и выходов , чтобы просмотреть и изменить свойства входов, выходов, выводов ошибок на выходе, а также свойств столбцов, которые они содержат.
Примечание.
Источники не имеют входов. Назначения не имеют выходов, за исключением возможного выхода ошибок.
Просмотрите или измените значения свойств.
Щелкните OK.
Чтобы сохранить измененный пакет, в меню Файл выберите команду Сохранить выбранные элементы.
Общие свойства компонентов потока данных
Объекты потока данных в объектной модели Служб Microsoft SQL Server Integration Services имеют общие свойства и настраиваемые свойства на уровне компонента, входных и выходных данных, а также входных и выходных столбцов. Многие свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
Этот раздел содержит список и описание пользовательских свойств объектов потоков данных.
Свойства компонента
В объектной модели Служб Integration Services компонент в потоке данных реализует IDTSComponentMetaData100 интерфейс.
В следующей таблице показаны свойства компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
| Свойство | Тип данных | Description |
|---|---|---|
| ComponentClassID | Строка | Идентификатор CLSID компонента. |
| ContactInfo | Строка | Контактные данные разработчика компонента. |
| Description | Строка | Описание компонента потока данных. Значением по умолчанию для этого свойства является имя компонента потока данных. |
| Код | Целое | Значение, являющееся уникальным идентификатором данного экземпляра компонента. |
| IdentificationString | Строка | Идентифицирует компонент. |
| IsDefaultLocale | Логический | Указывает, используется ли компонентом локаль задачи потока данных, которой она принадлежит. |
| LocaleID | Целое | Локаль, используемая компонентом потока данных при запуске пакета. Все локали Windows доступны для использования компонентами потока данных. |
| Имя. | Строка | Имя компонента потока данных. |
| PipelineVersion | Целое | Версия задачи потока данных, в которой должен выполняться компонент. |
| UsesDispositions | Логический | Указывает, имеет ли компонент вывод ошибок на выходе. |
| ValidateExternalMetadata | Логический | Указывает, проверены ли метаданные внешних столбцов. Значение по умолчанию этого свойства равно True. |
| Версия | Целое | Версия компонента. |
Входные свойства
В объектной модели служб Integration Services преобразования и назначения имеют входные данные. Вход компонента потока данных реализует интерфейс IDTSInput100.
В следующей таблице показаны свойства входов компонентов в потоке данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
| Свойство | Тип данных | Description |
|---|---|---|
| Description | Строка | Описание входа. |
| ErrorOrTruncationOperation | Строка | Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки. |
| ErrorRowDisposition | DTSRowDisposition | Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failureи Redirect row. |
| HasSideEffects | Логический | Показывает, можно ли удалять компонент из плана выполнения потока данных, если он не присоединен к нисходящему компоненту, а свойство RunInOptimizedMode установлено в true. |
| Код | Целое | Значение, уникально определяющее вход. |
| IdentificationString | Строка | Строка, определяющая вход. |
| IsSorted | Логический | Указывает, сортируются ли данные на входе. |
| Имя. | Строка | Имя входа. |
| SourceLocale | Целое | Идентификатор локали данных входа. |
| TruncationRowDisposition | DTSRowDisposition | Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. . Допустимые значения — Fail component, Ignore failureи Redirect row. |
Назначения и некоторые преобразования не поддерживают вывод ошибок на выходе, а свойства ErrorRowDisposition и TruncationRowDisposition этих компонентов доступны только для чтения.
Свойства входного столбца
В объектной модели Служб Integration Services входные данные содержат коллекцию входных столбцов. Входной столбец компонента потока данных реализует интерфейс IDTSInputColumn100.
В следующей таблице показаны свойства входных столбцов компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
| Свойство | Тип данных | Description |
|---|---|---|
| ComparisonFlags | Целое | Набор флагов, задающий правила сравнения столбцов, имеющих символьный тип данных. Дополнительные сведения см. в статье Comparing String Data. |
| Description | Строка | Описывает входной столбец. |
| ErrorOrTruncationOperation | Строка | Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки. |
| ErrorRowDisposition | DTSRowDisposition | Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failureи Redirect row. |
| ExternalMetadataColumnID | IDTSExternalMetadataColumn100 | Идентификатор столбца внешних метаданных, присвоенный входному столбцу. |
| Код | Целое | Значение, уникально определяющее входной столбец. |
| IdentificationString | Строка | Строка, определяющая входной столбец. |
| LineageID | Целое | Идентификатор восходящего столбца. |
| LineageIdentificationString | Строка | Строка идентификации, включающая имя восходящего столбца. |
| Имя. | Строка | Имя входного столбца. |
| SortKeyPosition | Целое | Значение указывает, является ли столбец отсортированным, порядок его сортировки и последовательность, в которой отсортированы несколько столбцов. Значение 0 указывает на то, что столбец не отсортирован. Дополнительные сведения см. в разделе Сортировка данных для преобразований "Слияние" и "Соединение слиянием". |
| TruncationRowDisposition | DTSRowDisposition | Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failureи Redirect row. |
| UpstreamComponentName | Строка | Имя компонента восходящего потока данных. |
| UsageType | DTSUsageType | Значение, определяющее, как входной столбец используется компонентом. |
Входной столбец также использует свойства типа данных, описанные в разделе "Свойства типа данных".
Выходные свойства
В объектной модели служб Integration Services источники и преобразования имеют выходные данные. Выход компонента потока данных реализует интерфейс IDTSOutput100.
В следующей таблице показаны свойства выходов компонентов в потоке данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
| Свойство | Тип данных | Description |
|---|---|---|
| DeleteOutputOnPathDetached | Логический | Определяет, удаляет ли подсистема обработки потока данных выход при отключении от пути. |
| Description | Строка | Описывает выход. |
| ErrorOrTruncationOperation | Строка | Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки. |
| ErrorRowDisposition | DTSRowDisposition | Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failureи Redirect row. |
| ExclusionGroup | Целое | Значение, определяющее группу взаимоисключающих выводов. |
| HasSideEffects | Логический | Указывает, можно ли удалять компонент из плана выполнения потока данных, если он не присоединен к компоненту восходящего потока данных, а свойство RunInOptimizedMode установлено в true. |
| Код | Целое | Значение, уникально определяющее выход. |
| IdentificationString | Строка | Строка, определяющая выход. |
| IsErrorOut | Логический | Указывает, используется ли выход для вывода ошибок. |
| IsSorted | Логический | Указывает, отсортирован ли выход. Значение по умолчанию равно False. ** Важно. ** Установка свойства IsSorted в значение 8True не приводит к сортировке данных. Это свойство только указывает компонентам нисходящего потока, что данные раньше были отсортированы. Дополнительные сведения см. в разделе Сортировка данных для преобразований "Слияние" и "Соединение слиянием". |
| Имя. | Строка | Имя выхода. |
| SynchronousInputID | Целое | Идентификатор синхронного с выходом входа. |
| TruncationRowDisposition | DTSRowDisposition | Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failureи Redirect row. |
Свойства выходного столбца
В объектной модели Служб Integration Services выходные данные содержат коллекцию выходных столбцов. Выходной столбец компонента потока данных реализует интерфейс IDTSOutputColumn100.
В следующей таблице показаны свойства выходных столбцов компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
| Свойство | Тип данных | Description |
|---|---|---|
| ComparisonFlags | Целое | Набор флагов, задающий правила сравнения столбцов, имеющих символьный тип данных. Дополнительные сведения см. в статье Comparing String Data. |
| Description | Строка | Описывает выходной столбец. |
| ErrorOrTruncationOperation | Строка | Дополнительная строка, указывающая типы ошибок или типы усечения, которые могут происходить при обработке строки. |
| ErrorRowDisposition | DTSRowDisposition | Значение, указывающее порядок обработки ошибок. Допустимые значения — Fail component, Ignore failureи Redirect row. Значение по умолчанию: Сбой компонента. |
| ExternalMetadataColumnID | Целое | Идентификатор столбца внешних метаданных, присвоенный входному столбцу. |
| Код | Целое | Значение, уникально определяющее выходной столбец. |
| IdentificationString | Строка | Строка, определяющая выходной столбец. |
| LineageID | Целое | Идентификатор выходного столбца. Компоненты нисходящего потока данных ссылаются на столбец при помощи этого значения. |
| LineageIdentificationString | Строка | Строка идентификации, включающая имя столбца. |
| Имя. | Строка | Имя выходного столбца. |
| SortKeyPosition | Целое | Значение указывает, является ли столбец отсортированным, порядок его сортировки и последовательность, в которой отсортированы несколько столбцов. Значение 0 указывает на то, что столбец не отсортирован. Дополнительные сведения см. в разделе Сортировка данных для преобразований "Слияние" и "Соединение слиянием". |
| SpecialFlags | Целое | Значение, содержащее специальные флаги выходного столбца. |
| TruncationRowDisposition | DTSRowDisposition | Значение, определяющее, как компонент обрабатывает усечения, происходящие при обработке строк. Допустимые значения — Fail component, Ignore failureи Redirect row. Значение по умолчанию: Сбой компонента. |
Выходные столбцы также содержат набор свойств типа данных.
Свойства столбца внешних метаданных
В объектной модели Служб Integration Services входные и выходные данные могут содержать коллекцию внешних столбцов метаданных. Столбец внешних метаданных компонента потока данных реализует интерфейс IDTSExternalMetadataColumn100.
В следующей таблице показаны свойства столбцов внешних метаданных компонентов потока данных. Некоторые свойства имеют значения, доступные только для чтения и присваиваемые подсистемой обработки потока данных на этапе выполнения.
| Свойство | Тип данных | Description |
|---|---|---|
| Description | Строка | Описывает внешний столбец. |
| Код | Целое | Значение, уникально определяющее столбец. |
| IdentificationString | Строка | Строка, определяющая столбец. |
| Имя. | Строка | Имя внешнего столбца. |
Столбцы внешних метаданных также содержат набор свойств типа данных.
Свойства типа данных
Выходные столбцы и столбцы внешних метаданных также содержат набор свойств типа данных. В зависимости от типа данных столбца, свойства могут быть доступны либо для чтения и для записи, либо только для чтения.
В следующей таблице описываются свойства типов данных внешних столбцов и столбцов внешних метаданных.
| Свойство | Тип данных | Description |
|---|---|---|
| CodePage | Целое | Определяет кодовую страницу данных строки, записанных не в Юникоде. |
| Тип данных | Integer (перечисление) | Тип данных служб Integration Services столбца. Дополнительные сведения см. в разделе Integration Services Data Types. |
| Length | Целое | Длина столбца, измеренная в символах. |
| Точность | Целое | Точность числового столбца. |
| Масштабировать | Целое | Масштаб числового столбца. |
Пользовательские свойства компонентов потока данных
Сведения о пользовательских свойствах см. в следующих разделах:
Пользовательские свойства назначения «Обучение модели интеллектуального анализа данных»
Настраиваемые свойства OLE DB OLE DB
Пользовательские свойства назначения «SQL Server Compact Edition»
Использование выражения в компоненте потока данных
Ниже описана процедура добавления выражения в преобразование «Условное разбиение» или «Производный столбец». Преобразование «Условное разбиение» с помощью выражений определяет условия, которые направляют строки данных в выход преобразования, а преобразование «Производный столбец» с помощью выражений определяет значения, присваиваемые столбцам.
Чтобы реализовать выражение в преобразовании, необходимо, чтобы в пакете уже была хотя бы одна задача потока данных и один источник.
В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.
Чтобы открыть пакет, дважды щелкните его в обозревателе решений.
В конструкторе служб SSIS щелкните вкладку "Поток управления" и выберите задачу Поток данных, содержащую поток данных, в котором требуется реализовать выражение.
Перейдите на вкладку Поток данных и перетащите преобразование «Условное разбиение» или «Производный столбец» из окна Область элементов в область конструктора.
Перетащите зеленый соединитель из источника или преобразования в преобразование «Условное разбиение» или «Производный столбец».
Дважды щелкните преобразование, чтобы открыть его диалоговое окно.
В левой панели разверните узел Переменные для отображения системных и пользовательских переменных, затем разверните узел Столбцы . Отобразятся входные столбцы преобразования.
В правой панели разверните узлы Математические функции, Строковые функции, Функции даты-времени, Функции NULL, Приведения типови Операторы для доступа к функциям, операторам приведения и операторам, предоставляемым грамматикой выражения.
В зависимости от вида преобразования выполните одно из следующих действий для создания выражения.
В диалоговом окне Редактор преобразования «Условное разбиение» перетащите переменные, столбцы, функции, операторы и приведения в столбец Условие . Также можно ввести выражение непосредственно в столбец Условие .
В диалоговом окне Редактор преобразования «Производный столбец» перетащите переменные, столбцы, функции, операторы и приведения в столбец Выражение . Также можно ввести выражение непосредственно в столбец Выражение .
Примечание.
При переключении фокуса со столбца Условие или Выражение текст выражения может быть выделен, что указывает на ошибку в синтаксисе выражения.
Нажмите кнопку ОК , чтобы закрыть диалоговое окно.
Примечание.
Если выражение является недопустимым, появится предупреждение с описанием синтаксических ошибок данного выражения.
Свойства потока данных, которые можно задать с помощью выражения
Значения определенных свойств объектов потока данных можно указать с помощью выражений свойств, доступных в контейнере задачи потока данных.
Дополнительные сведения о выражениях свойств см. в разделе Использование выражений свойств в пакетах.
Выражения свойств можно использовать для настройки конфигурации каждого развернутого экземпляра пакета. Выражения свойств также можно использовать, чтобы задать ограничения времени выполнения пакета с помощью параметра /set программы командной строки dtexec . Например, можно ограничить значение MaximumThreads для преобразования «Сортировка» или значение MaxMemoryUsage для преобразований «Нечеткое группирование» и «Нечеткий уточняющий запрос». При отсутствии ограничений эти преобразования могут кэшировать большие объемы данных в памяти.
Чтобы задать выражение свойств для одного из свойств объектов потока данных, перечисленных в этом разделе, откройте окно Свойства для задачи потока данных, выбрав задачу потока данных в области конструктора Поток управления или перейдя в конструкторе на вкладку Поток данных , не указывая отдельных компонентов или пути. Выберите свойство Выражения и нажмите кнопку с многоточием (...), чтобы отобразить диалоговое окно Редактор выражений свойств . Выберите свойство из раскрывающегося списка Свойство , затем введите выражение в текстовом поле Выражение и нажмите кнопку с многоточием (...), чтобы отобразить диалоговое окно Построитель выражений .
Список Свойство содержит доступные свойства только для объектов потока данных, уже помещенных в область Поток данных конструктора. Поэтому нельзя использовать список Свойство для просмотра всех возможных свойств объектов потока данных, которые поддерживают выражения свойств. Например, если источник ADO NET помещен в область конструктора, то список Свойство содержит элемент для свойства [ADO NET Source].[SqlCommand] . Список также отображает многие свойства самой задачи потока данных.
Значения свойств в следующем списке могут быть заданы с использованием выражений свойств.
Источники потока данных
| Объект потока данных | Свойство |
|---|---|
| источник ADO NET | Свойство TableOrViewName Свойство SqlCommand |
| XML-источник | Свойство XMLData Свойство XMLSchemaDefinition |
Преобразования потока данных
Дополнительные сведения об этих пользовательских свойствах см. в разделе Transformation Custom Properties.
| Объект потока данных | Свойство |
|---|---|
| преобразование «Условное разбиение» | Свойство FriendlyExpression |
| Derived Column transformation (Преобразование "Производственный столбец") | Свойство FriendlyExpression |
| преобразование «Нечеткое группирование» | Свойство MaxMemoryUsage |
| преобразование «Нечеткий уточняющий запрос» | Свойство MaxMemoryUsage |
| Преобразование "Уточняющий запрос" | Свойство SqlCommand Свойство SqlCommandParam |
| преобразование «Команда OLE DB» | Свойство SqlCommand |
| преобразование «Процентная выборка» | Свойство SamplingValue |
| Pivot transformation (Преобразование "Сведение") | Свойство PivotKeyValue |
| преобразование «Выборка строк» | Свойство SamplingValue |
| преобразование «Сортировка» | Свойство MaximumThreads |
| Unpivot transformation (Преобразование "Отмена сведения") | Свойство PivotKeyValue |
Назначения потока данных
| Объект потока данных | Свойство |
|---|---|
| Назначение «ADO.NET» | Свойство TableOrViewName Свойство BatchSize Свойство CommandTimeout |
| назначение «Неструктурированный файл» | Свойство Header |
| Назначение SQL Server Compact | Свойство TableName |
| назначение «SQL Server» | Свойство BulkInsertTableName Свойство BulkInsertFirstRow Свойство BulkInsertLastRow Свойство BulkInsertOrder Свойство Timeout |