フォーマット

構文

FORMAT DEL|IXF|DELIMITED|ASC|DSNTIAUL|XML|MIGRATION|JSON|ORC|PARQUET|EXTERNAL

変数

変数値はありません。

デフォルト

DEL

INTO tablename または qualifier.tablename

特定の表をマイグレーションまたはロードし、この表に明示的な SELECT 要求を指定する場合、INTO オプションを使用して表名を指定できます。 ターゲット表の修飾子および名前がソース表の修飾子および名前と異なる場合、INTO オプションを使用して修飾子および名前を指定できます。 Optim High Performance Unload 対応するLOADコマンドのINTO句から、ソーステーブルのテーブル名と修飾子を使用します。

重要: INTO 節を使用して名前を指定しない場合、ソース表の名前がロード・ファイルで使用されます。

MODIFIED BY 修飾子

FORMAT DEL 節の MODIFIED BY オプションを使用すると、関連する Db2 Load コマンドの生成方法に応じて動作する Db2 Load 修飾子を指定できます。 MODIFIED BY には、FORMAT 節の記述の先頭に示される修飾子が 1 つ以上含まれていなければなりません。 MODIFIED BY オプションの後に、希望する修飾子をスペース区切りのリストにして指定することにより、複数の修飾子を設定することができます。 例:

MODIFIED BY IDENTITYIGNORE GENERATEDMISSING ROWCHANGETIMESTAMPOVERRIDE

DELPRIORITYCHAR

DELPRIORITYCHAR 修飾子は、 Db2 Load コマンドで使用される区切り文字の優先順位を、文字区切り文字、レコード区切り文字、列区切り文字に変更するために使用します。 デフォルトの区切り文字優先順位は、レコード区切り文字、桁区切り文字、列区切り文字です。 この修飾子は、アンロード・データには影響を与えません。生成された LOAD コマンドで報告されるだけです。

FASTPARSE

この修飾子は、アンロードされるデータには影響を与えません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには FASTPARSE 修飾子が含まれます。

DUMPFILE "ファイル名"

この修飾子は、アンロードされるデータには影響を与えません。 指定する値は絶対パスでなければなりません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには DUMPFILE 修飾子が含まれます。

ダンプファイルアクセスオール

この修飾子は、アンロードされるデータには影響を与えません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには DUMPFILEACCESSALL 修飾子が含まれます。

INTO tablename または qualifier.tablename

特定の表をマイグレーションまたはロードし、この表に明示的な SELECT 要求を指定する場合、INTO オプションを使用して表名を指定できます。 ターゲット表の修飾子および名前がソース表の修飾子および名前と異なる場合、INTO オプションを使用して修飾子および名前を指定できます。 Optim High Performance Unload 対応するLOADコマンドのINTO句から、ソーステーブルのテーブル名と修飾子を使用します。

重要: INTO 節を使用して名前を指定しない場合、ソース表の名前がロード・ファイルで使用されます。

制約事項: 複数のデータベース・パーティションを持つターゲット Db2 インスタンスにデータをマイグレーションする場合は、IXF 出力フォーマットを使用できません。 Db2 ロード・ユーティリティーを使用して、IXF ファイルから複数パーティション環境にデータをロードすることはできません。 詳しくは、 Db2 Load ユーティリティーの資料を参照してください。

MODIFIED BY 修飾子

FORMAT IXF 節の MODIFIED BY オプションを使用すると、関連する Db2 Load コマンドが生成される方法で動作する Db2 Load 修飾子を指定できます。 MODIFIED BY には、FORMAT 節の記述の先頭に示される修飾子、または以下のリストで示す修飾子が 1 つ以上含まれていなければなりません。 MODIFIED BY オプションの後に、希望する修飾子をスペース区切りのリストにして指定することにより、複数の修飾子を設定することができます。 例:

MODIFIED BY IDENTITYIGNORE GENERATEDMISSING ROWCHANGETIMESTAMPOVERRIDE

