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

AdventureWorks Cycles CLR Layer

  • Статья

Образец AdventureWorks Cycles CLR Layer для SQL Server 2005 содержит некоторые полезные программы, которые обеспечивают дополнительный уровень функциональных возможностей для образца базы данных AdventureWorks. Первая программа создает контактные записи для разных групп людей, включенных в базу данных AdventureWorks. Сведения о контактах указываются с помощью XML-данных и передаются хранимой процедуре на языке C#. Вторая программа задает пользовательский тип данных Currency на языке C#. Пользовательский тип данных включает в себя количество и культуру, что помогает выбрать правильный способ подготовки к показу суммы в виде значения валюты в представлении конкретной культурной среды. Третья программа предоставляет функцию конвертации валюты, которая возвращает экземпляр пользовательского типа данных Currency. Если база данных AdventureWorks содержит коэффициент перевода из долларов США в валюту, связанную с заданной культурой, функция перевода возвращает пользовательский тип данных Currency с коэффициентом перевода и культурой, соответствующей запрошенной. В противном случае пользовательский тип данных Currency возвращается с исходной суммой, которая должна быть выражена в долларах США, и культурой «en-us». Также программы показывают, как регистрировать и отменять регистрацию методов и сборок среды CLR при помощи Transact-SQL.

ms160866.note(ru-ru,SQL.90).gifПримечание.
Курсы обмена, используемые в этом образце, являются вымышленными и не должны использоваться при реальных финансовых транзакциях.

Каталог установки по умолчанию — «диск:\Program Files\Microsoft SQL Server\90\Samples\Engine\Programmability\CLR\AdventureWorks».

Сценарий

  • Разработчику нужен удобный способ представления, сохранения и обработки различных денежных сумм в различных валютах.
  • Разработчику нужен удобный способ создания новых контактных данных для сотрудников, розничных, оптовых покупателей и поставщиков, а также удобный способ связывания этих данных с другими данными, хранящимися в базе данных AdventureWorks.

Языки

Transact-SQL, Visual C# и Visual Basic.

Возможности

Образец уровня SQLCLR использует следующие возможности SQL Server 2005.

Часть образца Возможности

Контакт

XML

Типы Currency, ConvertCurrency

Определяемый пользователем тип CLR, определяемая пользователем функция CLR

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

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

  • Выпуск SQL Server 2005 или SQL Server 2005 Express Edition (SQL Server Express). SQL Server Express можно получить бесплатно на веб-узле «Документация и образцы SQL Server 2005 Express Edition».
  • База данных AdventureWorks, включенная в поставку SQL Server 2005, также доступна в центре разработчиков SQL Server.
  • Образцы компонента SQL Server 2005 Database Engine. Данные образцы входят в комплект SQL Server 2005. Последнюю версию образцов можно загрузить в центре разработчиков на SQL Server.
  • Пакет .NET Framework SDK 2.0 или среда Microsoft Visual Studio 2005. Пакет .NET Framework SDK можно получить бесплатно. См. раздел Установка пакета .NET Framework SDK.

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

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

Создание файла ключа для строгого имени

  1. Откройте командную строку среды Microsoft Visual Studio 2005. В меню Пуск последовательно укажите Все программы, Microsoft Visual Studio 2005, Средства Visual Studio и выберите пункт Командная строка Visual Studio 2005.

    — или —

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

  2. Для перехода из текущей папки в папку «Samples» в командной строке используйте команду смены каталога (CD).

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

  3. Для создания ключевых файлов выполните следующие команды в командной строке:

    sn -k SampleKey.snk

    sn -k UnsafeSampleKey.snk

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

Чтобы построить образец, выполните следующее.

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

  1. Скомпилируйте образец в среде Visual Studio 2005 с помощью предоставляемого решения Visual Studio или программы Microsoft MSBuild, которая включена в пакет .NET Framework SDK 2.0. Запустите из командной строки следующую команду:

    msbuild /nologo /verbosity:quiet /property:Configuration=Debug CS\AdventureWorksCS.sln

  2. Убедитесь, что установлена база данных AdventureWorks.

  3. Если образцы компонента SQL Server Database Engine были установлены не в каталог по умолчанию, то измените в файле сценария Scripts\InstallCS.sql путь в разделе CREATE ASSEMBLY таким образом, чтобы он указывал на каталог, в который были установлены эти образцы.

  4. Если вы не являетесь администратором используемого экземпляра сервера SQL Server, то для завершения установки необходимо, чтобы администратор предоставил разрешение CreateAssembly.

  5. Откройте файл scripts\installCS.sql или scripts\installVB.sql — в зависимости от того, скомпилирован ли проект на языке Visual C# или на Visual Basic в среде SQL Server Management Studio. Выполните содержащийся в этом файле сценарий или выполните в командной строке следующую команду:

    sqlcmd -E -I -i Scripts\InstallCS.sql

    Сценарий выполняет следующие действия:

    • удаляет все хранимые процедуры, которые можно определить, если они существуют;
    • удаляет регистрацию сборки, если она уже существует;
    • регистрирует сборку;
    • регистрирует хранимые процедуры CLR.

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

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

Запустить образца

  1. Загрузите файл Scripts\test.sql в среду Management Studio и запустите его. Либо выполните в командной строке следующую команду:

    sqlcmd -E -I -i Scripts\test.sql

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

Используйте следующую процедуру для удаления образца уровня SQLCLR.

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

  1. Загрузите и запустите в среде Management Studio файл Scripts\cleanup.sql. Либо выполните в командной строке следующую команду:

    sqlcmd -E -I -i Scripts\cleanup.sql

Примечания

Чтобы этот образец работал правильно, среда CLR для SQL Server 2005 или SQL Server 2005 Express Edition должна быть включена.

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

См. также

Задачи

Readme_Storefront

Основные понятия

Образцы программирования для среды CLR

Справка и поддержка

Получение помощи по SQL Server 2005

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

Версия Журнал

5 декабря 2005 г.
Измененное содержимое
  • Изменены инструкции по созданию файла ключа, в том числе его имя и расположение.