Образец пользовательского диспетчера соединений SQL Server

Статья
12/15/2008

Изменения: 14 апреля 2006 г.

В образце пользовательского диспетчера соединений SQL Server показывается, как создавать пользовательский диспетчер соединений, диспетчер соединений SQL, а также связанный с ним пользовательский интерфейс. Этот образец не поддерживается в операционных системах на платформе Itanium.

Дополнительные сведения о создании пользовательского диспетчера соединений см. в разделе Creating a Custom Connection Manager. Общие сведения об использовании диспетчеров соединений в службах Integration Services см. в разделах Соединения служб Integration Services и Диспетчеры соединений.

Данный пользовательский диспетчер соединений подключается к доступному экземпляру Microsoft SQL Server с помощью поставщика данных SqlClient .NET Framework, а затем возвращает открытый объект SqlConnection из метода AcquireConnection. При создании в пакете нового экземпляра диспетчера соединений Sql необходимо ввести имена сервера и базы данных в соответствующие поля его пользовательского интерфейса. При выполнении данного образца производится подключение только к заданному по умолчанию экземпляру SQL Server и используется только проверка подлинности Windows.

Этот образец кода реализует следующие функции:

Переопределение класса ConnectionManagerBase.
Поддержка сохраняемости.

Важно!
Образцы предназначены только для обучения. Они не предназначены для использования в рабочей среде и не тестировались в ней. Майкрософт не предоставляет техническую поддержку для этих образцов.

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

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

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

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

Microsoft Visual Studio 2005
Microsoft SQL Server 2005 Integration Services

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

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

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\SqlConnectionManager Sample

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

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

Для выполнения следующего шага необходимо извлечь маркер открытого ключа из файла ключа. Чтобы извлечь маркер открытого ключа, необходимо сначала извлечь открытый ключ из файла ключа в новый файл. Для этого в командной строке необходимо выполнить следующую команду:
```
sn -p SampleKey.snk SampleKeyPublic.snk
```
Чтобы отобразить маркер открытого ключа из нового файла, в командной строке необходимо запустить следующую команду:
```
sn -t SampleKeyPublic.snk
```
Скопируйте маркер открытого ключа в буфер обмена или сохраните его для дальнейшего использования.

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

В меню Файл | Открыть выберите пункт Проект и откройте файл решения SqlConnMgrVB.sln или SqlConnMgrCS.sln
Выберите проект SqlConnMgrVB или SqlConnMgrCS в обозревателе решений.
Перейдите к атрибуту DtsConnection, расположенному в файле SqlConnMgrCS.cs или SqlConnMgrVB.vb выше объявления класса, и в поле свойства UITypeName замените алфавитно-цифровое значение маркера открытого ключа на его действительное значение, взятое из файла ключа.
В меню Построить выберите пункт Построить решение.

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

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

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

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

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

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

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

Откройте окно командной строки.

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

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrCS.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrUICS.dll"

— или —

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

gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrUIVB.dll"

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

Теперь пользовательский диспетчер соединений можно проверить в пакете.

Использование диспетчера соединений образца в пакете

Щелкните правой кнопкой мыши область диспетчера соединений конструктора служб SSIS, выберите пункт Создать соединение; в списке доступных типов соединения выберите SQL. Нажмите кнопку ОК.
Измените новый диспетчер соединений. В окне Редактор диспетчера соединений Sql введите имя доступного экземпляра ядра СУБД SQL Server, которое необходимо использовать по умолчанию.

Журнал изменений

Версия	Журнал
14 апреля 2006 г.	Измененное содержимое Исправлены имена файлов и папок.

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