DATAEXPORT
テキストまたはバイナリ・ファイルにデータを書き込みます。
構文
テキスト出力ファイルの場合:
DATAEXPORT "File" "delimiter" "fileName" "missingChar"
バイナリ出力ファイルの場合(バイナリ・ファイルへのDATAEXPORTは、Essbaseリリース間ではサポートされず、64-bitオペレーティング・システム間でのみサポートされます):
DATAEXPORT "Binfile" "fileName"
パラメータ
- "File""Binfile"
-
出力ファイルのタイプに必要なキーワード。 適切なキーワードを指定してから、関連する構文を使用します。
- "delimiter"
-
「ファイル」エクスポートに必要
フィールドを区切る文字(例: ",")
Binfileエクスポートでは使用しないでください
- "fileName"
-
「File」および「Binfile」エクスポートに必要
エクスポート・ファイルのフルパス名。
- "missingChar"
-
出力タイプが「ファイル」の場合はオプション
-
欠落しているデータ値を表すテキスト文字列。 最大長: 128 characters.
-
「NULL」を指定すると、フィールドがスキップされ、デリミタ(,,など)が連続して表示されます。
-
デフォルト値: #MI
Binfileエクスポート、またはSET DATAEXPORTRELATIONALFILEコマンドと組み合せて使用しないでください。
-
ノート
-
一般に、計算スクリプト内でSETコマンドを指定して様々なオプションを指定し、FIX…ENDFIXコマンドを使用して、FIX…ENDFIXコマンド・セット内のDATAEXPORTコマンドなど、エクスポートするデータを絞り込みます。 FIX…ENDFIXを指定しない場合、データベース全体がエクスポートされます。
-
ファイルおよびfileNameを出力する場合:
-
パスは含まれません。ファイルはアプリケーション・ディレクトリに書き込まれます。
-
パスが含まれている場合、Essbaseはサーバーへのコンテキストでパスを解釈します。 エクスポート・ファイルをクライアントに書き込むことはできません。
-
-
パラレル計算でこのコマンドを使用するには、SET CALCPARALLELのかわりにFIXPARALLEL...ENDFIXPARALLELを使用します。
-
DATAIMPORTBINコマンドを使用して、以前にエクスポートしたバイナリ・エクスポート・ファイルをインポートします。
-
計算エクスポートでは、一度に1つのブロックがロックされます。他のすべてのブロックは更新できます。
説明
DATAEXPORT計算コマンドは、テキストまたはバイナリ出力ファイルにデータを書き込むか、選択したエクスポート済データが挿入される既存のリレーショナル・データベースに直接接続します。
MaxL 「データのエクスポート」文では、データベース全体のすべてのデータ、レベル0のデータまたは入力データをテキスト・データとしてエクスポートできますが、DATAEXPORT計算コマンドでは次のことも可能です:
-
FIX…ENDFIXまたはEXCLUDE...ENDEXCLUDEの計算を使用してデータベースのスライスを選択し、DATAEXPORTCONDコマンドを使用してデータ値に基づいてデータを選択します。
-
パラメータを使用して、エクスポート・データのタイプと宛先を修飾します。
-
SET DATAEXPORTOPTIONSコマンドで提供されるオプションを使用して、エクスポート・コンテンツ、フォーマットまたはプロセスを絞り込みます。
-
SET DATAIMPORTIGNORETIMESTAMPコマンドを使用して、一致するアウトライン・タイムスタンプのインポート要件を管理します。
例
テキスト出力ファイルの例1
SET DATAEXPORTOPTIONS
{
DataExportLevel "LEVEL0";
};
DATAEXPORTCOND ("Sales">=1000);
FIX ("100-10","New York","Actual","Sales");
DATAEXPORT "File" "," "jan.txt" "#MI";
ENDFIX;
レベル0のデータ・エクスポート・レベルを指定し、販売高が1000以上のデータのみに出力を制限し、データ・スライスを修正してから、カンマ(,)区切りを使用してデータベース・ディレクトリにあるテキスト・ファイルにエクスポートし、欠落しているデータ値に#MIを指定します。
バイナリの例1: エクスポート
SET DATAEXPORTOPTIONS
{
DataExportLevel "ALL";
};
FIX ("New York");
DATAEXPORT "BinFile" "newyork.bin";
ENDFIX;
New Yorkのすべてのブロックをエクスポートします。 バイナリ・エクスポートは疎ディメンションでのみ修正できます。 Essbaseでは、Essbase Kernelで使用されるものと同じビットマップ圧縮手法を使用してファイルを作成します。
バイナリの例2: インポート
SET DATAIMPORTIGNORETIMESTAMP OFF;
DATAIMPORTBIN "newyork.bin"
以前にエクスポートしたファイルをインポートします。 タイムスタンプは一致する必要があります。 データは、計算スクリプトが実行されるデータベースにインポートされます。 データのみがエクスポートされたため、DATAIMPORTを使用してデータを読み取った後にデータベースを再作成するには、データを再計算する必要があります。