Компонент скрипта

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

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

  • Доступ к бизнес-правилам в существующей сборке .NET. Например, скрипт может применять бизнес-правило, указывающее диапазон допустимых значений в столбце Income .

  • Используйте пользовательские формулы и функции наряду с функциями и операторами, которые предоставляет грамматика выражений службы Integration Services. Например, проверьте номера кредитных карт, использующие формулу LUHN.

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

Компонент скрипта предоставляет простой и быстрый способ включения пользовательских функций в поток данных. Однако если вы планируете повторно использовать код скрипта в нескольких пакетах, следует рассмотреть возможность программирования пользовательского компонента вместо использования компонента скрипта. Дополнительные сведения см. в разделе "Разработка пользовательского компонента потока данных".

Замечание

Если компонент скрипта содержит скрипт, который пытается считывать значение столбца со значением NULL, компонент скрипта завершается ошибкой при запуске пакета. Рекомендуем, чтобы ваш сценарий использовал метод IsNull для определения, является ли столбец NULL, прежде чем пытаться считать значение столбца.

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

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

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

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

Компонент скрипта не поддерживает выходные данные об ошибках.

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

Общие сведения о режимах компонентов скрипта

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

Написание скрипта, который использует компонент

Компонент скрипта использует средства Microsoft Visual Studio для приложений (VSTA) в качестве среды, в которой вы пишете скрипты. Доступ к VSTA осуществляется из редактора преобразования скриптов. Дополнительные сведения см. в редакторе преобразования скриптов (страница скрипта).

Компонент скрипта предоставляет проект VSTA, включающий автоматически созданный класс с именем ScriptMain, представляющий метаданные компонента. Например, если компонент скрипта используется в качестве преобразования с тремя выходными данными, ScriptMain включает метод для каждого вывода. ScriptMain — это точка входа в скрипт.

VSTA включает все стандартные функции среды Visual Studio, такие как редактор Visual Studio с цветом, IntelliSense и обозреватель объектов. Скрипт, который использует компонент скрипта, хранится в определении пакета. При разработке пакета код скрипта временно записывается в файл проекта.

VSTA поддерживает языки программирования Microsoft Visual C# и Microsoft Visual Basic.

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

Замечание

В отличие от предыдущих версий, где можно указать, были ли предварительно компилированы скрипты, все скрипты предварительно компилируются в SQL Server 2008 Integration Services (SSIS) и более поздних версиях. При предварительной компиляции скрипта подсистема языка не загружается во время выполнения, и пакет выполняется быстрее. Однако предварительно скомпилированные двоичные файлы используют значительное место на диске.

Настройка компонента скрипта

Компонент скрипта можно настроить следующим образом:

  • Выберите входные столбцы для ссылки.

    Замечание

    При использовании конструктора служб SSIS можно настроить только один вход.

  • Укажите скрипт, который выполняет компонент.

  • Укажите язык скрипта.

  • Предоставьте разделенные запятыми списки переменных только для чтения и для чтения и записи.

  • Добавьте дополнительные выходные данные и добавьте столбцы вывода, которым присваивает данные скрипт.

Свойства могут быть заданы с помощью конструктора SSIS или программным путем.

Настройка компонента скрипта в конструкторе

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

Дополнительные сведения о настройке этих свойств в конструкторе служб SSIS см. в следующем разделе:

Настройка компонента скрипта программным способом

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

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

Связанные материалы

Преобразования служб Integration Services

Расширение потока данных с помощью компонента скрипта

  • Last updated on