実行時に、「照会の実行」アクティビティーによって Select SQL ステートメントが実行されます。
「照会の実行」アクティビティーはパラメーター化照会 (入力パラメーターまたは入力パラメーターと出力パラメーターが含まれる照会) をサポートします。 照会で入力パラメーターを指定すると、実行時にパラメーターの値が指定されます。 次の Select ステートメントの例の ? 文字は、入力パラメーターが 1 つあることを指定します。
select * from myUserSchema.mySourceTable where myUserSchema.mySourceTable.myColumn=?
上記の Select ステートメントで
* 文字は、
mySourceTable 表で見つかった 1 つ以上の列が、照会によって 1 つ以上の出力パラメーターとして返されることを指定します。 例えば、
mySource
table に CHAR 型の列と VARCHAR 型の列の 2 つの列が含まれている場合、「
照会の実行」アクティビティーは、CHAR 型の出力パラメーターと VARCHAR 型の出力パラメーターの 2 つの出力パラメーターを返します。
注: Select SQL ステートメントのみが「照会の実行」アクティビティーでサポートされます。
Insert SQL ステートメントは「照会の実行」アクティビティーではサポートされません。
「
照会の実行」アクティビティーをオーケストレーションに追加して構成するためのステップは、
以下の手順で説明されています。
オーケストレーションで「照会の実行」を追加する
- オーケストレーションを作成するか、または開きます。 オーケストレーションのグラフィカル表現が表示されます。
- 「アクティビティー」タブを選択し、「データベース」フォルダーを展開します。
- 「照会の実行」アクティビティーをオーケストレーション上にドラッグします。
- 「照会の実行」アクティビティーを選択します。
データベース・エンドポイントを作成、選択、または編集する
- 「チェックリスト」から「エンドポイントの選出」タスクをクリックし、次のいずれかのアクションを選択します。
- 既存のエンドポイントを選択します。
- 「参照」を選択します。 「プロジェクト・エクスプローラー」が開きます。
- 既存のエンドポイントを選択し、「OK」をクリックします。
『照会 SQL ステートメントを指定する』手順までスキップします。
- 既存のエンドポイントを選択し、そのエンドポイントを編集します。
- 「参照」を選択します。 「プロジェクト・エクスプローラー」が開きます。
- 既存のエンドポイントを選択し、「OK」をクリックします。
- 「編集」をクリックします。 「エンドポイントの編集」ペインが開きます。
- エンドポイントを作成します。「新規作成」を選択します。 「エンドポイントの作成」ペインが開きます。
- データベース・エンドポイントを作成または編集します。
照会 SQL ステートメントを指定する
- 「チェックリスト」から、「照会の入力」タスクを選択します。
「照会の入力」ペインが開きます。
- ペインに表示される空白に照会を入力します。 照会の末尾にセミコロンを入力しないでください。
- SQL ステートメントを作成する際に有効な表名と列を入力できるように、選択した表の列の詳細を確認するには、「列の表示」をクリックします。
- 以下のいずれかのオプションを使用して、必要なエンコードがデータベースのデフォルト・エンコードと異なる場合に入力パラメーターと出力パラメーターに代替の文字エンコード設定を選択します。
- 「エンコード」リストから、デフォルトのエンコード・タイプの 1 つを選択します。
- 「エンコード」フィールドをクリックしてエンコード・タイプを入力することにより、エンコード・タイプを直接入力します。
- 「照会の妥当性検査」をクリックします。 このアクションによって、照会が有効かどうかが検査され、「入力のマップ」および「出力のマップ」タスクで入力パラメーターと出力パラメーターに値が追加されます。
- 「MaxRows」フィールドに値を入力します。 「MaxRows」フィールドは、実行時に照会から返す行の最大数を指定します。
注: 同じデータに対して同じ照会を複数回開始すると、同じ行セットが返されます。 例えば、「MaxRows」が 1 と等しい場合は、照会を開始するたびに常に同じ行 (最初の行) が返されます。行セットを通じての反復はありません。
照会の再試行オプションを指定する
照会の再試行オプションを指定するには、以下のようにします。
- 再試行オプションを構成します。
注: 「データベースの照会の実行 (Database Execute Query)」アクティビティーでは、再試行オプションをゼロに設定すると、統合アプライアンスは接続を無期限に再試行します。
アクティビティーの出力をマップする
- 「チェックリスト」で「出力のマップ」タスクを選択します。
Select ステートメントによって返される列は、「アクティビティーから」ペインの rows/row エレメントの下に表示されるエレメントです。
- アクティビティーの出力パラメーターをマップする必要はありません。
マッピングについての一般的な説明は、『マップの作成』を参照してください。