次の方法で共有

SQL Server Custom Connection Manager サンプル

  • [アーティクル]

更新 : 2006 年 4 月 14 日

SQL Server Custom Connection Manager サンプルでは、カスタム接続マネージャ Sql Connection Manager とそれに関連するユーザー インターフェイスを作成する方法について示しています。このサンプルは、Itanium ベースのオペレーティング システムではサポートされていません。

カスタム接続マネージャの作成の詳細については、「カスタム接続マネージャの作成」を参照してください。Integration Services での接続マネージャの使用に関する一般的な情報については、「Integration Services の接続」および「接続マネージャ」を参照してください。

このカスタム接続マネージャは、SqlClient .NET Framework データ プロバイダを使用して Microsoft SQL Server の使用可能なインスタンスに接続し、開かれている SqlConnection オブジェクトをその AcquireConnection メソッドから返します。パッケージで Sql Connection Manager の新しいインスタンスを作成すると、そのカスタム ユーザー インターフェイスでは、サーバー名およびデータベース名の入力が求められます。このサンプルでは、SQL Server の既定のインスタンスのみに接続し、Windows 認証のみを使用します。

このコード サンプルでは次の機能が実装されます。

ms345276.note(ja-jp,SQL.90).gif重要 :
サンプルは、学習に使用することのみを目的に提供されています。これらは、運用環境での使用を目的としたものではなく、運用環境でのテストも実施されていません。Microsoft からは、これらのサンプルについてのテクニカル サポートは提供されません。

サンプルの実行

コード サンプルの場所、ビルド方法、およびインストール方法を確認済みの場合は、「サンプルのテスト」に進み、コード サンプルの構成方法と実行方法を確認してください。

前提条件

このサンプルを使用するには、次のコンポーネントがインストールされている必要があります。

  • Microsoft Visual Studio 2005
  • Microsoft SQL Server 2005 Integration Services

場所

サンプル コードを既定の場所にインストールした場合は、次のディレクトリに配置されています。

C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Control Flow\SqlConnectionManager Sample

コード サンプルの C# ソリューションは SqlConnMgrCS ディレクトリに、Visual Basic ソリューションは SqlConnMgrVB ディレクトリにあります。

サンプルをインストールするために必要な 2 つの手順の詳細については、「サンプルのインストール」を参照してください。SQL Server 2005 のオリジナル リリース後にリリースされた新しいサンプルを含む、サンプルの最新バージョンを入手するには、「SQL Server 2005 Samples and Sample Databases (April 2006)」を参照してください。

サンプルのビルド

まだ Samples フォルダに厳密な名前のキー ファイルを生成していない場合は、次の手順に従ってこのキー ファイルを生成します。サンプル プロジェクトは、ビルド時にこのキー ファイルを使用して、[プロジェクトのプロパティ] ダイアログ ボックスの [署名] タブでアセンブリに署名するように構成されています。

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

  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 フォルダに変更します。このフォルダに作成するキー ファイルは、すべての SQL Server 2005 サンプル コードで使用されます。

    ms345276.note(ja-jp,SQL.90).gifメモ :
    サンプルが配置されているフォルダを確認するには、[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft SQL Server 2005]、[マニュアルとチュートリアル] の順にポイントして、[サンプル ディレクトリ] をクリックします。既定のインストール場所を使用している場合、サンプルは <system_drive>:\Program Files\Microsoft SQL Server\90\Samples にあります。

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

    sn -k SampleKey.snk
    ms345276.note(ja-jp,SQL.90).gif重要 :
    厳密な名前のキー ペアの詳細については、MSDN の .NET Development Center にある「Security Briefs: Strong Names and Security in the .NET Framework」を参照してください。

  4. 後続の手順では、キー ファイルの公開キー トークンが必要になります。公開キー トークンを取得するには、まず、コマンド プロンプトで次のコマンドを実行して、キー ファイルの公開キーを新しいファイルに抽出します。

    sn -p SampleKey.snk SampleKeyPublic.snk

    ここで、コマンド プロンプトで次のコマンドを実行して、新しいファイルから公開キー トークンを表示します。

    sn -t SampleKeyPublic.snk

    公開キー トークンをクリップボードにコピーするか、後で使用するために保存します。

Microsoft Visual Studio 2005 でサンプルをビルドするには

  1. [ファイル] メニューの [開く] をポイントし、[プロジェクト] をクリックして、ソリューション ファイル SqlConnMgrVB.sln または SqlConnMgrCS.sln を開きます。

  2. ソリューション エクスプローラで、SqlConnMgrVB または SqlConnMgrCS プロジェクトを選択します。

  3. SqlConnMgrCS.cs ファイルまたは SqlConnMgrVB.vb ファイル内で、クラス宣言の前にある DtsConnection 属性を探し、この属性の UITypeName プロパティに含まれている公開キー トークンの英数字値を、キー ファイルから取得しておいた公開キー トークンと置き換えます。

  4. [ビルド] メニューの [ソリューションのビルド] をクリックします。

サンプルのインストール

このサンプルは、Visual Basic と C# の両方で提供されています。サンプルのバージョンごとにアセンブリを区別するために、出力アセンブリ名には "CS" または "VB" が追加されます。コンポーネントが正常にビルドされたら、次の手順を実行して、このコンポーネントを接続マネージャとして Business Intelligence Development Studio 内のパッケージに追加します。

コンポーネントを Connections フォルダにコピーするには

  1. Windows エクスプローラ、またはファイル システムでの作業に適切なアプリケーションを開きます。

  2. アセンブリ (SqlConnMgrCS.dll および SqlConnMgrUICS.dll、または SqlConnMgrVB.dll および SqlConnMgrUIVB.dll) を、%system%\Program Files\Microsoft SQL Server\90\DTS にある Connections フォルダにコピーします。

アセンブリをドラッグしてコンポーネントをグローバル アセンブリ キャッシュ (GAC) にインストールするには

  1. Windows エクスプローラ、またはファイル システムでの作業に適切なアプリケーションを開きます。

  2. アセンブリを、Connections フォルダから、グローバル アセンブリ キャッシュ (GAC) があるフォルダ (%system%\assembly) にドラッグします。

gacutil.exe を使用してコンポーネントをグローバル アセンブリ キャッシュ (GAC) にインストールするには

  1. コマンド プロンプト ウィンドウを開きます。

  2. 次のコマンドを入力して、C# バージョンのコンポーネントおよびユーザー インターフェイスを GAC にインストールします。

    gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrCS.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrCS\bin\Debug\SqlConnMgrUICS.dll"

    または

    次のコマンドを入力して、Visual Basic バージョンのコンポーネントおよびユーザー インターフェイスを GAC にインストールします。

    gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrVB.dll"
gacutil.exe -iF " C:\Program Files\Microsoft SQL Server\90\Samples\Integration Services\Programming Samples\Control Flow\SqlConnectionManager Sample\SqlConnMgrVB\bin\Debug\SqlConnMgrUIVB.dll"

サンプルのテスト

パッケージでカスタム接続マネージャをテストできるようになりました。

パッケージ内のサンプルの接続マネージャを使用するには

  1. SSIS デザイナの [接続マネージャ] 領域で右クリックして [新しい接続] をクリックし、使用可能な接続の種類の一覧で SQL を選択します。[OK] をクリックします。

  2. 新しい接続マネージャを編集します。[Sql Connection Manager エディタ] で、SQL Server データベース エンジンの使用可能な既定のインスタンスおよび使用可能なデータベースの名前を指定します。

変更履歴

リリース 履歴

2006 年 4 月 14 日
変更内容 :
  • ファイル名およびフォルダ名を修正しました。