4.2.4　xtrepコマンドで指定するファイルの内容

(1)　列名記述ファイル

列名記述ファイルには，SELECT文の選択式を指定します。

SELECT文での選択式の指定方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

注意事項

• 列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲みます。

• 列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲みます。引用符（"）で囲まない場合は，すべて英大文字として扱われます。

• SGMLTEXT型，XML型，またはFREEWORD型の列の抽出をする場合は，抽象データ型関数のextractsを指定してください。

抽象データ型関数extractsの指定形式を次に示します。

形式

ｅｘｔｒａｃｔｓ（列名）

ページの先頭へ

(2)　表式記述ファイル

表式記述ファイルは，XTSQL環境変数の値によって指定できるSQL構文が変わります。

• 環境変数XTSQLが0または省略時，SELECT文の次の句を指定します。

  ・WHERE句

  ・ORDER BY句

• 環境変数XTSQLが1の場合，SELECT文のFROM句以降の構文を指定します。

SELECT文の指定方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

注意事項

• 表式の指定値にスペース，ハイフン（−）を含むときは，引用符（"）で囲みます。

• 表式の指定値の英小文字と英大文字とを区別したい場合は，引用符（"）で囲みます。引用符（"）で囲まない場合は，すべて英大文字として扱われます。

• 表式記述ファイルで指定可能なデータ型の組み合わせについては，「表3-7　HiRDB Dataextractorで変換および比較できるデータ型」を参照してください。

• ORDER BY句を指定する場合，抽出時に属性，文字コード変換をすると，反映側システム上での並び順と異なることがあるため注意してください。

ページの先頭へ

(3)　ナル値情報ファイル

ナル値情報ファイルは，次のときに指定します。

• ナル値の既定値を変更するとき

  反映対象の列にナル値を格納する場合に，ナル値とみなす値を変更したいときに指定します。抽出したデータと，ここでの指定で設定した値が同じ場合に，表の列にナル値が格納されます。

  また，ファイル作成の場合には，抽出データのナル値をどのような既定値としてファイルに格納するかを指定します。

  ナル値情報ファイルを省略（−vオプション省略）した場合のナル値の既定値，およびナル値情報ファイルの指定値によって設定されるナル値の既定値を，「表4-11　ナル値の既定値」に示します。

• 繰返し列をファイルに格納する場合のデータ形式およびナル値反映方法を指定するとき

  繰返し列でのデータ形式およびナル値反映方法の指定の詳細については，「3.1.1(6)繰返し列の抽出」を参照してください。

形式

｛列名｜フィールド番号＝ＮＵＭ｝
　　〔＝｛ＨＩＧＨ｜ＬＯＷ｜ＺＥＲＯ｜ＳＰＡＣＥ｜（’定数値’）｜
　　　　　（X’１６進定数値’）｝〕
　　　〔，ＡＲＲＡＹ＝｛ＦＦ｜ＦＶ｜ＶＶ｝〔，ＮＵＬＬＥＬＭ＝｛Ｃ｜Ｅ｝〕〕
　　〔，｛ＮＯＣＯＤＥＣＯＮＶ｜ＣＯＤＥＣＯＮＶ｝〕

説明

●列名

ナル値の既定値を変更する列を指定します。

• HiRDBの表に反映する場合

  反映側の表の列名で指定してください。

• ファイルだけを作成する場合

  抽出側の表の列名で指定してください。

●フィールド番号＝NUM　

ナル値の既定値を変更する列の先頭からの通番を指定します。指定値範囲は1〜99,999です。

HiRDBの表に反映する場合

反映表の定義上の先頭からの通番を指定してください。

ファイルだけを作成する場合

• −ｓオプション指定なし

  抽出表の定義上の先頭からの通番を指定してください。

• −ｓオプション指定あり

  列名記述ファイルに指定した列名の先頭からの通番を指定してください。

●｛ＨＩＧＨ｜ＬＯＷ｜ＺＥＲＯ｜ＳＰＡＣＥ｜（’定数値’）｜（X’１６進定数値’）｝

ナル値の既定値を指定します。

ここでの指定によって設定される値については，「表4-11　ナル値の既定値」を参照してください。

●ＡＲＲＡＹ＝｛ＦＦ｜ＦＶ｜ＶＶ｝

繰返し列をファイルに格納する場合の，データの形式を指定します。

ARRAYとNULLELMの指定値の組み合わせ可否については，「表4-12　ARRAYとNULLELMの組み合わせ可否」を参照してください。

ＦＦ：列の先頭に要素数がなく，列の要素すべてにデータがある形式。

ＦＶ：列の先頭に要素数があり，列の要素すべてにデータがある形式。

ＶＶ：列の先頭に要素数があり，要素数分のデータがある形式。

