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文字の記号名称〉

    データ連動リソース管理ユーザのパスワードを指定します。

• oracle_maxextcol＝抽出可能最大列数

  　　〜〈符号なし整数〉((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のマニュアルを参照してください。

• oracle_sortidx＝ true｜false

  抽出順序管理テーブルに対してインデクスを作成するかどうかを指定します。

  抽出順序管理テーブルに対してインデクスを作成すると，抽出処理の性能は向上しますが，更新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)

  （凡例）

  −：依存しません。

  m：精度を示します。

  n：位取りを示します。

  p：decimal_max_precisionに指定した値を示します。

• node_shlibpath＝抽出側Oracleのライブラリパス

  　　〜〈1〜255バイトのパス名〉

  ライブラリパスを指定するOracle用環境変数に256バイト以上の値を指定した場合，抽出側Datareplicator Extensionは指定値不正エラーとなります。256バイト以上の値を指定する必要がある場合には，このオペランドに，255バイト以内で抽出側Datareplicator Extensionに必要なライブラリパスだけを指定してください。

  このオペランドを指定することで，環境変数の指定値不正エラーが発生しなくなります。将来，環境変数の指定値が256バイト以上になることが予想される場合には，初期構築時にこのオペランドを指定しておくことをお勧めします。

  なお，このオペランドの指定値を有効にするためには，抽出側Datareplicator Extensionを初期化してください。

ページの先頭へ