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

Статья
12/15/2008

Образец Remove Duplicates демонстрирует реализацию компонента преобразования потока данных с асинхронным выводом. Компоненты с асинхронным выводом получают ввод и вывод PipelineBuffer в соответствии с вводом и выводом объекта. Входные буферы содержат строки, предоставленные компонентами восходящего потока данных. Выходной буфер пуст и заполняется компонентом, обычно с использованием строк из входного буфера, в процессе вызова метода ProcessInput. После получения всех строк они сортируются, затем различающиеся строки направляются в один выходной параметр, а дубликаты строк — в другой. Этот образец не поддерживается на архитектуре IA64.

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

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

Дополнительные сведения о создании компонента с асинхронными выходами см. в разделе электронной документации по SQL Server 2005 «Разработка пользовательского компонента преобразования с асинхронными выходами».

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

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

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

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

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

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

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

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\RemoveDuplicates 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 2.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

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

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

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

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

Откройте проводник Windows или любое другое приложения для работы с файловой системой.
Скопируйте сборку (RemoveDuplicatesCS.dll или RemoveDuplicatesVB.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\RemoveDuplicatesCS.dll "

-или-

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

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

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

Откройте среду Business Intelligence Development Studio.
Щелкните область элементов правой кнопкой мыши и выберите пункт Выбрать элементы.
В диалоговом окне Выбор элементов области элементов перейдите на вкладку Элементы потока данных служб SSIS.

Установите флажок рядом с необходимым компонентом и нажмите кнопку ОК.

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

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

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

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

Настройка образца компонента в пакете

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

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