●ＮＵＬＬＥＬＭ＝｛Ｃ｜Ｅ｝

繰返し列をファイルに格納する場合に，要素すべてがナル値のときのナル値の設定方法（ナル値反映方法）を指定します。

ARRAYとNULLELMの指定値の組み合わせ可否については，「表4-12　ARRAYとNULLELMの組み合わせ可否」を参照してください。

Ｃ：要素全体にデータがないとき，列全体をナル値として反映します。

Ｅ：要素全体にデータがないとき，各要素をナル値として反映します。

●｛ＮＯＣＯＤＥＣＯＮＶ｜ＣＯＤＥＣＯＮＶ｝

列単位にコード変換の有無を指定します。

ＮＯＣＯＤＥＣＯＮＶ：文字コード変換機能を使わない場合に指定します。この指定値は，環境変数XTLOCALE，またはXTDATALOCALEを指定してコード変換を行う場合だけ有効となります。

ＣＯＤＥＣＯＮＶ：文字コード変換機能を使う場合に指定します。この指定値は，環境変数XTLOCALE，またはXTDATALOCALEを指定してコード変換を行う場合だけ有効となります。

注意事項

• 次の条件をすべて満たす場合は，SGMLTEXT型の列に対して，必ずこの指定値を指定してください。指定しない場合は，SGMLTEXT型は文字コード変換対象となりません。

  ・文字コード変換を行う。

  ・データを抽出し，ファイルだけを作成する（HiRDBに反映しない）。

  ・抽出するデータにSGMLTEXT型が含まれる。

• 文字集合列で，かつ環境変数XTCSETUSEにyesを指定した場合，文字コード変換対象となりません。文字集合列を文字コード変換対象にするためには，次の条件をすべて満たす必要があります。

  ・すべての文字列が文字集合である。

  ・すべての文字列にCODECONVを指定する。

  ・抽出側の環境変数XTDATALOCALEにutf-16BEを指定する。

記述規則

• 1行に一つの列について記述します。複数列分記述したい場合は，複数行記述してください。

• 注釈は，"＃"以降その行の終わりまでとします。

• 列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲んでください。

• 列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲んでください。

• 引用符（"）で囲まない場合は，すべて英大文字として扱われます。

• 定数値を指定する場合は，255バイト以下で指定してください。

• 定数値中に「’）」は指定しないでください（アポストロフィ「’」と右括弧「）」は連続して指定しないでください）。

• HiRDBの表へ反映する場合，反映側の列が非NULL属性のときは，ナル既定値がそのままデータとして格納されます。

• ファイルの作成時，抽出側の列が非NULL属性のときは，指定を無視します。

• 抽象データ型の列は，列単位のコード変換の有無（NOCODECONVまたはCODECONV）以外は指定できません。

• XML型の列にCODECONVは指定できません。

• 反映情報ファイルにXMLを指定した列には，CODECONVを指定できません。

• 繰返し列のデータ形式およびナル値反映方法の指定時の注意事項については，「3.1.1(6)繰返し列の抽出」を参照してください。

• ナル既定値はコード変換を行わないため，バイナリファイル出力を行う場合は反映側の文字コードで定数を指定します。

• 次のデータ型の変換を行う場合，文字コード変換を行わないため，変換が必要なときは，CODECONVを指定します。

  ・(VAR)CHAR → BINARY

  ・M(VAR)CHAR → BINARY

• 数値属性に16進定数を指定する場合は，反映側のエンディアン表現で指定します。

• FLT，SFLT属性に16進定数を指定する場合はIEEE浮動小数点規格の範囲で指定します。

• DATファイルを作成する場合，ARRAYにFVは指定できません。

• 対象の表に可変長文字列を含む場合，この環境変数にFF，FVは指定できません。

• バイナリファイル，DATファイルを作成する場合，NULLEMは指定できません。

• 通常列にARRAY，NULLEMを指定することはできません。

注意事項

• FLT，SFLT属性に16進定数を指定した場合，ナル値を正しく反映させるため，HiRDB Dataextractorが値を補正するときがあります。

• 環境変数XTNLDFLTの指定によって，ナル値情報ファイルの指定規則が異なります。環境変数XTNLDFLTの指定によるナル値情報ファイルの指定規則については，「表4-13　ナル値情報ファイルの指定規則（HiRDBからのデータ抽出の場合）」を参照してください。また，環境変数XTNLDFLTの指定値と，仮定するナル既定値の関係については「表4-14　環境変数XTNLDFLTの指定値と仮定するナル既定値の関係」を参照してください。

記述例

CLM01=HIGH                        #INT
CLM02=LOW                         #DATE
CLM03=('FFFF')                    #CHAR(4)
CLM04=SPACE,ARRAY=FV,NULLELM=E    #CHAR(4)
CLM05, NOCODECONV
CLM06=(X'A4A2')

