5.1.1 抽出システム定義
- 〈この項の構成〉
(1) 機能
抽出システム定義では,抽出側Datareplicator全体の稼働環境についての情報を定義します。
(2) 形式
-
共通定義部でだけ定義する項目
set hdeid=抽出側Datareplicator識別子
〔 set extdef="抽出環境定義ファイル名"〕
〔 set sendcontrol= nodemst|sendmst 〕
set sendid01=送信先識別子
〔 …〔 set sendid64=送信先識別子〕〕
〔 set senddef01="送信環境定義ファイル名"〕
〔 …〔 set senddef64="送信環境定義ファイル名"〕〕
set sendid0001=送信先識別子
〔 …〔 set sendid4096=送信先識別子〕〕
〔 set senddef0001=送信環境定義ファイル名 〕
〔 …〔 set senddef4096=送信環境定義ファイル名〕〕
〔 set errfile_unique= true|false 〕
〔 set errfilesz=エラー情報ファイルの最大ファイルサイズ 〕
〔 set syslogout= true|false 〕
〔 set syslog_message_suppress=メッセージ番号〔,メッセージ番号〕…〕
〔 set dblocale={ sjis|euc|utf-8 }〕
〔 set msglocale={ english|sjis-japanese|euc-japanese }〕
〔 set watchintvl=エラー監視間隔 〕
〔 set cmwaittime=通信待ち時間 〕
〔 set mstservice=マスタ−ノードマスタ間通信サービス名 〕
〔 set extinfonum=最大更新情報名数 〕
〔 set syncterm= true|false 〕※1
〔 set termlevel={ normal|plan|both }〕※1
〔 set info_message_out= nosuppress|suppress 〕
〔 set except_suppress=メッセージ番号〔,メッセージ番号〕…〕
〔 set int_trc_lvl=稼働トレース取得レベル〔,稼働トレース取得範囲〕〕
〔 set int_trc_filesz=稼働トレースファイルのサイズ 〕
〔 set int_trc_rintvl=稼働トレース情報取得間隔 〕
〔 set sendprocnum=送信プロセス最大起動数 〕
〔 set smt_sendintvl=送信マスタプロセス送信間隔 〕
〔 set smt_sendintvl_scale= minute|second 〕
〔 set smt_editbufsize=更新情報編集バッファ長 〕
〔 set smt_readbufnum=更新情報読み込み用I/Oバッファ数 〕
〔 set smt_queue_read_wait_interval=送信プロセスの抽出情報キューファイル読み込み間隔 〕
〔 set file_dupenv=二重化定義ファイル名 〕
〔 set nodecontrol= unit|server 〕※2
〔 set node_connection_accept= true|false 〕※1
〔 set connection_accept_hostname=抽出ノードマスタプロセス接続要求受け付けホスト名 〕※1
〔 set connection_accept_service=抽出ノードマスタプロセス接続要求受け付けサービス名 〕※1
〔 set connection_accept_waittime=抽出ノードマスタプロセス接続要求待ち時間 〕※1
〔 set connection_retry_time=抽出ノードマスタプロセス再接続処理時間 〕※1
set oracleusr=データ連動リソース管理ユーザ名 /パスワード※3
〔 set oracle_maxextcol=抽出可能最大列数 〕※3
〔 set oracle_msgkeeptime=DEQUEUE後のアドバンストキュー内更新情報保存時間 〕※3
〔 set oracle_aq_storage=アドバンストキュー作成時の記憶域パラメタ 〕※3
〔 set oracle_sorttbl_storage=抽出順序管理テーブル記憶域パラメタ 〕※3
〔 set oracle_sortidx= true|false 〕※3
〔 set oracle_sortidx_storage=抽出順序管理テーブルインデクス記憶域パラメタ 〕※3
〔 set node_syslogout= true|false 〕
〔 set send_counter_reset= true|false 〕
〔 set hirdb_audit_trail= all|none 〕
〔 set decimal_max_precision= DECIMAL型の精度の最大値 〕※3
〔 set resource_chk_err= continue|stop 〕
〔 set recover_info_send= true|false 〕※1
〔 set recover_info_send_interval=回復情報送信間隔 〕※1
〔 set cm_errno_check= true|false 〕
-
個別定義部でだけ定義する項目
個別定義部を定義する場合,個別定義部の開始ヘッダに指定するサーバ名には,固定名称「Oracle」を指定してください。
〔 set node_pddir=抽出側HiRDBのPDDIR環境変数の設定値 〕※1
〔 set node_pdconfpath=抽出側HiRDBのPDCONFPATH環境変数の設定値 〕※1
〔 set node_shlibpath=抽出側Oracleのライブラリパス 〕
〔 set node_host=ノードマスタホスト名 〕
- 注※1
-
Datareplicator Extensionを使用する場合は,指定しても無視されます。
- 注※2
-
Datareplicator Extensionではunitだけ指定できます。serverは指定できません。
- 注※3
-
Datareplicator Extension固有のオペランドです。
(3) オペランドの説明
Datareplicator Extension固有のオペランドについて説明します。
-
oracleusr=データ連動リソース管理ユーザ名 /パスワード
OracleからHiRDBへデータ連動する場合のデータ連動リソース管理ユーザ名とパスワードを指定します。
-
データ連動リソース管理ユーザ名
〜〈1〜8文字の識別子〉
OracleからHiRDBへデータ連動する場合のデータ連動リソース管理ユーザ名を指定します。
-
/パスワード
〜〈1〜8文字の記号名称〉
データ連動リソース管理ユーザのパスワードを指定します。
-
-
〜〈符号なし整数〉((7〜500))《50》
抽出対象表当たりの抽出可能最大列数を指定します。抽出可能最大列数は,更新情報に対して次の算出式に従って算出した結果のうち,最も大きい値を指します。
ただし,算出結果が7より小さい値となった場合は,7を指定してください。
- マッピングキー更新あり
-
抽出可能最大列数=4+マッピングキー数+抽出列数
- マッピングキー更新なし
-
抽出可能最大列数=4+抽出列数
抽出定義でこのオペランドの指定値を超える抽出列数の抽出定義文が指定されている場合は,抽出定義プリプロセスファイルの作成処理で定義エラーとなります。
このオペランドの指定値は,更新処理の性能に影響を及ぼすため,できるだけ上記の計算式に従って算出した値を指定することをお勧めします。
なお,同一表に対して複数の更新情報を抽出する場合は,マッピングキー及び抽出列をマージした更新情報として算出してください。
-
oracle_msgkeeptime=DEQUEUE後のアドバンストキュー内更新情報保存時間
〜〈符号なし整数〉((0〜1000))《12》(単位:時間)
アドバンストキューからの取り出し(DEQUEUE)が完了した更新情報の保存時間を指定します。
抽出処理に不正が発生した場合のトラブルシュート情報として,取り出し(DEQUEUE)が完了した後も,更新情報をアドバンストキューに一定時間保存しておくことで,原因の調査に役立てることができます。
ただし,このオペランドの値を大きくすることで,必要となるアドバンストキュー容量も増加するため,ユーザ環境に応じて指定する必要があります。
-
oracle_aq_storage=アドバンストキュー作成時の記憶域パラメタ
初期化時にアドバンストキュー作成のために発行するCREATE_QUEUE_TABLEプロシジャのstorage_clauseオプションに,このオペランドの設定内容を指定することで,アドバンストキュー作成領域をカスタマイズできます。
このオペランドの最大文字数は511文字です。省略すると,storage_clauseオプションなしでCREATE_QUEUE_TABLEプロシジャが実行されます。
このオペランドの指定値については,Oracleのマニュアルを参照してください。
-
oracle_sorttbl_storage=抽出順序管理テーブル記憶域パラメタ
初期化時に抽出順序管理テーブル作成のために発行するCREATE TABLEコマンドのオプションに,このオペランドの設定内容を指定することで,抽出順序管理テーブルの作成領域などをカスタマイズできます。
このオペランドの最大文字数は511文字です。省略すると,オプションなしでCREATE TABLEコマンドが実行されます。
このオペランドの指定値については,Oracleのマニュアルを参照してください。
-
抽出順序管理テーブルに対してインデクスを作成するかどうかを指定します。
抽出順序管理テーブルに対してインデクスを作成すると,抽出処理の性能は向上しますが,更新APの性能が低下する場合があります。
- true
-
抽出順序管理テーブルに対してインデクスを作成します。
- false
-
抽出順序管理テーブルに対してインデクスを作成しません。
-
oracle_sortidx_storage=抽出順序管理テーブルインデクス記憶域パラメタ
抽出順序管理テーブルに対するインデクス作成のために発行するCREATE INDEXコマンドのオプションに,このオペランドの設定内容を指定することで,インデクスの作成領域などをカスタマイズできます。
このオペランドの最大文字数は511文字です。省略すると,オプションなしでCREATE INDEXコマンドが実行されます。
このオペランドの指定値については,Oracleのマニュアルを参照してください。
-
decimal_max_precision=DECIMAL型の精度の最大値
〜((29〜38))《29》
抽出時にDECIMAL型として抽出するNUMBER,DECIMAL,NUMERICの精度の最大値を指定します。
38より大きな値を指定した場合は定義エラーとなります。
このオペランドで指定した精度より大きな精度のNUMBER列,DECIMAL列,NUMERIC列は,FLOAT型として抽出します。詳細を次の表に示します。
表5‒1 DECIMAL型の精度の最大値と抽出データ属性の対応 指定分類
抽出対象表のデータ型
m,nの値
反映対象表のデータ型
精度及び位取りの指定なし
NUMBER
−
FLOAT
DECIMAL
NUMERIC
INTEGER
精度だけ指定
NUMBER(m)
DECIMAL(m)
NUMERIC(m)
m≦4
SMALLINT
5≦m≦9
INTEGER
10≦m≦p
[LARGE] DECIMAL(m)
上記以外
FLOAT
精度及び位取りを指定
NUMBER(m,n)
DECIMAL(m,n)
NUMERIC(m,n)
次のどれかの条件を満たす場合
m≧p+1
n≧p+1
m-n≧p+1
FLOAT
次のすべての条件を満たす場合
m<n
m<p+1
n<p+1
m-n<p+1
[LARGE] DECIMAL(n,n)
次のすべての条件を満たす場合
n<0
m<p+1
m-n<p+1
[LARGE] DECIMAL(m-n,0)
上記以外
[LARGE] DECIMAL(m,n)
-
node_shlibpath=抽出側Oracleのライブラリパス
〜〈1〜255バイトのパス名〉
ライブラリパスを指定するOracle用環境変数に256バイト以上の値を指定した場合,抽出側Datareplicator Extensionは指定値不正エラーとなります。256バイト以上の値を指定する必要がある場合には,このオペランドに,255バイト以内で抽出側Datareplicator Extensionに必要なライブラリパスだけを指定してください。
このオペランドを指定することで,環境変数の指定値不正エラーが発生しなくなります。将来,環境変数の指定値が256バイト以上になることが予想される場合には,初期構築時にこのオペランドを指定しておくことをお勧めします。
なお,このオペランドの指定値を有効にするためには,抽出側Datareplicator Extensionを初期化してください。