FORCEIN

この修飾子は、アンロードされるデータには影響を与えません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには FORCEIN 修飾子が含まれます。

NOCHECKLENGTHS

この修飾子は、アンロードされるデータには影響を与えません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには NOCHECKLENGTHS 修飾子が含まれます。

DELIMITED INTO tablename|qualifier.tablename 
MODIFIED BY modifiers NULL DELIM NULLVAL "value"

DELIMITED INTO tablename|qualifier.tablename SEP|COLDEL 
'char' DELIM|CHARDEL 'char' NULL DELIM NULLVAL "value"

ASC フォーマットでは、以下のオプションを使用します。

INTO tablename または qualifier.tablename

LOADFILE オプションを使用していて、ターゲット表の名前つまり qualifier.tablename を変更する必要がある場合は、LOAD ファイルで使用する新規名を以下のように指定できます。

FORMAT ASC INTO qualifier.tablename

例:

GLOBAL CONNECT TO SAMPLE; 
UNLOAD TABLESPACE 
FLUSH BUFFERPOOLS NO 
LOCK NO 
SELECT * FROM EMPLOYEE; 
CCSID(930,300) 
OUTFILE("test.out") LOADFILE("test.load") 
FORMAT ASC INTO DBHPU.EMPLOYEE; 

結果として生成されたロード・ファイル (test.load) は、以下のように表示されます。

LOAD FROM test.out OF ASC 
MODIFIED BY STRIPTBLANKS 
METHOD L (1,6,7,18,19,20,34,36, 38, ...108,118) 
NULL INDICATORS(0,0,0,0,35,... 107) 
INSERT INTO TABLE DBHPU.EMPLOYEE 
(EMPNO,FIRSTNME,MIDINT,LASTNAME,WORKDEPT,...) 

重要: INTO 節を使用して名前を指定しない場合、ロード・ファイルではソース表の名前が使用されます。

MODIFIED BY 修飾子

FORMAT ASC 節の MODIFIED BY オプションを使用すると、関連する Db2 Load コマンドが生成される方法で動作する Db2 Load 修飾子を指定できます。 また、以下のリストにある修飾子 (データのアンロード方法を記述する) も指定できます。 MODIFIED BY には、FORMAT 節の記述の先頭に示される修飾子、または以下のリストで示す修飾子が 1 つ以上含まれていなければなりません。 MODIFIED BY オプションの後に、希望する修飾子をスペース区切りのリストにして指定することにより、複数の修飾子を設定することができます。 例:

MODIFIED BY PACKEDDECIMAL STRIPNULLS

ヒント: MODIFIED BY オプションの機能は、アンロードされたデータ・フォーマットを変更するロード・ファイルを生成せずに使用できます。

BINARYNUMERICS

BINARYNUMERICS 修飾子を使用することで、数値データ (INTEGER、DECFLOAT、および実数データ) をバイナリー・フォーマットでアンロードするように指定できます。 使用されるバイナリー表記は常にビッグ・エンディアン ( Db2 Load で予期されるもの) になります。 デフォルトでは、アンロードで数値データに対してバイナリー・フォーマットを使用することはありません。

BINARYNUMERICS オプションを指定した場合に、LOADFILE オプションも選択されていると、ロード・ファイルの MODIFIED BY 節に BINARYNUMERICS が追加されます。

PACKEDDECIMAL

この修飾子は、10 進データ・タイプをパック表記でアンロードする場合に使用します。 これはデフォルトの振る舞いではありません。

PACKEDDECIMAL を指定し、 LOADFILE オプションも選択した場合、ロード・ファイルの MODIFIED BY 節に PACKEDDECIMAL が追加されます。 この修飾子は、IMPLIEDDECIMAL 修飾子および ZONEDDECIMAL 修飾子と互換性がありません。

DECPLUSBLANK

