Образец пользовательского диспетчера соединений SQL Server
Изменения: 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». Для создания файла ключа выполните следующую команду в командной строке:
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 г. |
|