Образец компонента DatasetDestination

Статья
12/15/2008

Образец DatasetDestination демонстрирует реализацию целевого пользовательского компонента, который интегрируется в среду Business Intelligence Development Studio и может быть добавлен в задачу «Поток данных». Компонент сохраняет в набор данных строки, получаемые во время своей работы. По завершении работы, в зависимости от конфигурации компонента, набор данных связывается с переменной периода исполнения и может быть записан в XML-файл. Такой файл, созданный из набора данных, может быть использован в качестве источника данных XML. Такой подход позволяет сохранить результаты выполнения одного потока данных, а затем использовать их в качестве источника данных для другого компонента. Этот образец не поддерживается в операционных системах на платформе Itanium.

Важно!
Образцы кода «Data Flow Programming» служб Integration Services предназначены для демонстрации возможностей ядра, которые должны быть реализованы для создания пользовательского компонента потока данных. В образцы не входит полная поддержка настройки в Расширенном редакторе. Например, нельзя использовать Расширенный редактор для добавления или удаления входов и выходов, а также для настройки столбцов. Образцы предназначены только для обучения. Они не предназначены для использования в рабочей среде и не тестировались в ней. Корпорация Майкрософт не предоставляет техническую поддержку для этих образцов.

Образцы кода «Data Flow Programming» служб Integration Services предназначены для демонстрации возможностей ядра, которые должны быть реализованы для создания пользовательского компонента потока данных. В образцы не входит полная поддержка настройки в Расширенном редакторе. Например, нельзя использовать Расширенный редактор для добавления или удаления входов и выходов, а также для настройки столбцов. Образцы предназначены только для обучения. Они не предназначены для использования в рабочей среде и не тестировались в ней. Корпорация Майкрософт не предоставляет техническую поддержку для этих образцов.

Выполнение образца

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

Предварительные требования

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

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

Расположение

Если образец кода был установлен в каталог по умолчанию, то он расположен в следующем каталоге:

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\ DataSetDestination Component Sample\

Решение для образца кода на языке C# расположено в каталоге CS, а решение на языке Visual Basic — в каталоге VB.

Сведения о двухэтапном процессе установки образцов см. в разделе Установка образцов. Чтобы получить последнюю версию образцов, включая новые, выпущенные после исходной версии SQL Server 2005, см. веб-страницу «Образцы SQL Server 2005 и образцы баз данных (апрель 2006 г.)».

Построение образца

Если в папке Samples еще не создан файл ключа для строгого имени, создайте его с помощью следующей процедуры. В конфигурации образцов проектов этот файл задан в качестве ключа для подписи сборок. Просмотреть свойства подписи можно в диалоговом окне Свойства проекта на вкладке Подпись.

Создание файла ключа для строгого имени

Откройте командную строку Microsoft Visual Studio 2005: нажмите кнопку «Пуск», а затем последовательно укажите «Все программы», «Microsoft Visual Studio 2005», «Средства Visual Studio» и выберите пункт «Командная строка Visual Studio 2005».

— или —

Для открытия командной строки платформы Microsoft .NET Framework нажмите «Пуск», последовательно укажите «Программы», «Microsoft .NET Framework SDK v2.0» и выберите пункт «Командная строка пакета SDK».

В командной строке введите команду смены каталога (CD) и перейдите из текущей папки командной строки в папку Samples. Созданный в этой папке файл ключа будет использоваться всеми образцами кода SQL Server 2005.

Примечание.
Чтобы определить каталог, в котором установлены образцы, нажмите кнопку «Пуск», последовательно укажите «Программы», «Microsoft SQL Server 2005», «Документация и учебные материалы» и выберите пункт «Каталог образцов». Если использовался каталог установки по умолчанию, то образцы находятся в папке «<системный_диск>:\Program Files\Microsoft SQL Server\90\Samples».

Чтобы определить каталог, в котором установлены образцы, нажмите кнопку «Пуск», последовательно укажите «Программы», «Microsoft SQL Server 2005», «Документация и учебные материалы» и выберите пункт «Каталог образцов». Если использовался каталог установки по умолчанию, то образцы находятся в папке «<системный_диск>:\Program Files\Microsoft SQL Server\90\Samples».

Для создания файла ключа выполните следующую команду в командной строке:
```
sn -k SampleKey.snk
```
Важно Дополнительные сведения о паре ключей для строгого имени см. в разделе «Краткие сведения о безопасности: Строгие имена и безопасность в платформе .NET Framework» в центре для разработчиков .NET в MSDN.

Построение образца в среде Microsoft Visual Studio 2005

В меню Файл | Открыть выберите Проект и откройте файл DataSetDestination.sln в формате предпочитаемого языка программирования.
Чтобы построить проект, в меню Построить выберите пункт Построить DatasetDestination.

Установка образца

Данный образец предоставлен на языках Visual Basic и C#. Чтобы отличать сборки для каждой версии образца, к имени выходной сборки добавляется CS или VB. После успешного построения компонента выполните следующие шаги, чтобы добавить его в задачу потока данных в среде Business Intelligence Development Studio.

Копирование компонента в папку PipelineComponents

Откройте проводник Windows или любое другое приложения для работы с файловой системой.
Скопируйте сборку (DatasetDestinationCS.dll или DatasetDestinationVB.dll) в папку PipelineComponents, находящуюся в каталоге %system%\Program Files\Microsoft SQL Server\90\DTS.

Установка компонента в глобальный кэш сборок (GAC) с помощью перетаскивания сборок

Откройте проводник Windows или любое другое приложение для работы с файловой системой.
Перетащите сборку из папки PipelineComponents в папку, где расположен глобальный кэш сборок (GAC), в каталог %system%\assembly.

Установка компонента в глобальный кэш сборок с помощью программы gacutil.exe:

Откройте окно командной строки.
Введите следующую команду для запуска программы gacutil.exe и установите версию компонента на C# в глобальный кэш сборок:

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationCS.dll "

- or -

Введите следующую команду для запуска программы gacutil.exe и установите версию компонента на Visual Basic в глобальный кэш сборок:****

gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\DataSetDestinationVB.dll "

Добавление компонента в область элементов

Откройте среду Business Intelligence Development Studio.
Щелкните область элементов правой кнопкой мыши и выберите пункт Выбрать элементы.
В диалоговом окне Выбор элементов области элементов перейдите на вкладку Элементы потока данных служб SSIS.
Установите флажок рядом с необходимым компонентом и нажмите кнопку ОК.
Примечание Если нужный компонент не отображается в списке, нажмите кнопку Обзор и укажите его месторасположение самостоятельно. Однако в этом случае возможна неправильная установка компонента.

После завершения этих шагов компоненты становятся видимыми на вкладке Элементы потоков данных панели Область элементов и могут быть добавлены в задачу «Поток данных» в конструкторе служб SSIS.

Проверка образца

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

Свойство	Описание
RuntimeVariable	Определяет имя переменной времени выполнения, в которую набор данных будет записан после выполнения.
DataTableName	Определяет имя таблицы данных, которая либо создается (в случае нового набора данных), либо используется для дописывания (в случае существующего набора данных).
SaveDataSetToXml	Определяет, будет ли база данных сохранена в XML-файл в конце выполнения. Если значение равно true, то для компонента должен быть определен диспетчер подключения файлов.

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