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

Readme_ServiceBrokerConfiguration

  • Статья

Изменения: 5 декабря 2005 г.

В этом образце демонстрируется создание объектов компонента Service Broker с использованием объектов SMO SQL Server. Реализация этого образца необходима, так как для создания объектов компонента Service Broker требуется несколько пользовательских элементов управления Windows и классов.

Образец предназначен для разработчика Microsoft .NET Framework, желающего освоить использование объектов SMO компонента Service Broker и узнать о том, как создавать пользовательские элементы управления Windows для управления объектами SQL Server 2005. Основной сценарий предполагает создание разработчиком Microsoft .NET Framework особого приложения управления компонентом Service Broker.

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

Требования

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

  • Пакет .NET Framework SDK 2.0. Пакет .NET Framework SDK можно получить бесплатно. Дополнительные сведения см. в разделе Установка пакета .NET Framework SDK.
  • SQL Server 2005 Database Engine.

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

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

C:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\SMO\ ServiceBrokerConfiguration

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

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

Если файл ключа для строгого имени еще не создавался, создайте его следующим образом.

To generate a strong name key file

  1. Откройте командную строку Microsoft Visual Studio 2005. Нажмите кнопку Пуск, укажите пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK.

    -- или --

    Откройте командную строку Microsoft .NET Framework. Нажмите кнопку Пуск, укажите пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK.

  2. Используйте команду CD, чтобы сменить текущий каталог командной строки и перейти в каталог, в котором установлены образцы.

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

  3. В командной строке выполните следующую команду, чтобы создать файл ключа:

    sn -k SampleKey.snk

    ms345273.note(ru-ru,SQL.90).gifВажно!
    Дополнительные сведения о паре ключей для строгого имени см. в статье по строгим именам и безопасности для платформы .NET Framework в центре разработчиков .NET в MSDN.

