Array パラメータ サンプルの Readme

  • [アーティクル]

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

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

データベース内の行のセットを作成、更新、または削除すると便利な場合があります。これを行うには、いくつかの方法があります。1 つは、共通言語ランタイム (CLR) 統合ユーザー定義データ型を使用して、情報の配列をクライアントからサーバー上の CLR 統合ストアド プロシージャへ渡す方法です。CLR 統合ユーザー定義データ型の性質によって、サーバーに提供されるデータの大きさは 8,000 バイトに制限されます。したがって、この方法は、大規模なデータや複雑なデータを扱う場合には適切ではありません。詳細については、AdventureWorks Cycles CLR レイヤ サンプルの Readme サンプルの連絡先作成ストアド プロシージャを参照してください。操作するデータが小規模で単純な場合、この方法は、行ごとにストアド プロシージャを呼び出す方法よりもはるかに効率的です。データの順序が重要なアプリケーションでは、配列を渡すことでデータの順序を保持できます。

このサンプルの内容は次のとおりです。

  1. ContactTypeNames ユーザー定義データ型。これには、目的の連絡先の型名のリストが含まれています。
  2. Microsoft Visual C# メソッドまたは Microsoft Visual Basic メソッドとして実装された usp_EnsureContactTypeNames ストアド プロシージャ。このストアド プロシージャは、ContactTypeNames ユーザー定義データ型のインスタンスを受け取り、Person.ContactType テーブルにない連絡先名がこのユーザー定義データ型インスタンスに含まれている場合、新しい行をテーブルに挿入します。
  3. TestArrayParameter コンソール アプリケーション。このアプリケーションは、渡されたコマンド ライン パラメータに基づいて ContactTypeNames ユーザー定義データ型のインスタンスを作成し、usp_EnsureContactTypeNames ストアド プロシージャを呼び出して、このユーザー定義データ型インスタンスをパラメータとして渡します。

インストール ディレクトリ : C:\Program Files\Microsoft SQL Server\100\Samples\Engine\Programmability\CLR\ArrayParameter\

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

シナリオ

Jane は Adventure Works Cycles の開発者です。少数の単純な行をテーブルに挿入する必要がありますが、データベースの負荷を最小にする必要があります。

言語

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

機能

Array Parameter サンプルでは、Microsoft SQL Server の次の機能を使用します。

アプリケーション エリア 機能

全体

CLR、ユーザー定義データ型、Transact-SQL

前提条件

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

  • Microsoft SQL Server または Microsoft SQL Server Express。SQL Server Express は、SQL Server Express ドキュメントとサンプルの Web サイトから無償で入手できます。
  • AdventureWorks データベース。SQL Server デベロッパー Web サイトから入手できます。
  • SQL Server データベース エンジン サンプル。SQL Server デベロッパー Web サイトから入手できます。
  • .NET Framework SDK 2.0 または Microsoft Visual Studio 2005。.NET Framework SDK は無償で入手できます。「.NET Framework ドキュメントのインストール」を参照してください。

サンプルのビルド

強力な名前のキー ファイルをまだ作成していない場合は、次の指示に従ってキー ファイルを生成してください。

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

  1. Microsoft Visual Studio 2005 コマンド プロンプトを開きます。[スタート] メニューの [すべてのプログラム] をポイントし、[Microsoft .NET Framework SDK 2.0] をポイントします。次に、[SDK コマンド プロンプト] をクリックします。

    -- または --

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

  2. ディレクトリの移動コマンド (CD) を使用して、コマンド プロンプト ウィンドウの現在のディレクトリから、サンプルがインストールされているフォルダーに移動します。

    注意

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

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

    sn -k SampleKey.snk

    注意

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

Array Parameter サンプルをビルドするには

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

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

  2. AdventureWorks データベースがインストールされていることを確認します。

  3. 既定の場所に SQL Server データベース エンジン サンプルをインストールしなかった場合、サンプルのインストール先が参照されるように、Scripts\InstallCS.sql スクリプトの CREATE ASSEMBLY 部のパスを変更します。

  4. 使用している SQL Server インスタンスの管理者でない場合、インストールを完了するためには、CreateAssembly 権限が管理者から許可されている必要があります。

  5. Visual C# プロジェクトと Visual Basic プロジェクトのどちらをコンパイルしたかに応じて、SQL Server Management Studio でファイル scripts\installCS.sql または scripts\installVB.sql を開きます。ファイルに含まれるスクリプトを実行するか、コマンド プロンプト ウィンドウで次のコマンドを実行します。

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

サンプルの実行

Array Parameter サンプルを実行するには

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

    Scripts\TestCS.cmd

サンプルの削除

Array Parameter サンプルを削除するには

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

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

備考

このサンプルを正しく機能させるためには、SQL Server または SQL Server Express の共通言語ランタイムを有効にする必要があります。

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

参照

処理手順

AdventureWorks Cycles CLR レイヤ サンプルの Readme

ヘルプおよび情報

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