Linkexpress Transactional Replication option説明書

8.2 DBサービス定義の規約

DBサービス定義ファイルおよびDBサービス定義の規約について説明します。

• DBサービス定義ファイルの記述
• DBサービス定義の定義文について
• DBサービス定義ファイルについて

DBサービス定義ファイルの記述例は、"8.1 DBサービス定義機能の使用方法"を参照してください。

また、DB連携定義ツールによりDBサービス定義ファイルを作成できます。
DB連携定義ツールについては、"第7部 DB連携定義ツール"を参照してください。

■DBサービス定義ファイルの記述

DBサービス定義ファイルの記述規約は以下のとおりです。

• 改行記号までを1行とします。

  NAME = INORDER[改行記号]　
  ←―――1行―――→

  
  

• 1行の最大長は、改行記号を除き1024バイトです。

  ITEM = ( …, ( ITEM , char(8) except null field ) ) [改行記号]
  ←1行は改行記号を除き1024バイトまで記述可能→

  
  

• 各定義文は、定義文の種類を示す定義文名と、個々の定義内容を示すオペランドから構成されます。各定義文の最後には、定義文終了記号(半角セミコロン";")が必要です。

  EXTRACT　←定義文名
  　NAME = EXTORDER　←オペランド
  　INTABLE = INORDER　←オペランド
  　SELECT = *　←オペランド
  ;　　← 定義文の最後に定義文終了記号が必要

  
  

• オペランドとは、定義内容の種類を示すキーワードと、キーワードに対応する値から構成される記述です。キーワードと値の間には"="を記述します。

  NAME = INORDER
  ↑　　　　　　↑
  キーワード　値
  ←オペランド→

  
  

• 1行に定義文とオペランドを混在して記述できません。

  正：INTABLE
  　　　　　　NAME = INORDER
  誤：INTABLE NAME = INORDER

  
  

• 1行に記述可能なオペランドは1個です。

  正：NAME = OUTORDER
  　　EXTRACT = EXTORDER
  誤：NAME = INORDER EXTRACT=EXTORDER

  
  

• 値が1個しか指定できないオペランドの場合は、複数行にまたがって記述できません。

  正：NAME = INORDER
  誤：NAME =
  　　　　　　INORDER

  
  

• オペランドに複数の値がある場合、複数行に分けて記述できます。

  ITEM = ( ITEM1 ,
  　　　　　ITEM2 )

  
  

• 行の任意の位置から記述を開始できます。記述位置を揃えるために、半角空白およびタブ記号を使用できます。

  　　　　　　　ITEM = ( ITEM1 ,
  ITEM2 ,[タブ記号]ITEM3 )

  
  

• 行の先頭カラムにコメント記号を記述して、コメント行を作成できます。コメント記号は半角の"#"です。2カラム目以降に"#"を記述した場合、コメント行として扱われません。

  #　この行はコメント行です。
  　　#　この行はコメント行として扱われません。

  
  

• DBサービス定義ファイルの最終行には改行記号が必要です。

  正：　　DATABASE = データベース０１
  　　; [改行記号]
  [ファイルの終端]
  誤：　　DATABASE = データベース０１
  　　; [ファイルの終端]

■DBサービス定義の定義文について

DBサービス定義で使用する定義文には以下があります。

• INTABLE定義文　　：入力データを定義する定義文です。
• EXTRACT定義文　　：入力データのデータ項目の編集方法を定義する定義文です。
• OUTTABLE定義文 　：出力データを定義する定義文です。
• STOREGROUP定義文 ：格納グループを定義する定義文です。

定義文の対応についての規約は、以下のとおりです。

• 1個のDBサービスグループには、最低1個の格納グループの定義(STOREGROUP定義文)が必要です。
• 1個の格納グループには、最低1個のDBサービスが必要です。
• 1個のDBサービスには、INTABLE定義文、EXTRACT定義文、OUTTABLE定義文がそれぞれ1個必要です。
• 各定義文は、1個のDBサービスグループに、それぞれ32000個まで定義可能です。
• 同じ定義文で同じ識別名(NAMEオペランドの指定値)を持つことはできません。たとえば、複数のINTABLE定義文でNAMEオペランドに同じ値を指定した定義はできません。なお、異なる定義文では、同じ識別名を指定できます。
• 複数のDBサービスにおいてINTABLE定義文の入力データ属性が一致する場合、複数のEXTRACT定義文のINTABLEオペランドに同一のINTABLE識別名を指定できます。データベースの対応関係が1対nの場合にDBサービス定義ファイルの記述量を削減できます。

■DBサービス定義ファイルについて

DBサービス定義ファイルのアクセス権は、lxrtmgensvコマンドを実行する利用者の権限で読込み可能となるように設定してください。

DBサービス定義ファイルで使用する文字コード系は、以下のとおりにしてください。

• インストール時に指定したコード系
• シフトJIS

DBサービス定義ファイルで文字コード系としてUTF-8を使用した場合、DBサービス定義ファイルの先頭にUCSを識別するための"印"(しるし)を使わないでください。