Обработка больших объектов

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

Образец HandlingLOBUsingCLR для SQL Server 2005 демонстрирует передачу больших объектов между SQL Server и файловой системой, доступной серверу, с использованием хранимых процедур среды CLR. Образец демонстрирует доступ к файлам в кодировке сервера и возможность вызова из хранимых процедур CLR динамических запросов и хранимых процедур. Также образец демонстрирует регистрацию и отмену регистрации методов среды CLR и сборок при помощи языка Transact-SQL.

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

Сценарий

Разработчик хочет копировать изображения между SQL Server и файловой системой на сервере.

Языки

Transact-SQL, Visual C# и Visual Basic.

Возможности

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

Часть образца	Возможности
Все части	Хранимые процедуры CLR; вызов хранимых процедур Transact-SQL из хранимых процедур среды CLR; тип данных VARBINARY(MAX).

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

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

• 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.

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

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

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

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

   — или —

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

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

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

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

   sn -k ExternalSampleKey.snk

   Важно!
   Дополнительные сведения о паре ключей для строгого имени см. в разделе «Краткие сведения о безопасности: Строгие имена и безопасность в платформе .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\HandlingLOBUsingCLR.sln

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

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

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

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

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

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

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

1. Для чтения изображения из базы данных вызовите сценарий, похожий на следующий:

   exec GetPhotoFromDB 70, 'C:\Temp\', 'test6.gif'

   go

   Убедитесь, что указываемый каталог существует.

2. Для записи изображения в базу данных вызовите сценарий, похожий на следующий:

   exec PutPhotoIntoDB 70, 'C:\Temp\', 'test1.gif'

   go

   Любая ошибка будет отражена в файле error.log в указанном каталоге. Сценарии, аналогичные представленным в этой процедуре, приводятся в файле Scripts\test.sql.

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

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

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

1. Откройте файл scripts\cleanup.sql в среде Management Studio и запустите содержащийся в нем сценарий. Либо выполните в командной строке следующую команду:

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

Примечания

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

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

См. также

Задачи

Обработка больших двоичных объектов с использованием ADO.NET

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

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

Другие ресурсы

Database Engine .NET Framework Programming

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

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

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

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