スクリプト コンポーネントによる同期変換の作成
更新 : 2006 年 7 月 17 日
Integration Services パッケージのデータ フロー内で変換コンポーネントを使用することにより、変換元から変換先にデータが受け渡される過程で、データを修正または分析できます。同期出力型の変換では、各入力列はコンポーネントを通過するたびに処理されます。非同期出力型の変換では、処理を完了するための入力列をすべて受け取ってから、処理が行われます。このトピックでは、同期変換について説明します。非同期変換の詳細については、「スクリプト コンポーネントによる非同期変換の作成」を参照してください。同期コンポーネントと非同期コンポーネントの相違点の詳細については、「同期および非同期変換について」を参照してください。
スクリプト コンポーネントの概要については、「スクリプト コンポーネントによるデータ フローの拡張」を参照してください。
スクリプト コンポーネントおよびそれによって生成されるインフラストラクチャ コードを活用すれば、カスタム データ フロー コンポーネントを開発するための手順を大幅に簡略化できます。スクリプト コンポーネントの動作のしくみを理解するため、「カスタム データ フロー コンポーネントの開発」のセクション、特に「同期出力型のカスタム変換コンポーネントの開発」を参照して、カスタム データ フロー コンポーネントの開発手順に目を通しておくと役に立ちます。
同期変換コンポーネントの概要
SSIS デザイナの [データ フロー] ペインにスクリプト コンポーネントを追加すると、[スクリプト コンポーネントの種類を選択] ダイアログ ボックスが開き、[変換元]、[変換先]、[変換] コンポーネントの種類のいずれかを選択するように求められます。このダイアログ ボックスで、[変換] を選択します。
メタデータ デザイン モードでの同期変換コンポーネントの構成
変換コンポーネントを作成するオプションを選択したら、[スクリプト変換エディタ] を使用して、コンポーネントを構成します。詳細については、「スクリプト コンポーネント エディタでのスクリプト コンポーネントの構成」を参照してください。
データ フロー変換コンポーネントには 1 つの入力があり、1 つ以上の出力を設定できます。コンポーネントの入力および出力の設定は、メタデータ デザイン モードでカスタム スクリプトを記述する前に完了する必要のある作業の 1 つです。これを行うには、 [スクリプト変換エディタ] を使用します。
入力列の設定
変換コンポーネントには 1 つの入力があります。
[スクリプト変換エディタ] の [入力列] ページには、データ フローの上流コンポーネントの出力で使用できる列が一覧表示されます。変換する列、またはそのまま出力する列を選択します。変換するすべての列の適切な場所に、読み取り/書き込みのマークを付けます。
[スクリプト変換エディタ] の [入力列] ページの詳細については、「[スクリプト変換エディタ] ([入力列] ページ)」を参照してください。
入力、出力、および出力列の設定
変換コンポーネントには、1 つ以上の出力を設定できます。
[スクリプト変換エディタ] の [入力および出力] ページには、1 つの出力が作成されていますが、出力列は作成されていません。エディタのこのページで、必要に応じて以下の項目を設定します。
- 予期しない値を含む行に対するシミュレートされたエラー出力など、1 つ以上の出力を追加して作成する場合は、[出力の追加] および [出力の削除] ボタンを使用して、同期変換コンポーネントの出力を管理します。すべての入力行は、使用できるすべての出力に送信されます。ただし、各行を出力のうちいずれか 1 つにリダイレクトするように指定した場合を除きます。行をリダイレクトするように指定するには、出力の ExclusionGroup プロパティに 0 以外の整数値を指定します。出力を識別するために ExclusionGroup に入力した整数値に特別の意味はありませんが、指定した出力のグループでは一貫して同じ整数を使用する必要があります。
メモ :
すべての行を出力しない場合は、0 以外の ExclusionGroup プロパティ値を単一の出力で使用することもできます。ただし、この場合は、出力に送信する各行について、DirectRowTo<outputbuffer> メソッドを明示的に呼び出す必要があります。 - 入力および出力に、わかりやすい名前を割り当てます。スクリプト コンポーネントはこの名前を使用して、型指定されたアクセサ プロパティを生成します。これは、スクリプト内で入力や出力を参照するために使用できます。
- 同期変換の列は現状のままにしておきます。通常、同期変換はデータ フローに列を追加しません。データはバッファの所定の位置で変更され、バッファがデータ フロー内の次のコンポーネントに渡されます。このような場合、変換の出力に対して明示的に出力列を追加したり構成する必要はありません。出力がエディタに表示される際、明示的に定義された列は含まれません。
- 行レベルのエラー用のシミュレートされたエラー出力に新しい列を追加します。通常、同じ ExclusionGroup 内の複数の出力には、同じ出力列のセットが含まれます。ただし、シミュレートされたエラー出力を作成するには、エラー情報を格納するために列の追加が必要となる場合があります。データ フロー エンジンがエラー行を処理する方法については、「データ フロー コンポーネントでのエラー出力の使用」を参照してください。スクリプト コンポーネントでは、独自のコードを記述して、追加した列に該当するエラー情報を格納する必要があるので注意してください。詳細については、「スクリプト コンポーネントに対するエラー出力のシミュレート」を参照してください。
[スクリプト変換エディタ] の [入力および出力] ページの詳細については、「[スクリプト変換エディタ] ([入力および出力] ページ)」を参照してください。
変数の追加
既存の変数の値をスクリプト内で使用する場合、[スクリプト変換エディタ] の [スクリプト] ページで、ReadOnlyVariables プロパティおよび ReadWriteVariables プロパティの領域に追加できます。複数の変数を追加する場合は、変数名をコンマで区切ります。
スクリプト コンポーネントで変数を使用する方法に関する一般情報については、「スクリプト コンポーネントでの変数の使用」を参照してください。
[スクリプト変換エディタ] の [スクリプト] ページの詳細については、「[スクリプト変換エディタ] ([スクリプト] ページ)」を参照してください。
コード デザイン モードでの同期変換コンポーネントのスクリプト作成
コンポーネントのメタデータを設定したら、Visual Studio for Applications (VSA) IDE を開き、Visual Basic .NET 言語を使用してカスタム スクリプトを記述します。VSA IDE を開くには、[スクリプト変換エディタ] の [スクリプト] ページで、[スクリプトのデザイン] をクリックします。
スクリプト コンポーネントを使用して作成するすべての種類のコンポーネントについては、「スクリプト コンポーネントのコーディングおよびデバッグ」を参照してください。
自動生成されたコードについて
変換コンポーネントを作成して構成した後で VSA IDE を開くと、コード エディタには ScriptMain クラスが編集可能な状態で表示されます。また、ProcessInputRow メソッドがスタブとして表示されます。カスタム コードは ScriptMain クラスに記述します。また、ProcessInputRow は変換コンポーネントの最重要メソッドです。
VSA の [プロジェクト エクスプローラ] ウィンドウを開くと、スクリプト コンポーネントにより、BufferWrapper および ComponentWrapper というプロジェクト アイテムが、読み取り専用の状態で自動生成されていることもわかります。ScriptMain クラスは、ComponentWrapper プロジェクト アイテム内の UserComponent クラスを継承します。
実行時には、データ フロー エンジンが UserComponent クラスの ProcessInput メソッドを呼び出します。これは親クラスである ScriptComponent の ProcessInput メソッドをオーバーライドします。ProcessInput メソッドは、入力バッファに格納された行を順にループし、各行で 1 回ずつ ProcessInputRow メソッドを呼び出します。
カスタム コードの記述
同期出力型の変換コンポーネントは、記述するすべてのデータ フロー コンポーネントの中で最も単純です。たとえば、このトピックの単一出力の例は、次のカスタム コードで構成されています。
Row.City = UCase(Row.City)
同期型のカスタム変換コンポーネントの作成を完了するには、オーバーライドされた ProcessInputRow メソッドを使用して、入力バッファにある各行のデータを変換します。データ フロー エンジンは、バッファがいっぱいになると、データ フロー内の次のコンポーネントにこのバッファを渡します。
必要に応じて、ScriptMain クラスで使用できる PreExecute メソッドや PostExecute メソッドにもスクリプトを記述して、準備処理や終了後の処理を行う場合もあります。
複数の出力の処理
使用できる 2 つ以上の出力のいずれかに入力行を送信する場合でも、前述した単一出力の例と比べて、必要なカスタム コードはそれほど多くありません。たとえば、このトピックの 2 つの出力の例は、次のカスタム コードで構成されています。
Row.City = UCase(Row.City)
If Row.City = "REDMOND" Then
Row.DirectRowToMyRedmondAddresses()
Else
Row.DirectRowToMyOtherAddresses()
End If
この例では、ユーザーが設定した出力の名前に基づき、スクリプト コンポーネントが DirectRowTo<OutputBufferX> メソッドを生成します。同様のコードを使用して、シミュレートされたエラー出力にエラー行を送信することもできます。
例
この例では、同期変換コンポーネントを作成するために、ScriptMain クラスで必要なカスタム コードを示します。
![]() |
---|
これらの例では、サンプル データベース AdventureWorks の Person.Address テーブルを使用して、その第 1 列および第 4 列、つまり int 型の AddressID および nvarchar(30) 型の City の各列を、データ フローにそのまま渡します。このセクションの変換元、変換、および変換先の例でも、同じデータが使用されます。他の前提条件および仮定条件については、それぞれの例で説明します。 |
単一出力の同期変換の例
この例では、単一の出力が含まれる同期変換コンポーネントを示します。この変換は、AddressID 列を使用して City 列を大文字に変換します。
このサンプル コードを実行する場合は、パッケージやコンポーネントを次のように構成する必要があります。
新しいスクリプト コンポーネントを [データ フロー] デザイナ画面に追加し、変換として構成します。
SSIS デザイナで、変換元または他の変換の出力を、新しい変換コンポーネントに接続します。この出力には、サンプル データベース AdventureWorks の Person.Address テーブルから、AddressID 列および City 列を含むデータが供給される必要があります。
[スクリプト変換エディタ] を開きます。[入力列] ページで、AddressID 列と City 列を選択します。City 列を、読み取り/書き込み可能としてマークします。
[入力および出力] ページで、入力と出力を MyAddressInput と MyAddressOutput などのわかりやすい名前に変更します。出力の SynchronousInputID は、入力の ID に対応していることに注意してください。したがって、出力列を追加して設定する必要はありません。
[スクリプト] ページで、[スクリプトのデザイン] をクリックし、次のスクリプトを入力します。スクリプト開発環境と [スクリプト変換エディタ] を閉じます。
SQL Server の変換先、または「スクリプト コンポーネントによる変換先の作成」で説明されている変換先コンポーネントの例など、AddressID および City 列が含まれる変換先コンポーネントを作成して構成します。変換の出力を変換先コンポーネントに接続します。AdventureWorks データベースで次の Transact-SQL コマンドを実行して、変換先テーブルを作成できます。
CREATE TABLE [Person].[Address2]( [AddressID] [int] NOT NULL, [City] [nvarchar](30) NOT NULL )
サンプルを実行します。
Public Class ScriptMain
Inherits UserComponent
Public Overrides Sub MyAddressInput_ProcessInputRow(ByVal Row As MyAddressInputBuffer)
Row.City = UCase(Row.City)
End Sub
End Class
2 つの出力の同期変換の例
この例では、2 つの出力を持つ同期変換コンポーネントを示します。この変換は、AddressID 列を使用して City 列を大文字に変換します。都市名が Redmond の場合、変換はその行を 1 つの出力に送信し、他のすべての行をもう 1 つの出力に送信します。
このサンプル コードを実行する場合は、パッケージやコンポーネントを次のように構成する必要があります。
新しいスクリプト コンポーネントを [データ フロー] デザイナ画面に追加し、変換として構成します。
SSIS デザイナで、変換元または他の変換の出力を、新しい変換コンポーネントに接続します。この出力には、サンプル データベース AdventureWorks の Person.Address テーブルから、少なくとも AddressID 列および City 列を含むデータが供給される必要があります。
[スクリプト変換エディタ] を開きます。[入力列] ページで、AddressID 列と City 列を選択します。City 列を、読み取り/書き込み可能としてマークします。
[入力および出力] ページで、2 番目の出力を作成します。新しい出力を追加したら、SynchronousInputID が入力の ID に設定されていることを確認します。このプロパティは、既定として作成された最初の出力で既に設定されています。各出力で、ExclusionGroup プロパティを 0 以外の同じ値に設定し、入力行を 2 つの相互排他的な出力に分割することを指定します。出力列を出力に追加する必要はありません。
入力と出力を、MyAddressInput、MyRedmondAddresses、MyOtherAddresses などのわかりやすい名前に変更します。
[スクリプト] ページで、[スクリプトのデザイン] をクリックし、次のスクリプトを入力します。スクリプト開発環境と [スクリプト変換エディタ] を閉じます。
SQL Server の変換先、フラット ファイル変換先、または「スクリプト コンポーネントによる変換先の作成」で説明されている変換先コンポーネントの例など、AddressID および City 列が含まれる 2 つの変換先コンポーネントを作成して構成します。変換の各出力をいずれかの変換先コンポーネントに接続します。変換先テーブルを作成するには、AdventureWorks データベースで次の Transact-SQL コマンドと同様のコマンド (一意のテーブル名を使用) を実行します。
CREATE TABLE [Person].[Address2]( [AddressID] [int] NOT NULL, [City] [nvarchar](30) NOT NULL
サンプルを実行します。
Public Class ScriptMain
Inherits UserComponent
Public Overrides Sub MyAddressInput_ProcessInputRow(ByVal Row As MyAddressInputBuffer)
Row.City = UCase(Row.City)
If Row.City = "REDMOND" Then
Row.DirectRowToMyRedmondAddresses()
Else
Row.DirectRowToMyOtherAddresses()
End If
End Sub
End Class
参照
概念
同期および非同期変換について
スクリプト コンポーネントによる非同期変換の作成
同期出力型のカスタム変換コンポーネントの開発
ヘルプおよび情報
変更履歴
リリース | 履歴 |
---|---|
2006 年 7 月 17 日 |
|
2006 年 4 月 14 日 |
|