Построение решения Visual Studio

  1. нажмите кнопку Пуск, укажите последовательно пункты Все программы, Microsoft .NET Framework SDK v2.0 и выберите пункт Командная строка пакета SDK;

  2. укажите расположение корневой папки образца. Введите следующую команду для размещения по умолчанию:

  3. [C#] 

cd \Program Files\Microsoft SQL Server\90\``\Samples\Engine\Programmability\SMO\ServiceBrokerConfiguration\CS\

  1. Чтобы выполнить сборку решения Visual Studio, введите следующее:
    • msbuild

При использовании среды Visual Studio 2005 выполните следующее:

  1. откройте файл решения \CS\ConfigurationComponent.sln;
  2. нажмите клавишу F6, чтобы построить решение.

Установка образца базы данных SQL Server и образцов XML-схем

  1. Найдите папку \CS\Script.

  2. Откройте и запустите файл setup.sql в среде SQL Server Management Studio.

Установка основных ключей SQL Server (дополнительно)

  1. При установке привязки удаленной службы выполните следующие действия.

  2. Найдите папку \CS\Script.

  3. Откройте файл masterkey.sql в среде SQL Server Management Studio.

  4. Введите пароль для главного ключа базы данных в инструкции CREATE MASTER KEY ENCRYPTION BY PASSWORD =.

  5. Введите пароль для ключа ssb_ConfigurationSample базы данных в инструкции CREATE MASTER KEY ENCRYPTION BY PASSWORD =.

  6. Запустите файл masterkey.sql.

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

Запуск образца

  1. Версия C# по умолчанию расположена в каталоге «C:\Program Files\Microsoft SQL Server\90\Samples\SMO\ServiceBrokerConfiguration\CS\SampleApplication\bin\Debug\SampleApplication.exe».

Подключение к локальному экземпляру SQL Server

  1. Введите имя сервера в поле «Имя сервера» либо примите имя сервера по умолчанию (локальное).

  2. Нажмите кнопку Соединить.

Настройка образца для новой базы данных

  1. Выберите Параметры на вкладке Объекты.

  2. Введите ScriptPath либо примите путь по умолчанию. Путь ScriptPath используется для экспорта сценария в файл.

  3. Нажмите кнопку Создать. При нажатии кнопки Создать выполняется создание образца, включая настройку BaseUrn.

Создание класса MessageType

  1. Нажмите кнопку Создать и выберите MessageType.

  2. Введите ShippingRequest в качестве имени MessageType.

  3. Нажмите кнопку Создать для создания нового класса MessageType, выберите Создать, затем выберите Message Type.

  4. Введите ShippingAccept в качестве имени MessageType.

  5. Нажмите кнопку Создать для создания нового класса MessageType, выберите Создать, затем выберите Message Type.

  6. Введите ShippingComplete в качестве имени MessageType.

  7. Нажмите кнопку Создать для создания нового класса MessageType.

Создание контракта

  1. Нажмите кнопку Создать и выберите Контракт.

  2. Выберите раскрывающееся меню MessageTypeMappings.

  3. Выберите все только что созданные классы MessageTypes.

  4. Выберите Назначение для ShippingAccept и ShippingComplete MessageSource.

  5. Закройте раскрывающееся меню MessageTypeMappings.

  6. Введите Доставка в качестве имени контракта.

  7. Нажмите кнопку Создать, чтобы создать новый контакт.

Создание очередей

  1. Нажмите кнопку Создать и выберите Очередь.

  2. Введите ClientQueue в качестве имени очереди.

  3. Нажмите кнопку Создать для создания новой очереди, выберите Создать, затем выберите Очередь.

  4. Введите ServerQueue в качестве имени очереди.

  5. Нажмите кнопку Создать для создания новой очереди.

Создание служб без использования RemoteServiceBinding

  1. Нажмите кнопку Создать и выберите Служба.

  2. Введите ClientService в качестве имени службы.

  3. Откройте раскрывающееся меню ContractNames и выберите контракт «Доставка».

  4. Откройте раскрывающееся меню QueueName и выберите очередь ClientQueue.

  5. Введите или выберите ServiceOwnerName.

  6. Нажмите кнопку Создать для создания новой службы, выберите Создать.

  7. Введите ServerService в качестве имени службы.

  8. Откройте раскрывающееся меню ContractNames и выберите контракт «Доставка».

  9. Откройте раскрывающееся меню QueueName и выберите очередь ServerQueue.

  10. Введите или выберите ServiceOwnerName.

  11. Нажмите кнопку Создать для создания новой службы.

Создание служб с использованием RemoteServiceBinding

  1. Нажмите кнопку Создать и выберите Служба.

  2. Введите RemoteService в качестве имени службы.

  3. Откройте раскрывающееся меню ContractNames и выберите контракт «Доставка».

  4. Присвойте параметру EnableRemoteService значение true.

  5. Откройте раскрывающееся меню QueueName и выберите очередь ClientQueue.

  6. Введите или выберите ServiceOwnerName.

  7. Нажмите кнопку Создать для создания новой службы, выберите Создать.

Разрешение анонимного доступа к удаленной службе

  1. Выберите RemoteService в дереве объектов.

  2. Присвойте параметру AllowAnonymous значение true.

  3. Нажмите кнопку Изменить для изменения службы.

Создание конечной точки целевого экземпляра

  1. Нажмите кнопку Создать и выберите Конечная точка целевого экземпляра.

  2. Введите имя либо примите имя по умолчанию.

  3. Нажмите кнопку Создать.

Указание пути экспорта сценария

  1. Перейдите на вкладку Объект, если она еще не выбрана.

  2. Нажмите кнопку Параметры.

  3. Введите действительный путь ScriptPath.

  4. Нажмите кнопку Создать.

Экспорт объекта

  1. Выберите объект в дереве объектов.

  2. Выберите Сценарий, затем выберите Экспорт.

  3. Объект экспортируется по пути ScriptPath, определенному в конфигурации приложения.

Экспорт определения службы в файл

  1. Выберите службу в дереве объектов.

  2. Выберите Сценарий, затем Экспорт.

  3. Сценарий службы экспортируется по пути ScriptPath, определенному в конфигурации приложения.

Удаление объекта

  1. Выберите объект в компоненте TreeView.

  2. Выберите Удалить или Редактировать, Удалить {ObjectName}.

Изменение объекта

  1. В дереве объектов выберите объект, который необходимо изменить.

  2. Измените свойства этого объекта.

  3. Чтобы изменить объект, нажмите кнопку Изменить.

Запрос данных, описывающих объект

  1. Каждый объект может выводить в текстовое поле или сетку данные, описывающие этот объект.

  2. Выберите объект в компоненте TreeView.

  3. Нажмите кнопку «Запрос».

Удаление образца

Удаление служб

  1. Выберите узел ClientService.

  2. Удалите объект.

  3. Выберите узел ServerService.

  4. Удалите объект.

Удаление очередей

  1. Выберите узел ClientQueue.

  2. Удалите объект.

  3. Выберите узел ServerQueue.

  4. Удалите объект.

Удаление контрактов

  1. Выберите узел контракта «Доставка».

  2. Удалите объект.

Удаление классов MessageType

  1. Выберите узел ShippingRequest MessageType.

  2. Удалите объект.

  3. Выберите узел ShippingAccept MessageType.

  4. Удалите объект.

  5. Выберите узел ShippingComplete MessageType.

  6. Удалите объект.

Удаление конечной точки целевого экземпляра

  1. Щелкните узел конечной точки целевого экземпляра.

  2. Удалите объект.