DECPLUSBLANK を使用することにより、正符号 (+) の代わりに先行符号としてブランク・スペースを使用して、正の 10 進数データをアンロードするかどうかを指定できます。 デフォルトでは、正符号 (+) が使用されます。

STRIPTBLANKS または STRIPTNULLS

対応する相互排他の修飾子 STRIPTBLANKS または STRIPTNULLS を使用して、可変サイズの文字カラムのデータがアンロードされる時に、ブランク文字で埋め込むか、ヌル文字で埋め込むかを指定できます。

デフォルトでは、埋め込み文字はブランク (STRIPBLANKS) です。 LOADFILE オプションも選択した場合、ロード・コマンドの MODIFIED BY 節には STRIPTBLANKS または STRIPTNULLS 修飾子のいずれかが組み込まれます。

NULLINDCHAR ‘char’|x’XX’

NULLINDCHAR 修飾子は、出力ファイルへの NULL 値を示す考慮対象の単一文字を指定する場合に使用します。 デフォルト値は「Y」です。 この修飾子を指定すると、古い NULL オプションの潜在的な使用法がオーバーライドされます。また、値が NULL であるかどうかを示す文字も指定できます。

IMPLIEDDECIMAL

IMPLIEDDECIMAL 修飾子は、小数点を示す文字なしで 10 進タイプのデータをアンロードする場合に使用します。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには IMPLIEDDECIMAL 修飾子が含まれます。 この修飾子は、PACKEDDECIMAL 修飾子および ZONEDDECIMAL 修飾子と互換性がありません。

ZONEDDECIMAL

ZONEDDECIMAL 修飾子は、ゾーン表記の 10 進タイプのデータを出力ファイルにアンロードする場合に使用します。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには ZONEDDECIMAL 修飾子が含まれます。 この修飾子は PACKEDDECIMAL 修飾子および IMPLIEDDECIMAL 修飾子と互換性がありません。

USEGRAPHICCODEPAGE

USEGRAPHICCODEPAGE 修飾子は、DBCS コード・ページの 2 バイト・タイプ・データを出力ファイルにアンロードする場合に使用します。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには USEGRAPHICCODEPAGE 修飾子が含まれます。

FASTPARSE

この修飾子は、アンロードされるデータには影響を与えません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには FASTPARSE 修飾子が含まれます。

NOCHECKLENGTHS

この修飾子は、アンロードされるデータには影響を与えません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには NOCHECKLENGTHS 修飾子が含まれます。

DUMPFILE "ファイル名"

この修飾子は、アンロードされるデータには影響を与えません。 指定する値は絶対パスでなければなりません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには DUMPFILE 修飾子が含まれます。

ダンプファイルアクセスオール

この修飾子は、アンロードされるデータには影響を与えません。 LOADFILE 節も指定する場合、生成される Db2 Load コマンドの MODIFIED BY オプションには DUMPFILEACCESSALL 修飾子が含まれます。

INTO tablename または qualifier.tablename

LOADFILE オプションを使用して LOAD ファイルを生成し、ターゲット表の名前つまり qualifier.tablename の名前を変更する場合、以下のオプションを使用して新規名を指定することができます。

FORMAT DSNTIAUL INTO qualifier.tablename

重要: INTO 節を使用して名前を指定しない場合、ロード・ファイルではソース表の名前が使用されます。

XML フォーマットでは、以下のオプションを使用します。

COLATTVAL または COLATTVAL_XML

列名または列値のデータには、無効な XML 文字が含まれることがあります。 COLATTVAL および COLATTVAL_XML オプションは、結果ストリングでの無効な XML 文字の置き換えを制御します。

COLATTVAL オプションを使用する場合、プログラムは列値と列名の両方にある無効な XML 文字を置き換えます。 COLATTVAL オプションがデフォルトです。 列名のみの無効な文字を置き換える場合には、COLATTVAL_XML オプションを指定する必要があります。

表 1. XML属性値と要素値の文字置換

