ADO Source Component サンプル
ADO Source コンポーネント サンプルでは、データ フロー タスクでデータ ソースとして使用できるソース コンポーネントの実装方法を示します。このコンポーネントでは、ADO.NET 接続マネージャを使用してデータベースへの接続が取得され、ユーザーによって提供される SQL ステートメントが実行されます。このステートメントを実行することによって取得された行は、データ フロー タスクによってコンポーネントに提供された PipelineBuffer に追加されて、それ以降、下流コンポーネントに対して使用できるようになります。このサンプルは、Itanium ベースのオペレーティング システムではサポートされていません。
重要 : |
---|
Integration Services の Data Flow Programming コード サンプルは、カスタム データ フロー コンポーネントを作成するために実装する必要のあるコア機能を示しています。サンプルは、[詳細エディタ] でのカスタマイズを完全にはサポートしていません。たとえば、[詳細エディタ] を使用して、入出力値の追加や削除、または列の構成を行うことはできません。 サンプルは、学習に使用することのみを目的に提供されています。これらは、運用環境での使用を目的としたものではなく、運用環境でのテストも実施されていません。Microsoft からは、これらのサンプルについてのテクニカル サポートは提供されません。 |
サンプルの実行
コード サンプルの場所、ビルド方法、およびインストール方法を確認済みの場合は、「サンプルのテスト」に進み、コード サンプルの構成方法と実行方法を確認してください。
前提条件
このサンプルでは、次のコンポーネントがインストールされている必要があります。
- Microsoft Visual Studio 2005
- Microsoft SQL Server 2005 Integration Services
場所
サンプル コードを既定の場所にインストールした場合は、次のディレクトリに配置されています。
C:\Program Files\Microsoft SQL Server\100\Samples\Integration Services\\Programming Samples\Data Flow\Ado Source Component Sample
サンプル コードの C# ソリューションは CS ディレクトリに、Visual Basic ソリューションは VB ディレクトリにあります。
サンプルをインストールするために必要な 2 つの手順の詳細については、「サンプルのインストール」を参照してください。SQL Server 2005 のオリジナル リリース後にリリースされた新しいサンプルを含む、サンプルの最新バージョンを入手するには、「SQL Server 2005 Samples and Sample Databases (April 2006)」を参照してください。
サンプルのビルド
まだ Samples フォルダに厳密な名前のキー ファイルを生成していない場合は、次の手順に従ってこのキー ファイルを生成します。サンプル プロジェクトは、ビルド時にこのキー ファイルを使用してアセンブリに署名するように構成されています。署名プロパティは、[プロジェクトのプロパティ] ダイアログ ボックスの [署名] タブで表示できます。
厳密な名前のキー ファイルを生成するには
Microsoft Visual Studio 2005 コマンド プロンプトを開くには、[スタート] ボタンをクリックして、[すべてのプログラム]、[Microsoft Visual Studio 2005]、[Visual Studio Tools] の順にポイントし、[Visual Studio 2005 コマンド プロンプト] をクリックします。
または
Microsoft .NET Framework コマンド プロンプトを開くには、[スタート] ボタンをクリックして、[すべてのプログラム]、[Microsoft .NET Framework SDK v2.0] の順にポイントし、[SDK コマンド プロンプト] をクリックします。
コマンド プロンプトでディレクトリ変更 (CD) コマンドを使用して、コマンド プロンプト ウィンドウの現在のフォルダを Samples フォルダに変更します。このフォルダに作成するキー ファイルは、すべての SQL Server 2005 サンプル コードで使用されます。
メモ : サンプルが配置されているフォルダを確認するには、[スタート] ボタンをクリックし、[すべてのプログラム]、[Microsoft SQL Server 2005]、[マニュアルとチュートリアル] の順にポイントして、[サンプル ディレクトリ] をクリックします。既定のインストール場所を使用している場合、サンプルは <system_drive>:\Program Files\Microsoft SQL Server\90\Samples にあります。 コマンド プロンプトで、次のコマンドを実行してキー ファイルを生成します。
sn -k SampleKey.snk
重要 : 厳密な名前のキー ペアの詳細については、MSDN の .NET Development Center にある「Security Briefs: Strong Names and Security in the .NET Framework」を参照してください。
Microsoft Visual Studio 2005 でサンプルをビルドするには
[ファイル] メニューの [開く] をポイントし、[プロジェクト/ソリューション] をクリックして、使用するプログラミング言語の AdoSource.sln ソリューション ファイルを開きます。
[ビルド] メニューの [AdoSource のビルド] をクリックして、プロジェクトをビルドします。
サンプルのインストール
サンプルは、Visual Basic と C# のどちらにも提供されます。サンプルのバージョンごとにアセンブリを区別するため、出力アセンブリ名には CS または VB が追加されます。コンポーネントが正常にビルドされたら、このコンポーネントを Business Intelligence Development Studio で使用するための次の手順を実行します。
コンポーネントを PipelineComponents フォルダにコピーするには
Windows エクスプローラ、またはファイル システムでの作業に適切なアプリケーションを開きます。
アセンブリ (AdoSourceCS.dll または AdoSourceVB.dll) を %system%\Program Files\Microsoft SQL Server\90\DTS にある PipelineComponents フォルダにコピーします。
アセンブリをドラッグしてコンポーネントをグローバル アセンブリ キャッシュ (GAC) にインストールするには
Windows エクスプローラ、またはファイル システムでの作業に適切なアプリケーションを開きます。
アセンブリを、PipelineComponents フォルダから、グローバル アセンブリ キャッシュ (GAC) があるフォルダ (%system%\assembly) にドラッグします。
gacutil.exe を使用してコンポーネントをグローバル アセンブリ キャッシュ (GAC) にインストールするには
[コマンド プロンプト] ウィンドウを開きます。
次のコマンドを入力して gacutil.exe を実行し、C# バージョンのコンポーネントを GAC にインストールします。
gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\AdoSourceCS.dll"
または
次のコマンドを入力して gacutil.exe を実行し、Visual Basic バージョンのコンポーネントを GAC にインストールします。
gacutil.exe -iF "c:\Program Files\Microsoft Sql Server\90\DTS\PipelineComponents\AdoSourceVB.dll"
コンポーネントをツールボックスに追加するには
Business Intelligence Development Studio を開きます。
ツールボックスを右クリックし、[アイテムの選択] をクリックします。
[ツールボックス アイテムの選択] ダイアログ ボックスで、[SSIS データ フロー項目] タブをクリックします。
コンポーネントの隣にあるチェック ボックスをオンにして、[OK] をクリックします。
メモ : コンポーネントが一覧に表示されない場合は、[参照] をクリックして、コンポーネントを探すことができます。ただし、この場合は、コンポーネントが正しくインストールされていない可能性があります。
これらの手順を完了すると、ツールボックスの [データ フローの変換元] セクションにコンポーネントが表示され、デザイナのデータ フロー タスクに追加できるようになります。
サンプルのテスト
サンプル コンポーネントをパッケージのデータ フロー タスクに追加すると、次のように SSIS デザイナでこのコンポーネントを構成できます。
パッケージ内のサンプル コンポーネントを構成するには
ADO.NET 接続マネージャをパッケージに追加して、Microsoft OLE DB Provider for SQL Server を選択します。サンプル コンポーネントを構成して、この接続マネージャを使用します。
**[詳細エディタ]**の [コンポーネントのプロパティ] ページの [カスタム プロパティ] の下で、接続マネージャの接続先のデータベースのテーブルやビューに対して有効な SQL クエリを入力して、コンポーネントの SqlStatement カスタム プロパティを構成します。