17.2.2 インポートオプションの形式
- 〈この項の構成〉
(1) 指定形式
論理エラーデータの出力に関するオプション
〔set adb_import_errdata_file_name = 論理エラーデータファイル名〕
〔set adb_import_errdata_num = 論理エラーデータの出力件数の上限〕
〔set adb_import_errmsg_lv = {0|1}〕
性能に関するオプション
〔set adb_import_rthd_num = adbimportコマンドが使用する処理リアルスレッド数〕
〔set adb_import_read_size = バッファサイズ〕
〔set adb_import_buff_blk_num = バッファブロック数〕
〔set adb_import_sort_buff_size = ソートバッファサイズ〕
〔set adb_import_dividx_rd_buff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ〕
〔set adb_import_dividx_wt_buff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ〕
〔set adb_import_txt_buff_size = テキストインデクスの作成用バッファサイズ〕
〔set adb_import_decompress_buff_size = GZIP形式で圧縮した入力データファイルの伸長用バッファサイズ〕
〔set adb_import_dvbix_rthd_use = {FIXED|VARIABLE}〕
入力データに関するオプション
〔set adb_import_null_string = {DEFAULT|NULL}〕
上記のインポートオプションの指定規則は,サーバ定義と同じです。サーバ定義の指定規則については,マニュアルHADB システム構築・運用ガイドのサーバ定義の文法規則を参照してください。
(2) 指定形式の説明
(a) 論理エラーデータの出力に関するオプション
- ●adb_import_errdata_file_name = 論理エラーデータファイル名
-
〜〈OSパス名〉((2〜510バイト))
論理エラーデータファイルのファイル名を絶対パス名で指定します。論理エラーデータファイルには,入力データの論理エラーが発生した行データが出力されます。
このオプションを省略した場合,論理エラーが発生した行データはファイルに出力されません。
なお,論理エラーデータファイル名は,ほかのファイル名と重複しないようにしてください。重複した場合,ファイル中のデータが失われるおそれがあります。論理エラーデータファイル名と重複しないようにする必要があるファイルについては,「17.11 注意事項」を参照してください。
- ●adb_import_errdata_num = 論理エラーデータの出力件数の上限
-
〜〈整数〉((1〜4,294,967,295))《100》
論理エラーデータファイルに出力する論理エラーデータの出力件数の上限を指定します。例えば,このオプションに200を指定した場合,201個目以降の論理エラーデータはファイルに出力されません。
なお,論理エラーデータの個数が,このオプションの指定値を超えても,インポート処理は続行されます。
- ●adb_import_errmsg_lv = {0|1}
-
論理エラーの発生時,論理エラーの原因を示すメッセージを出力するかどうかを指定します。
0:メッセージを出力します。
1:メッセージを出力しません。
このオプションを省略した場合,0が仮定されるため,論理エラーの原因を示すメッセージが出力されます。
1つの論理エラーに対して1つのメッセージが出力されます。そのため,論理エラーが多い場合,出力されるメッセージの数も多くなります。
上記で説明した論理エラーデータの出力に関するオプションは,次の表を参考にして指定してください。
項番 |
ケース |
関連するインポートオプション |
説明 |
---|---|---|---|
1 |
論理エラーデータを修正し,修正したデータをインポートする場合 |
|
左記に示すオプションを指定して,論理エラーデータを論理エラーデータファイルに出力してください。 |
2 |
論理エラーデータは必要ない場合(データを修正してインポートする必要がない場合) |
|
左記に示すようにオプションを指定して,論理エラーデータに関する情報の出力を抑止してください。 論理エラーデータが大量にある場合,論理エラーデータに関する情報が大量に出力され性能に影響を及ぼすことがあります。そのため,左記のようにインポートオプションを指定して,論理エラーデータに関する情報の出力を抑止します。 |
3 |
論理エラーデータがあるときに,インポートを中断する場合 |
インポートオプションを指定する必要はありません。 |
adbimportコマンドの実行時,-eオプションを指定してください。論理エラーデータが検出された場合,インポートが中断され,トランザクションはロールバックします(入力データは1件もインポートされません)。このとき,リターンコード8が返されます。 -eオプションについては,「17.2.1 指定形式およびオプションの説明」の「(3) オプションの説明」の「-e」オプションを参照してください。 |
(b) 性能に関するオプション
- ●adb_import_rthd_num = adbimportコマンドが使用する処理リアルスレッド数
-
〜〈整数〉((2〜4,096))
adbimportコマンド実行時に使用する処理リアルスレッド数を指定します。
このオプションは,指定を推奨するオプションです。adbimportコマンドは,このオプションで指定した値の処理リアルスレッド数を使用します。このため,adbimportコマンドで使用したい処理リアルスレッド数に応じて,このオプションに適切な値を指定してください。adbimportコマンドが処理リアルスレッドを使用する処理,および各処理で使用する処理リアルスレッド数については,「17.1.3 adbimportコマンドが使用するスレッドの関係」を参照してください。
このオプションを省略した場合,adbimportコマンド実行時に使用する処理リアルスレッド数は,サーバ定義adb_sql_exe_max_rthd_numオペランドによって決まります。このオプションまたはサーバ定義adb_sql_exe_max_rthd_numオペランドの指定値と,コマンド実行時に使用する処理リアルスレッド数の関係を次の表に示します。
表17‒5 コマンド実行時に使用する処理リアルスレッド数 項番
このオプションまたはサーバ定義の値
コマンド実行時に使用する処理リアルスレッド数
1
このオプションの指定を省略した場合
サーバ定義adb_sql_exe_max_rthd_numオペランドの指定を省略した場合
サーバ定義adb_sql_exe_max_rthd_numオペランドのデフォルト値を使用します。
2
サーバ定義adb_sql_exe_max_rthd_numオペランドに0または1を指定した場合
-
3
サーバ定義adb_sql_exe_max_rthd_numオペランドに2以上の値を指定した場合
サーバ定義adb_sql_exe_max_rthd_numオペランドに指定した値を使用します。
4
このオプションに2以上の値を指定した場合
このオプションに指定した値を使用します。
- (凡例)
-
-:adbimportコマンドがエラーとなります。
- 注
-
サーバ定義adb_sql_exe_max_rthd_numオペランドの詳細については,マニュアルHADB システム構築・運用ガイドの性能に関するオペランド(set形式)を参照してください。
- 重要
-
バックグラウンドインポートを実行する場合,adb_import_rthd_numの指定値によってデータの格納効率が変わることがあります。データの格納効率を良くするadb_import_rthd_numの指定値の求め方については,マニュアルHADB システム構築・運用ガイドのマルチチャンク表にデータを格納する方法(バックグラウンドインポート)を参照してください。
- ●adb_import_read_size = バッファサイズ
-
〜〈整数〉((32〜51,200))《1,024》(単位:キロバイト)
入力データファイルの読み込み処理で使用するバッファのサイズをキロバイト単位で指定します。次に示す値を目安としてください。
(インポートデータのレコード件数×1行当たりの入力データ長)÷10,000
- ●adb_import_buff_blk_num = バッファブロック数
-
〜〈整数〉((5〜4,096))《64》
データインポート処理で使用するバッファのブロック数を指定します。
基本的にはデフォルト値のままで問題ありませんが,このオプションの指定値を大きくすると,データインポート処理の性能が向上することがあります。
- ●adb_import_sort_buff_size = ソートバッファサイズ
-
〜〈整数〉((1〜2,048))《256》(単位:メガバイト)
インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に,このオプションの指定を検討してください。このオプションには,B-treeインデクスおよびテキストインデクスの作成処理時に使用するソートバッファサイズをメガバイト単位で指定します。
メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。
- ●adb_import_dividx_rd_buff_size = B-treeインデクスとテキストインデクスの入力バッファサイズ
-
〜〈整数〉((32〜51,200))《1,024》(単位:キロバイト)
インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に,このオプションの指定を検討してください。
このオプションには,B-treeインデクスおよびテキストインデクスの作成処理時に使用する入力バッファサイズをキロバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。
- ●adb_import_dividx_wt_buff_size = B-treeインデクスとテキストインデクスの出力バッファサイズ
-
〜〈整数〉((32〜51,200))《1,024》(単位:キロバイト)
インポート対象表にB-treeインデクスまたはテキストインデクスが定義されている場合に,このオプションの指定を検討してください。
このオプションには,B-treeインデクスおよびテキストインデクスの作成処理時に使用する出力バッファサイズをキロバイト単位で指定します。メモリに余裕がある場合は指定値を大きくしてください。指定値を大きくするほど性能向上が見込めます。
- ●adb_import_txt_buff_size = テキストインデクスの作成用バッファサイズ
-
〜〈整数〉((1〜2,048))《256》(単位:メガバイト)
インポート対象表にテキストインデクスが定義されている場合に,このオプションの指定を検討してください。
このオプションには,テキストインデクスの作成処理時に使用するバッファサイズをメガバイト単位で指定します。
このオプションの指定値を大きくすると性能向上が見込めます。ただし,テキストインデクスを作成する全処理リアルスレッドで,このオプションで指定したバッファ分のメモリを使用します。このため,このオプションの指定値を大きくするときは注意してください。
- ●adb_import_decompress_buff_size = GZIP形式で圧縮した入力データファイルの伸長用バッファサイズ
-
〜〈整数〉((32〜51,200))《1,024》(単位:キロバイト)
このオプションには,GZIP形式で圧縮した入力データファイルのデータ伸長時に使用するバッファサイズをキロバイト単位で指定します。
インポートオプションadb_import_read_sizeに指定した値を,このオプションの指定値の目安としてください。
GZIP形式で圧縮した入力データファイルのデータをインポートする際,このオプションに指定した分だけ,圧縮したデータを伸長するためのバッファを使用します。
- ●adb_import_dvbix_rthd_use = {FIXED|VARIABLE}
-
〜《サーバ定義adb_cmd_dvbix_rthd_useオペランドの値》
インポート対象表にB-treeインデクスが定義されている場合に,このオプションの指定を検討してください。
このオプションには,B-treeインデクスを作成する際,B-treeインデクス作成用スレッド数の調整機能を有効にするかどうかを指定します。B-treeインデクス作成用スレッド数の調整機能については,「17.1.2 adbimportコマンドのオプション機能」の「(4) B-treeインデクス作成用スレッド数の調整機能」を参照してください。
- FIXED:B-treeインデクス作成用スレッド数の調整機能を有効にしません。
-
B-treeインデクスの作成処理は,使用可能な処理リアルスレッドを最大限に使用して,並列に処理されます。B-treeインデクスのデータの格納効率よりも,B-treeインデクスの作成処理時間の短縮を優先する場合に指定してください。
使用される処理リアルスレッド数は,「adb_import_rthd_numオプションの指定値※ - 1」になります。
- 注※
-
adb_import_rthd_numオプションの指定を省略した場合は,「表17‒5 コマンド実行時に使用する処理リアルスレッド数」に従ってadb_import_rthd_numオプションの値が決まります。
- VARIABLE:B-treeインデクス作成用スレッド数の調整機能を有効にします。
-
B-treeインデクスの作成処理は,データのサイズや件数などに応じて,使用される処理リアルスレッド数を変更して処理されます。B-treeインデクスの作成処理時間の短縮よりも,B-treeインデクスのデータの格納効率を優先する場合に指定してください。
使用される処理リアルスレッド数は,「1」または「このオプションにFIXEDを指定したときに使用される処理リアルスレッド数」のどちらかになります。
B-treeインデクス作成用スレッド数の調整機能は,次の条件下で有効になります。
-
作成モードでデータインポートを実行する場合(-dオプションを指定する場合)
-
バックグラウンドインポートを実行する場合(-bオプションを指定する場合)
-
データ格納件数が0件の表に対して-dオプションを省略してデータインポートを実行する場合
CREATE TABLE文で表を定義した直後,またはTRUNCATE TABLE文で表の全データを削除した直後のデータインポートが該当します。
上記以外では,このオプションにVARIABLEを指定してもB-treeインデクス作成用スレッド数の調整機能は有効になりません。
-
(c) 入力データに関するオプション
- ●adb_import_null_string = {DEFAULT|NULL}
-
表定義時にDEFAULT句を指定した列に格納する入力データが空文字列の場合に,列の既定値を格納するか,またはナル値を格納するかを指定します。
- DEFAULT:
-
列の既定値が格納されます。列の既定値については,次に示す項目を参照してください。
-
マニュアルHADB SQLリファレンスの構成要素のDEFAULT句のDEFAULT句の指定形式および規則
-
マニュアルHADB システム構築・運用ガイドのデータベースの設計の表の設計の列の既定値の設定(DEFAULT句)
-
- NULL:
-
ナル値が格納されます。
このオプションを省略した場合,DEFAULTが仮定されるため,入力データが空文字列のときは列の既定値が格納されます。
入力データに空文字列を指定する方法については,「17.5.3 フィールドデータの記述形式(CSV形式)」または「17.6.3 フィールドデータの記述形式(固定長形式)」を参照してください。