構文 - FastExport

次のような場合に当てはまります。

OUTFILE fileid

クライアントシステム上のデータ宛先ファイルです。

ファイルは、クライアントシステムDDまたは同等の文で指定されます。

UNIX OSおよびWindowsでは、fileidはファイルのパス名です。
パス名に空白文字が埋め込まれている場合、パス名全体を単一引用符または二重引用符で囲む必要があります。

パス名が単一引用符で囲まれていて、その中に単一引用符が埋め込まれている場合は、埋め込まれた単一引用符よりも先にエスケープ文字(単一引用符)を指定する必要があります。同様に、パス名が二重引用符で囲まれていて、その中に二重引用符が埋め込まれている場合は、埋め込まれた二重引用符よりも先にエスケープ文字(二重引用符)を指定する必要があります。
z/OSでは、fileidはDDNAMEです。

AXSMOD name

データをエクスポートするために使用されるアクセスモジュールファイルの名前です。これらのアクセスモジュールには以下の項目が含まれます。

Teradata Access Module for OLE DB:Windowsプラットフォームではoledb_axsmod.dll
Teradata Access Module for JMS:
- すべてのサポートされているUNIX プラットフォームの場合、libjmsam.so
- Windowsプラットフォームの場合、libjmsam.dll

カスタムアクセスモジュールを使用する場合は個人共有ライブラリのファイル名を使用できます。

ワークステーション接続またはメインフレーム接続のクライアントシステムにあるディスクファイル、またはメインフレーム接続のクライアントシステムにある磁気テープファイルをインポートする場合には、AXSMODオプションは必要ありません。必要になるのは、ネットワーク接続クライアントシステム上の磁気テープまたは他のタイプのファイルからインポートする場合です。

’init-string’

[任意選択]アクセスモジュール用の初期設定文字列です。

OUTMOD modulename

[任意選択]エクスポートデータ処理用のユーザー作成ルーチンです。

z/OSでは、modulenameはロードモジュールの名前です。UNIXおよびWindowsプラットフォーム上では、OUTMOD実行可能コードファイルのパス名です。

FastExport/OUTMODルーチンインターフェースで説明したように、FastExportは、指定プロシージャに6つのパラメータを提供します。

モジュールが現在のディレクトリにある場合、UNIXオペレーティングシステムのバージョンによっては、OUTMOD modulenameの前に./という接頭辞を追加しなければならない場合があります。

MODE…

クライアントシステムに戻されるエクスポートデータのフォーマットモードです。次の2種類のモードがあります。

INDICATOR
RECORD

MODEオプションを指定しない場合のデフォルトはINDICATORモードです。

FastExportでは、フィールドモードはサポートされていません。フィールドモードデータをエクスポートするためには、SELECT文で適切なフォーマット句を使用し、データベースで応答データを文字フォーマットに変換できるようにします。

FORMAT...

ワークステーション接続システム上のエクスポートファイルのレコード形式です。以下のオプションがあります。

FASTLOADは、各レコードが、レコード終了マーカー(X'0A'またはX'0D')を伴なう、2バイト整数nとそれに続くnバイトのデータであることを指定します。
BINARYは、各レコードが、2バイトの整数 nとそれに続くnバイトのデータであることを指定します。
TEXT。各レコードはクライアントセッション文字セットの任意の文字数で構成され、後に次のいずれかのレコード終了記号が続きます。
- UNIXプラットフォームでは、改行文字(UnicodeではLINE FEED U+000A)です。
- Windowsプラットフォームの場合、2文字の連続復帰文字とこれに続く改行(Unicodeでは、それぞれCARRIAGE RETURN U+000DおよびLINE FEED U+000Aとして識別されます)
UTF16以外のクライアントセッション文字セットの場合、レコード終了記号バイトシーケンスは以下のようになります。
- UNIXプラットフォームでは、X'0A'です
- Windowsプラットフォームでは、X'0D0A'です。
UTF16クライアントセッション文字セット(この文字セットでは、各文字が2バイトでエンコードされます)の場合、レコード終了記号バイトシーケンスは以下のようになります。
- ビッグエンディアンのUNIXプラットフォームでは、X'000A'
- リトルエンディアンのUNIXプラットフォームでは、X'0A00'
- Windowsプラットフォームでは、X'0D000A00'です。
TEXT形式は文字データに対してだけ指定する必要があります。バイナリデータ(INTEGER、BYTEINT、PERIODなど)にTEXT形式を指定しないでください。バイナリデータの実バイト値により、予期しない結果が発生することがあります。
UNFORMATは、各レコードが、クライアントで変更されることなくCLIv2から受け取ったデータのままエクスポートされることを指定します。

