WebSphere Message Broker バージョン 8.0.0.5 オペレーティング・システム: AIX、HP-Itanium、Linux、Solaris、Windows、z/OS

製品の最新バージョンについては、IBM Integration Bus バージョン 9.0 をご覧ください。

オプションのソース・エレメントからデータベースの列値を変更する際の動作

データベースの列を更新または挿入する場合には、ソースの状態 (欠落しているか、空であるか、nil であるか) に応じて異なる動作を定義できます。

データベース・ポリシーなしの動作

スキーマ・モデルでオプションとして定義されている変換を接続することによってデータベース列にデータを挿入または更新する場合には、ソース入力の取り得る状態 (欠落、空、または Nil) に対して動作を検討しておくことができます。 動作は、デフォルトにすることもできますし、データベース・ポリシーを有効にしてカスタマイズすることもできます。

表 1 は、データベース・ポリシーが有効にされていない場合のソース状態と動作を示しています。

表 2 と表 3 は、データベース・ポリシーを有効にし、ソース状態をチェックして特定のアクションを取るように構成した場合の動作を示しています。

表 1. 列にリンクされた変換に関してデータベース・ポリシーを有効にしなかった場合の挿入または更新操作時の動作
ソース状態 定義 動作
ソースが欠落している状態 入力文書にソース・エレメントが含まれていません。 データベース・サーバーに送られる SQL 文で列が渡されません。 結果は、データベース内のターゲット列の定義によって決まります。
  • 当該の列にデフォルト値が定義されている場合、そのデフォルト値がデータベース・システムによって設定されます。
  • 当該の列が NULL 可能な列として定義されていて、かつデフォルト値が定義されていない場合、その列はデータベース・システムによって NULL に設定されます。
  • 当該の列が NULL 不可の列として定義されていて、かつデフォルト値が定義されていない場合、データベース・システムは SQL 例外を返します。
ソースが空である状態 入力文書にはソース・エレメントが含まれていますが、そのソースが空です。 ブローカーは、ソース・エレメントに関する getValue によって返された値を当該の列のパラメーター値としてデータベース宛ての SQL 文に渡します。 例えば、ストリング型のエレメントは空のストリング値を返すことになるため、ターゲット・データベース列は空のストリング「"」に設定されます。
ソースが Nil である状態 入力文書には予期されたソースが含まれていますが、そのソースが nil です。 getValue によって返される値は NULL に設定されます。

データベース・ポリシーを有効にした場合の挿入操作時の動作

データベース列にデータを挿入する場合、ソース・エレメントから 1 つの値をマッピングする各変換についてデータベース・ポリシーを有効にできます。 データベース・ポリシーを設定する際には、入力ソースの各状態 (欠落、空、または Nil) について以下のいずれかのアクションを選択できます。

表 2. 列にリンクされた変換についてデータベース・ポリシーを有効にした場合の挿入操作時の動作
ソースの状態別のアクション 動作
データベース操作から列を除外します 当該の列に関するデータベース・デフォルト値を挿入します。 当該の列は、データベースへ送られる SQL 文から除外されます。 このオプションは、関連する .dbm ファイルによってターゲット・データベース列のデフォルト値がデータベース・モデル内で定義されている場合にのみ有効になります。
空のストリング値「"」を挿入します このオプションは、関連する .dbm ファイルによってターゲット・データベースがデータベース・モデル内で文字列型として定義されている場合にのみ有効になります。
NULL に設定します このオプションは、関連する .dbm ファイルによってターゲット・データベースがデータベース・モデル内で NULL 可能な列として定義されている場合にのみ有効になります。
マップ・エラーをスローします マップ・エラーを返します。
  • 欠落: BIP3970
  • 空: BIP3971
  • Nil: BIP3972
詳しくは、BIP3000-3999: 組み込みノードを参照してください。

データベース・ポリシーを有効にした場合の更新操作時の動作

データベース列のデータを更新する場合、ソース・エレメントから 1 つの値をマッピングする各変換に対してデータベース・ポリシーを有効にすることができます。 データベース・ポリシーを設定する際には、入力ソースの各状態 (欠落、空、または Nil) について以下のいずれかのアクションを選択できます。

表 3. 列にリンクされた変換についてデータベース・ポリシーを有効にした場合の更新操作時の動作
ソースの状態別のアクション 動作
データベース操作から列を除外します 当該の列は、データベースへ送られる SQL 文から除外されます。 データベース内の現行の列値は変更されません。
空のストリング値「"」に設定します このオプションは、関連する .dbm ファイルによってターゲット・データベースがデータベース・モデル内で文字列型として定義されている場合にのみ有効になります。
NULL に設定します このオプションは、関連する .dbm ファイルによってターゲット・データベースがデータベース・モデル内で NULL 可能な列として定義されている場合にのみ有効になります。
マップ・エラーをスローします マップ・エラーを返します。
  • 欠落: BIP3970
  • 空: BIP3971
  • Nil: BIP3972
詳しくは、BIP3000-3999: 組み込みノードを参照してください。
特記事項 | 商標 | ダウンロード | ライブラリー | サポート | フィードバック

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        最終更新:
        
        最終更新: 2015-02-28 17:49:39


参照トピック参照トピック | バージョン 8.0.0.5 | cm28868_