（凡例）

—：指定できません。

注※1

値0は，符号部（C：正符号）付きを示します。

注※2

−1.7976931348623157e＋308

注※3

1.7976931348623157e＋308

注※4

−3.4028234663852886e＋38

注※5

3.4028234663852886e＋38

注※6

文字コードにかかわらず，空白はX'8140'，’＃’はX'8194'とします。

注※7

小数けたは定義によって0〜6けたになります。

表4‒12　ARRAYとNULLELMの組み合わせ可否

機能		指定値		指定可否	処理
抽出側	反映側	ARRAY	NULLELM
HiRDB	HiRDB	FF	−	○	続行
			C
			E
		FV	−	○	続行
			C	×	エラー
			E
		VV	−	○	続行
			C	×	エラー
			E
	バイナリファイル	FF	−	○	続行
			C	×	エラー
			E
		FV	−	○	続行
			C	×	エラー
			E
		VV	−	○	続行
			C	×	エラー
			E
	DATファイル	FF	−	○	続行
			C	×	エラー
			E
		FV	−	×	エラー
			C
			E
		VV	−	○	続行
			C	×	エラー
			E

（凡例）

−：指定値はありません。

○：指定できます。

×：指定できません。

表4‒13　ナル値情報ファイルの指定規則（HiRDBからのデータ抽出の場合）

ナル値情報ファイル 指定内容		環境変数XTNLDFLTの指定値
		0または1			2
		HiRDB反映	ファイル作成		HiRDB反映	ファイル作成
			バイナリ 形式	DAT形式		バイナリ 形式	DAT形式
列名｜フィールド番号=NUM		◎	◎	◎	◎	◎	◎
ナル値の既定値		○	○	○	×	×	×
ARRAY=	FF	○	○	○	×	×	○
	FV	○	○	×	×	×	×
	VV	○	○	○	×	×	○
NULLELM={C｜E}		○	×	×	×	×	×
NOCODECONV｜CODECONV		○	○	○	○	○	○

（凡例）

◎：必ず指定してください。

○：指定できます。

×：指定できません。

表4‒14　環境変数XTNLDFLTの指定値と仮定するナル既定値の関係

データ型	−vオプション省略時仮定値
	環境変数XTNLDFLTの指定値
	0	1
INTEGER	−2147483648	同左
SMALLINT	−32768	同左
DECIMAL	−99…99	X'FF…FF'
FLOAT	−1.7976931348623157e＋308	同左
SMALLFLT	−3.4028234663852886e＋38	同左
CHAR(n) VARCHAR(n) MCHAR(n) MVARCHAR(n)	n≦4のとき nバイトの‘#‘ n>4のとき 4バイトの‘#‘	同左
NCHAR(n) NVARCHAR(n)	n≦2のとき n文字の‘#‘（全角） n>2のとき 2文字の‘#‘（全角）	同左
DATE	0001年01月01日	X'FFFFFFFF'
INTERVAL YEAR TO DAY	−9999年11月99日間	X'FFFFFFFFFF'
TIME	00時00分00秒	X'FFFFFF'
INTERVAL HOUR TO SECOND	−99時間59分59秒間	X'FFFFFFFF'
BLOB	XTNL0	同左
BINARY(n)	n＜128のとき X'00…00'　(nバイト) n≧128のとき X'00…00'　(127バイト)	同左
TIMESTAMP(n)	0001年01月01日00時00分00.000000秒※	X'FF…FF' (7＋(N)÷2バイト)

注※

小数けたは定義によって0〜6けたになります。

ページの先頭へ

(4)　出力ファイル

出力ファイルは抽出したデータを格納するファイルです。

HiRDB Dataextractorが抽出したデータを出力ファイルへ格納するときの記述形式について説明します。出力ファイルでの記述形式は，HiRDBのデータベース作成ユティリティの入力ファイルの形式を基にしています。

出力ファイルには，次の二つの形式があります。

• バイナリ形式

• DAT形式

ページの先頭へ

(5)　反映情報ファイル

反映情報ファイルには，データ型を変換する列情報とデータ型を指定します。

反映情報ファイルは，次の場合に指定します。

• 抽出データをファイルにだけ格納する場合

  指定したデータ型でデータをファイルに出力します。反映情報ファイルを省略（−Lオプション省略）した場合の列，およびデータ型を指定しない列に対しては，抽出列のデータ型を格納時のデータ型として仮定します。

• 次のデータ型を抽出し，反映またはファイルに格納する場合

  • BLOB

  • BINARY

  • SGMLTEXT

  • XML

  列単位に最大データ長を指定します。これによって，指定された長さのバッファを使用するためにバッファを節約できます。反映情報ファイルを省略（−Lオプション省略），またはデータ型を指定しない列に対するバッファサイズは環境変数XTLOBBUFSIZEに従います。