FORMATオプションは、UNIXおよびWindowsプラットフォームだけに適用されます。

FORMATオプションを指定しない場合のデフォルトはFASTLOADです。

TEXTレコード形式の使用時のINDICATORSモードは推奨しません。UNFORMATTEDを代わりのレコード形式として使用してください。
TEXTデータには、すべてのCHARデータ型またはANSIDATEデータ型が必要です。

BLOCKSIZE integer

クライアントにデータを返すときに使用する最大ブロックサイズ。

デフォルトのブロックサイズは64Kバイトです。最大サイズは64Kです。

FastExportのEXPORTコマンドのBLOCKSIZE指定は、64Kを超えることはできません。FastExportで、1MBのPERM行がサポートされていないためです。

OUTLIMIT records

出力クライアントファイルに書き込まれる最大応答レコード数です。

この数に達したら、次のメッセージがプリント出力ファイルに出力され、応答データの処理が終了します。

 Output limit of n exceeded.

MLSCRIPT fileid

生成したMultiLoadスクリプトファイルの宛先ファイルです。

MLSCRIPTオプションを指定すると、FastExportはMultiLoadスクリプトファイルを生成します。このスクリプトを後ほど使用すれば、エクスポートデータをデータベースに再ロードして戻すことができます。

ファイルは、クライアントシステムDDまたは同等の文で指定されます。

UNIX OSおよびWindowsでは、fileidはファイルのパス名です。
z/OSでは、fileidはDDNAMEです。

デフォルトでは、MLSCRIPTオプションを指定しない場合は、FastExportユーティリティはMultiLoadスクリプトファイルを生成しません。

指定したfileidがすでに存在している場合は、上書きされます。
FastExportは、データベースから受信したフィールドサイズと型に基づいたMultiLoadスクリプトのレイアウトを生成します。DATEFORMコマンドでANSIDATEが使用されている場合のように、DATE型は、CHAR ()型に変更される必要があります。データをロードするためにスクリプトを書き込む場合でも、固定長のCHARデータ型に変換する必要があります。

Teradata FastExporで拡張オブジェクト名が使用されている場合、生成されるMultiLoadスクリプトファイルのU&構文に列名は含まれません。MultiLoadジョブを正常に実行するには、ユーザーがU&構文を追加する必要があります。

例えば、Teradata FastExportはU&"c1#FF43#FF11"UESCAPE'#'という列を使用します。

作成されるMultiLoadスクリプトは次のとおりです。

Teradata MultiLoadを適切に機能させるには、c1c1をU&"c1#FF43#FF11"UESCAPE'#'に変更する必要があります。

.LAYOUT DATAIN_LAYOUT INDICATORS;
.FIELD c1c1 1 INTEGER;
.FIELD c2 5 CHAR(20);

.DML LABEL INSERT_DML;
INSERT INTO &DBASE_TARGETTABLE..&TARGETTABLE (
 c1c1 = :c1c1
,c2 = :c2
);

PAD

埋め込み機能は、Z/OSプラットフォームでのみ使用できます。

PADに指定できる値は、NULLSとBLANKSの2つです。NULLSを指定すると、レコードはNULLSで埋め込まれます。BLANKSを指定すると、レコードはBLANKSで埋め込まれます。

デフォルト値は、BLANKSです。