Установление свойств компонента потока данных

  • Статья

Применяется к:sql Server SSIS Integration Runtime в Фабрика данных Azure

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

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

  • В окне " Свойства " перечислены характерные свойства каждого компонента, а также общие свойства для всех элементов потока данных.

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

Задание свойств для компонента потока данных с помощью редактора компонентов

  1. В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.

  2. Чтобы открыть пакет, дважды щелкните его в обозревателе решений.

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

  4. Дважды щелкните компонент потока данных.

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

  6. Чтобы сохранить измененный пакет, в меню Файл выберите команду Сохранить выбранные элементы.

Задание свойств для компонента потока данных в окне "Свойства"

  1. В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.

  2. Чтобы открыть пакет, дважды щелкните его в обозревателе решений.

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

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

  5. Просмотрите или измените значения свойств, затем закройте окно Свойства .

    Примечание.

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

  6. Чтобы сохранить измененный пакет, в меню Файл выберите команду Сохранить выбранные элементы.

Задание свойств для компонента потока данных с помощью Расширенного редактора

  1. В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.

  2. Чтобы открыть пакет, дважды щелкните его в обозревателе решений.

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

  4. В конструкторе потока данных щелкните компонент потока данных правой кнопкой и выберите Показать расширенный редактор.

    Примечание.

    В SQL Server компоненты потока данных, поддерживающие несколько входных данных, не могут использовать Расширенный редактор.

  5. В диалоговом окне Расширенный редактор выполните одно из следующих действий.

    • Перейдите на вкладку Диспетчеры соединений , чтобы просмотреть и определить соединение, которое использует компонент.

      Примечание.

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

    • Перейдите на вкладку Свойства компонента , чтобы просмотреть и изменить свойства уровня компонента.

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

      Примечание.

      Вкладка Сопоставление столбцов доступна только для просмотра и редактирования источников и назначений.

    • Щелкните вкладку Входные столбцы для просмотра списка доступных входных столбцов и обновления имен выходных столбцов.

      Примечание.

      Вкладка «Входные столбцы» доступна только при работе с преобразованиями и назначениями. Дополнительные сведения см. в статье Integration Services Transformations.

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

      Примечание.

      Источники не имеют входов. Назначения не имеют выходов, за исключением возможного выхода ошибок.

  6. Просмотрите или измените значения свойств.

  7. Щелкните OK.

  8. Чтобы сохранить измененный пакет, в меню Файл выберите команду Сохранить выбранные элементы.

Общие свойства компонентов потока данных

Объекты потока данных в объектной модели Служб 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 Целое Длина столбца, измеренная в символах.
Точность Целое Точность числового столбца.
Масштабировать Целое Масштаб числового столбца.

Пользовательские свойства компонентов потока данных

Сведения о пользовательских свойствах см. в следующих разделах:

Использование выражения в компоненте потока данных

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

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

  1. В SQL Server Data Tools (SSDT) откройте проект служб Integration Services, содержащий нужный пакет.

  2. Чтобы открыть пакет, дважды щелкните его в обозревателе решений.

  3. В конструкторе служб SSIS щелкните вкладку "Поток управления" и выберите задачу Поток данных, содержащую поток данных, в котором требуется реализовать выражение.

  4. Перейдите на вкладку Поток данных и перетащите преобразование «Условное разбиение» или «Производный столбец» из окна Область элементов в область конструктора.

  5. Перетащите зеленый соединитель из источника или преобразования в преобразование «Условное разбиение» или «Производный столбец».

  6. Дважды щелкните преобразование, чтобы открыть его диалоговое окно.

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

  8. В правой панели разверните узлы Математические функции, Строковые функции, Функции даты-времени, Функции NULL, Приведения типови Операторы для доступа к функциям, операторам приведения и операторам, предоставляемым грамматикой выражения.

  9. В зависимости от вида преобразования выполните одно из следующих действий для создания выражения.

    • В диалоговом окне Редактор преобразования «Условное разбиение» перетащите переменные, столбцы, функции, операторы и приведения в столбец Условие . Также можно ввести выражение непосредственно в столбец Условие .

    • В диалоговом окне Редактор преобразования «Производный столбец» перетащите переменные, столбцы, функции, операторы и приведения в столбец Выражение . Также можно ввести выражение непосредственно в столбец Выражение .

      Примечание.

      При переключении фокуса со столбца Условие или Выражение текст выражения может быть выделен, что указывает на ошибку в синтаксисе выражения.

  10. Нажмите кнопку ОК , чтобы закрыть диалоговое окно.

    Примечание.

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

Свойства потока данных, которые можно задать с помощью выражения

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

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

Выражения свойств можно использовать для настройки конфигурации каждого развернутого экземпляра пакета. Выражения свойств также можно использовать, чтобы задать ограничения времени выполнения пакета с помощью параметра /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