形式

ＦＯＲＭＡＴ
　｛ＦＩＥＬＤ＿ＮＵＭ　フィールド番号｜ＦＩＥＬＤ＿ＮＡＭＥ　列名｝ＡＴＴＲ　データ型
　　　　〔｛ＦＩＥＬＤ＿ＮＵＭ　フィールド番号｜ＦＩＥＬＤ＿ＮＡＭＥ｝ＡＴＴＲ　データ型〕…

説明

●ＦＯＲＭＡＴ

データ型を変換することを示します。

●ＦＩＥＬＤ＿ＮＵＭ

データ型変換の対象とする抽出列の先頭からの通番を指定します。

• −sオプション指定なしの場合

  抽出表の定義上の先頭からの通番。

• −sオプション指定ありの場合

  列名記述ファイルに指定した列名の先頭からの通番。

指定値範囲は1〜99,999です。フィールド番号は重複して指定できません。

●ＦＩＥＬＤ＿ＮＡＭＥ

データ型変換の対象とする抽出列名を指定します。

−sオプション指定時は指定できないので，FIELD_NUMを指定してください。

列名は重複して指定できません。

●ＡＴＴＲ

データ型を指定します。

指定可能なデータ型を次の表に示します。

注意事項

• 1行に一つの列について記述してください。複数列分記述したい場合は，複数行記述してください。

• 注釈は，"#"以降から，その行の終わりまでとします。

• 列名にスペース，ハイフン（−）を含むときは，引用符（"）で囲んでください。

• 列名の英小文字と英大文字とを区別したい場合は，引用符（"）で囲んでください。

  引用符（"）で囲まない場合は，すべて英大文字として扱われます。

• 抽出データを反映する場合，反映情報ファイルでのバッファサイズが反映側のBLOBデータ型の定義長より大きいときは，この指定を無効とし，BLOB列定義長のバッファを使用します。

（凡例）

○：指定できます。

×：指定できません（指定を無視し，反映側のデータ型を仮定します）。

注※1

指定できるデータ型の組み合わせについては，「表3-7　HiRDB Dataextractorで変換および比較できるデータ型」を参照してください。

注※2

mおよびnは，1≦m≦38，0≦n≦38，m≧nです。

注※3

nは，バイト数を符号なし整数を指定します。指定値範囲は1≦n≦32,767です。

注※4

nは，文字数を符号なし整数を指定します。指定値範囲は1≦n≦16,383です。

注※5

この指定値長は，環境変数XTLOBBUFSIZEと同等の意味があり，環境変数XTLOBBUFSIZEの指定値よりも優先されます。また，指定値の指定範囲と実際の最大長を次に示します。

単位	nの指定範囲	実際のサイズ（バイト）
なし	1≦n≦2,147,483,647	同左
K	1≦n≦2,097,152	n×1,024
M	1≦n≦2,048	n×1,048,576
G	1≦n≦2	n×1,073,741,824

ただし，実際の最大長の計算結果が2,147,483,648の場合は，2,147,483,647になります。

注※6

環境変数XTLOBBUFSIZEを省略した場合は必ず指定します。指定がない場合，バッファが確保できずにエラー終了することがあります。

注※7

指定した長さが反映側のBLOBデータ型の定義長よりも長い場合，この指定は無効とし，定義長を仮定します。

注※8

nは，バイト数を符号なし整数を指定します。指定値範囲は1≦ｎ≦2,147,483,647です。

注※9

nは，0，2，4，6のどれかになります。

注※10

文字集合列，またはNCHAR属性の文字データをUTF-16で抽出する場合，サイズの変更はできません。

ページの先頭へ

(6)　排他情報ファイル

排他情報ファイルには，データ抽出時の排他情報について指定します。

排他情報ファイルの指定内容を次に示します。

• 環境変数XTSQLが0または省略時

  "LOCK TABLE 表名"以降のLOCK文を指定します。

  形式

  ＩＮ　ＥＸＣＬＵＳＩＶＥ　ＭＯＤＥ　ＮＯＷＡＩＴ

• 環境変数XTSQLが1の場合

  "LOCK TABLE"以降のLOCK文を指定します。

  形式

  表名　ＩＮ　ＥＸＣＬＵＳＩＶＥ　ＭＯＤＥ　ＮＯＷＡＩＴ

実際に発行されるLOCK文

LOCK TABLE 表名 IN EXCLUSIVE MODE NOWAIT

LOCK文の指定方法については，マニュアル「HiRDB SQLリファレンス」を参照してください。

注意事項

指定値の末尾にセミコロン（；）は指定しないでください。

ページの先頭へ