アセンブリ クリーンアップ サンプルの Readme

[このトピックはプレリリース版のドキュメントであり、今後のリリースでは変更される場合があります。空のトピックがプレースホルダーとして含まれています。ご注意 : マイクロソフトでは、より多くのコンテンツを日本語で提供できるよう、機械翻訳などの方法によってローカライズされたドキュメントを提供する場合があります。このプレリリース版の一部のコンテンツはそのような方法によってローカライズされたものです。私たちマイクロソフトは、このような方法でローカライズされたものが必ずしも最適ではなく、語彙、構文、文法における誤りを含む可能性を認識しています。このコンテンツの最終版は、従来の方法によるローカライズで行われ、その品質は旧版と同等のものになります。]

このサンプルは、SQL Server 2005 および SQL Server 2008 でのみ動作します。SQL Server 2005 より前のバージョンでは動作しません。

AssemblyCleanup サンプルには、Visual C# で作成された .NET ストアド プロシージャが含まれています。このストアド プロシージャを利用してメタデータ カタログに対してクエリを実行することで、現在のデータベース内で使用されていないアセンブリをクリーンアップします。

唯一のパラメータである visible_assemblies を使用して、表示される未使用のアセンブリを削除するかどうかを指定します。既定値は false で、表示されない未使用のアセンブリのみが削除されます。それ以外の値の場合、未使用のアセンブリがすべて削除されます。

未使用のアセンブリとは、エントリ ポイントが定義されておらず (ルーチンまたは型と集計)、そのアセンブリを直接的または間接的に参照するアセンブリが使用されていないアセンブリです。

注意

SQLCLR サンプルをコンパイルするときに、SQL Server に付属する Microsoft .NET Framework コンパイラのバージョンのパスを、PATH 環境変数内で最初の Framework ディレクトリにする必要があります。SQL Server に付属するコンパイラの場所は、drive:\WINNT\Microsoft.NET\Framework\v2.0.xxxxx または drive:\Windows\Microsoft.NET\Framework\v2.0.xxxxx のどちらかです。drive はインストール ドライブ、xxxxx は SQL Server に付属している .NET Framework のバージョンです。

既定のインストール ディレクトリは、C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\AssemblyCleanup です。

SQL Server のサンプルやサンプル データベースを表示したり使用したりするには、まずそれをダウンロードしてインストールする必要があります。詳細については、「SQL Server のサンプルとサンプル データベースのインストールに関する注意点」を参照してください。

シナリオ

開発者は、SQL Server とサーバーのファイル システムの間でイメージのコピーを行う必要があります。

言語

Transact-SQL、Visual C#、および Visual Basic。

前提条件

このサンプルを実行する前に、次のソフトウェアがインストールされていることを確認してください。

  • SQL Server

サンプルのビルド

まだ厳密な名前のキー ファイル ExternalSampleKey.snk を作成していない場合は、次の手順に従ってキー ファイルを生成します。

厳密な名前のキー ファイルを生成するには

  1. Microsoft Visual Studio 2005 コマンド プロンプトを開きます。[スタート] ボタンをクリックし、[すべてのプログラム][Microsoft Visual Studio 2005][Visual Studio Tools] の順にポイントして、[Visual Studio 2005 コマンド プロンプト] をクリックします。

    または

    Microsoft .NET Framework コマンド プロンプトを開きます。[スタート] ボタンをクリックし、[すべてのプログラム][Microsoft .NET Framework SDK v2.0] の順にポイントして、[SDK コマンド プロンプト] をクリックします。

  2. コマンド プロンプトでディレクトリ変更 (CD) コマンドを使用して、コマンド プロンプト ウィンドウの現在のフォルダを Samples フォルダに変更します。

    注意

    サンプルが配置されているフォルダを調べるには、[スタート] ボタンをクリックし、[すべてのプログラム][Microsoft SQL Server][マニュアルとチュートリアル] の順にポイントして、[サンプル ディレクトリ] をクリックします。既定のインストール場所を使用している場合、サンプルは <system_drive>:\Program Files\Microsoft SQL Server\100\Samples にあります。

  3. コマンド プロンプトで、次のコマンドを実行してキー ファイルを生成します。

    sn -k ExternalSampleKey.snk

    注意

    厳密な名前のキー ペアの詳細については、MSDN の .NET Development Center にある「Security Briefs: Strong Names and Security in the .NET Framework」を参照してください。

サンプルをビルドするには、次の手順を行います。

サンプルのビルド

  1. 提供されている Microsoft Visual Studio ソリューションを使用するか、コマンド プロンプトで次のようなコマンドを実行して、サンプルをコンパイルします。

    Sn -k keypair.snk

    Csc /reference:"C:\Program Files\Microsoft SQL Server\MSSQL.10.MSSQLSERVER\MSSQL\Binn\sqlaccess.dll" /target:library /debug /out:CS\AssemblyCleanup\Bin\Debug\AssemblyCleanup.dll CS\AssemblyCleanup\*.cs

  2. AdventureWorks データベースがインストールされていることを確認します。必要に応じて、サンプルをインストールするデータベースを作成します。

  3. Scripts\installCS.sql または Scripts\installVB.sql に含まれる Transact-SQL スクリプトを Management Studio に読み込み、実行します。このファイルには、SQL Server でサンプル CLR オブジェクトのインストールと登録を行うためのスクリプトが含まれています。

サンプルの実行

このサンプルを実行するには、次の手順を行います。

サンプルの実行

  1. Scripts\test.sql の Transact-SQL スクリプトを Management Studio に読み込み、実行します。このスクリプトでは、サンプルの一般的な使用例が示されます。

  2. サンプルを使った作業が終了したら、Scripts\cleanup.sql の Transact-SQL スクリプトを Management Studio に読み込み、実行します。このスクリプトによりサンプルが削除されます。

サンプルの削除

このサンプルを削除するには、次の手順を行います。

サンプルの削除

  1. Management Studio で scripts\cleanup.sql ファイルを開き、ファイルに含まれているスクリプトを実行します。または、コマンド プロンプトで次のコマンドを実行します。

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

コメント

このサンプルを正しく機能させるには、SQL Server または SQL Server Express の CLR を有効にする必要があります。

サンプルは、演習目的で利用するためにのみ提供されています。サンプルを運用環境で使用することは想定されていないため、運用環境でのサンプルのテストは行われていません。Microsoft では、これらのサンプルに関する製品サポート サービスを提供していません。システム管理者の承認を得ることなく、サンプル アプリケーションやサンプル アセンブリを、運用中の SQL Server データベースやレポート サーバーに接続したり、これらのデータと共に使用することは避けてください。

参照

概念

CLR プログラミング サンプル

その他の技術情報

Large Binary Object (LOB) Handling using ADO.Net
CLR (共通言語ランタイム) 統合のプログラミング概念

ヘルプおよび情報

SQL Server 2008 R2 の参考資料の入手