Образец ADO Source Component

Статья
12/15/2008

Образец ADO Source Component демонстрирует, как реализовать компонент, который можно использовать как источник данных в задаче потока данных. Этот компонент использует диспетчер соединений ADO.NET для соединения с базой данных и выполняет инструкцию SQL, введенную пользователем. Строка, получаемая путем выполнения инструкции, добавляется в буфер PipelineBuffer, предоставленный компоненту задачей потока данных, и впоследствии становится доступной нижестоящим компонентам. Этот образец не поддерживается в операционных системах на платформе 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\Ado.

Решение для образца кода на языке 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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Добавьте диспетчер соединений ADO.NET к пакету и выберите поставщик Microsoft OLE DB для SQL Server. Настройте образец компонента для использования этого диспетчера соединений.
На странице «Свойства компонента» в Расширенном редакторе в разделе «Пользовательские свойства» укажите в качестве значения пользовательского свойства SqlStatement допустимый SQL-запрос к таблицам или представлениям той базы данных, к которой подключается диспетчер соединений.

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