出力フォーマット
有効な対象
Extract
摘要
OUTPUTFORMATパラメータを使用して、データをtext、SQLおよびXML形式で出力します。
デフォルト
なし
構文
OUTPUTFORMAT <format_type> [, <option>] [, ...]
出力形式テキスト
TEXT <format_type>では、デフォルトのOracle GoldenGate正規フォーマットではなく、外部テキスト・フォーマットでデータを出力します。大半のデータベース・ロード・ユーティリティおよびASCII入力を必要とするその他のプログラムと互換性があるように出力のフォーマットができます。このパラメータは、File-to-Database-utilityinitialロード・メソッドを使用するときに必要です。
このタイプの文は、パラメータ・ファイル内のこの文以降のすべての抽出ファイルまたはトレイルに影響します。パラメータ・ファイル内の文の相対的な順序は重要です。ファイルまたはトレイルの指定の後に指定すると、OUTPUTFORMAT TEXTは効力がありません。
<option>には、次のいずれかを指定できます。
INCLUDE (HEARTBEAT)
ハートビート表のレコードを含みます。デフォルトではハートビート表のレコードは無視されます。
BCP
SQL ServerのBulk Copy Programや他のバルク・ロード・ユーティリティとの互換性を保つために出力をフォーマットします。
BCP <option>オプションを指定すると、次のオプションは無視されます。
-
NAMES | NONAMES— 列名を含めるかどうかを指定します。デフォルトはNAMESです。 -
NULLISSPACE—NULL列を空の列として出力します。NULLISSPACEを指定しない場合、NULL列はNULLとして出力されます。 -
PLACEHOLDERS— 紛失した列のかわりにプレースホルダを出力します。 -
NOHDRFIELDS— ビフォアおよびアフター・インジケータやトランザクション情報としてメタデータを含めません。列データのみを出力します。 -
DELIMITER 'delimiter'— フィールド・デリミタ文字を指定します。タブ区切りを指定するにはTABを使用します。デフォルトは、カンマ'、'です。 -
OP | _NOOP— 操作タイプ・インジケータ(I、D、U、V)を含めるかどうかを指定します。デフォルトはOPです。 -
IND | _NOIND— ビフォア・イメージとアフター・イメージのインジケータ(BまたはA)を含めるかどうかを指定します。デフォルトはINDです。 -
_TRANSTMTS | _NOTRANSTMTS— トランザクション情報を含めるかどうかを指定します。デフォルトは_TRANSTMTSです。 -
_WHOLEFILE— スキーマ名を含む完全修飾されたオブジェクト名を含めます。 -
_FILE— オブジェクト名のみを含めます。
SQLLOADER
Oracle SQL*LoaderユーティリティまたはIBMロード・ユーティリティと互換性を持つ固定長テキスト・フォーマット・ファイルを生成します。
DATE |
TIME |
TS |
出力するレコード・タイムスタンプの精度を指定します。デフォルトでは、このパラメータではレコードのタイムスタンプは出力されません。次のいずれかを使用できます。
-
DATEは日付を出力する(年から日)。 -
TIMEは時間を出力します(年から秒)。 -
TSはトランザクションのタイムスタンプを出力します(年からマイクロ秒)。
SQLLOADER
Oracle SQL*LoaderユーティリティまたはIBM Load Utilityプログラムと互換性を持つ固定長ASCIIフォーマット・ファイルを生成します。
出力フォーマットSQL
OUTPUTFORMAT SQLパラメータでは、デフォルトのOracle GoldenGate正規フォーマットではなく、外部SQLフォーマットでデータを出力します。OUTPUTFORMAT SQLは、Oracle GoldenGate Replicat以外のユーティリティでSQL表に適用可能な、SQL文(INSERT、UPDATEおよびDELETE)を生成します。
INCLUDE (HEARTBEAT)
ハートビート表のレコードを含みます。デフォルトでは、ハートビート表のレコードは無視されます。
ENCODINGエンコーディング
指定したエンコーディングのSQLフォーマット・ファイルを出力します。Oracle GoldenGateの文字セット名がサポートされます。デフォルトはオペレーティング・システムの現在の文字セットです。デフォルト文字セットの場合、列での文字セットの変換は実行されません。
次のオプションを使用して特別な出力フォーマットを指定します。各オプションは排他的であるため、同時に指定することはできません。
ORACLE
日付および時刻列をSQL*Plusが受け付けるフォーマットに変換し、Oracle Databaseと互換性を持つようにレコードをフォーマットします。
SQLPLUS
日付および時刻列をSQL*Plusが受け付けるフォーマットに変換し、Oracle Databaseと互換性を持つようにレコードをフォーマットします。
SQLLOADER
Oracle SQL*LoaderユーティリティまたはIBMロード・ユーティリティ・プログラムと互換性を持つ固定長textフォーマット・ファイルを生成します。
これは推奨のOUTPUTFORMAT TEXT SQLLOADERとまったく同じです。
| トランスト | ノットランストムツ |
SQLトランザクション情報をコメントとして含めます。_NOTRANSTMTSがデフォルトです。
たとえば:
-B, 2016-07-09:09:9:21.000000,1357991461,627
WHOLEFILE
スキーマ名を含む完全修飾されたオブジェクト名を含めます。
FILE
オブジェクト名のみを含めます。
NOPKUPDATES
PKUPDATE操作とUNIFIED UPDATE操作を、DELETE操作とINSERT操作のペアとしてフォーマットします。このオプションが指定されない場合、PKUPDATE操作とUNIFIED UPDATE操作はUPDATE操作としてフォーマットします。SQLLOADERオプションが使用されると、このオプションは無視されます。
出力形式XML
OUTPUTFORMAT XMLパラメータでは、デフォルトのOracle GoldenGate正規フォーマットではなく、XMLフォーマットでデータを出力します。OUTPUTFORMAT XML文は、それ以降に定義されているすべてのExtractファイルまたはトレイルに影響します。デフォルトでは、XMLはローカル・オペレーティング・システムの文字セットで出力されます。
CLOBまたはBLOBとして格納されるXMLは4000バイトまで出力されます。BLOBまたはCLOBとして格納されている、このよりも大きなXMLを含めるには、ENCODINGオプションを使用してください。
CLOBとして格納されているXMLは、サイズにかかわらず常にCDATAセクションに出力される。This is to avoid the overhead of converting reserved characters such as <, > and & to the appropriate XML representation.
BLOBを含むバイナリ・データはBase64としてエンコードされます。これはバイナリ・データをASCII文字列形式で表し、XMLへの出力が可能です。
UTF-8で出力するようにENCODINGオプションが使用されないかぎり、XML、データベース・オブジェクト名(表や列の名前など)、およびCHARデータやVARCHARデータは、オペレーティング・システムのデフォルトの文字セットで書込みが行われる。
INCLUDE (HEARTBEAT |
LOB |
USERTOKEN) |
ハートビート表のレコードを含みます。また、4000バイトを超えるLOBおよびOracle GoldenGateユーザー・トークン。
デフォルトでは、ハートビート表のレコードは無視され、4000バイトを超えるLOBとユーザー・トークンは含まれません。
4000バイトを超えるBLOBはBase64でエンコードされ、4000バイトを超えるCLOBはCDATAセクションでフォーマットされます。
INLINEPROPERTIES |
NOINLINEPROPERTIES |
XMLタグ内にプロパティを含めるか、別に書き込むかどうかを制御します。デフォルトはINLINEPROPERTIESです。
TRANS |
NOTRANS |
トランザクション境界とコミット・タイムスタンプをXML出力に含めるかどうかを制御します。TRANSがデフォルトです。
CLOSETRANS |
NOCLOSETRANS |
開いたトランザクション境界を強制的に閉じ、ロールオーバー時にタイムスタンプをコミットします。ロールオーバー後に、同じトランザクション境界とコミット・タイムスタンプ・タグが次のXMLファイルに追加されます。
TRANSオプションが指定されないと、このオプションは無視されます。
ENCODING xml_encoding
指定したエンコーディングのXMLファイルを出力します。デフォルトはUTF-8です。次のMIMEエンコーディング名がサポートされます。
UTF-8 ISO-10646 UTF-8、サロゲート・ペアは1文字当たり4バイト
UTF-16、ISO-10646、UTF-16
windows-1250 Windows中央ヨーロッパ
windows-1251 Windowsキリル文字
windows-1252 Windowsラテン語-1
windows-1253 Windowsギリシャ語
windows-1254 Windowsトルコ語
windows-1255 Windowsヘブライ語
windows-1256 Windowsアラビア語
windows-1257 Windowsバルト語
windows-1258 Windowsベトナム語
windows-874 Windowsタイ語
IBM437 DOSラテン語-1
IBM775 DOS 775、バルト語
IBM850 DOSマルチリンガル
cp851 DOSギリシャ語-1
IBM852 DOSラテン語-2
IBM855 DOSキリル文字
IBM857トルコ語DOS
IBM00858 DOSマルチリンガル(ユーロ記号を含む)
IBM860 DOSポルトガル語
IBM861 DOSアイスランド語
IBM862 DOSヘブライ語
IBM863 DOSフランス語
IBM864 DOSアラビア語
IBM865 DOS北欧
IBM866 DOSキリル言語/GOST 19768-87
IBM868 DOSウルドゥー語
IBM869 DOSギリシャ語-2
ISO-8859-1 ISO-8859-1 Latin-1/西ヨーロッパ
SO-8859-2 ISO-8859-2 Latin-2/東ヨーロッパ
ISO-8859-3 ISO-8859-3 Latin-3/南ヨーロッパ
ISO-8859-4 ISO-8859-4 Latin-4/北ヨーロッパ
ISO-8859-5 ISO-8859-5ラテン語/キリル文字
ISO-8859-6 ISO-8859-6ラテン語/アラビア語
ISO-8859-7 ISO-8859-7ラテン語/ギリシャ語
ISO-8859-8 ISO-8859-8ラテン語/ヘブライ文字
ISO-8859-9 ISO-8859-9 Latin-5/トルコ
ISO-8859-10 ISO-8859-10 Latin-6/北欧
ISO-8859-13 ISO-8859-13 Latin-7/バルト語リム
ISO-8859-14 ISO-8859-14 Latin-8/ケルト語
ISO-8859-15 ISO-8859-15 Latin-9/西ヨーロッパ
ISO-8859-16 ISO-8859-16、Latin-10、東南ヨーロッパ
KOI8-R KOI8-R、ロシア語
KOI8U KOI8-U、ウクライナ語
TIS-620タイ工業規格620-2533
DEC-MCS DECマルチリンガル
HP-roman8 HPラテン1 Roman8
Shift_JIS Shift_JIS、Windows-932
GBK GBK、Windows-936
KSC_5601 KSC-5601、Windows-949
Big5 Big-5繁体字中国語、Windows-950
EUC-JP EUC日本語
GB2312 GB-2312-1980
EUC-KR EUC韓国語
GB18030 GB-18030
HZ-GB-2312 HZ GB-2312
Big5-HKSCS Big-5、HongKong拡張
例
OUTPUTFORMAT XML NOINLINEPROPERTIES, NOTRANS