文字	置き換え後
<	& lt;
>	&gt;
“	&quot;
&	&amp;
‘	&apos;

ROWTAGSTRING

ROWTAGSTRING オプションは、行タグの名前を変更するために使用します。行タグは XML フォーマットで各行を識別するために使用されるものです。 この修飾子を使用して、タグのさまざまなストリング定数を指定できます。 デフォルトでは、値 "row" が想定されます。 このオプションを使用して、特定の XML 要件を満たすように出力をカスタマイズできます。

例:

FORMAT XML ROWTAGSTRING "line"

データをアンロードするときにこのオプションが指定されていると、出力ファイルで "row" タグが "line" タグに置き換えられます。

<?xml version="1.0" encoding="windows-1252" ?>
<table name="TBL_XML">
<line>
  <column name="NUMBER">123</column>
  <column name="NUMBER_NN">345</column>
</line>
</table>

INTO tablename または qualifier.tablename

特定の表をマイグレーションし、この表に明示的な select 要求を指定する場合、INTO オプションを使用して表名を指定できます。 ターゲット表の修飾子および名前がソース表の修飾子および名前と異なる場合、このオプションを使用して修飾子を指定します。 Optim High Performance Unload 対応するロードコマンドのINTO句から取得したテーブル名と修飾子を、ソーステーブルのテーブル名と修飾子の代わりに使用します。

重要: INTO 節を使用して名前を指定しない場合、ソース表の名前がロード・ファイルで使用されます。

抽出された行のリストに加えて、指定されたタスクが、関連するヘッダーおよびフッターが行の周囲に存在することを暗黙に示している場合は、JSON 出力フォーマットで生成された出力ファイルには、ヘッダーおよびフッターも含まれることがあります。

列とその関連値のレイアウトは、すべての宛先について同じです。

LOADDEST 節を指定すると、生成される出力ファイルの内容に影響があります。 ヘッダーおよびフッターの内容は、選択された NoSQL 宛先 (Cloudant、CouchDB、または MongoDB) によって異なります。 LOADDEST 節が指定されていない (つまり、特定の宛先が選択されていない) 場合は、いずれかの宛先に固有となる内容を一切含まない汎用出力ファイルが生成されます。 そのため、この場合に生成される出力ファイルには、ヘッダーやフッターは含まれず、出力ファイルの内容は考慮対象の宛先によって異なります。

JSON 出力フォーマットを持つ出力ファイルが関連アップロード・コマンドで生成される場合、LOADDEST 節は必須です。

Db2 データ・タイプおよび JSON データ・タイプ:

JSON 出力フォーマットは CLOB、BLOB、DBCLOB、および XML の各データ・タイプ列とは両立しません。 これらのデータ・タイプのいずれかの列を参照する SQL ステートメントに対して JSON 出力フォーマットでアンロードを指定した場合、その指定はリジェクトされることになります。 両立しない主な理由は、LOB データまたは XML データを JSON 文書に関連付けるためのユーザー・フレンドリーな自動方式が見つからないことです。

JSON 出力フォーマットでサポートされるデータ・タイプ間で、数値データ同士は区別されず、データ・タイプには number が指定されます。 値のレイアウトは囲み文字を持たない数値です。 結果として、以下の Db2 データ・タイプがこのデータ・タイプにフォーマット設定されます。

• SMALLINT
• INTEGER
• BIGINT
• DECIMAL
• 小桁実数 (REAL) 型
• DOUBLE

Db2 ストリング・データ・タイプ (VAR) CHAR および (VAR) GRAPHIC、 Db2 時刻データ・タイプ、DATE、TIME、および TIMESTAMP、および DECFLOAT Db2 データ・タイプは、 stringと呼ばれる JSON データ・タイプにフォーマット設定されます。 値のレイアウトは、二重引用符で囲まれた値になります。

NULL 値は JSON データ・タイプ null で表されます。その値は常に、囲み文字を持たない定数ストリング「null」となります。