1. Oracle Essbase計算および問合せリファレンス
  2. 計算コマンド
  3. 計算コマンド・リスト
  4. SET DATAEXPORTOPTIONS
機械翻訳について

SET DATAEXPORTOPTIONS

データ・エクスポート操作のオプションを指定します。

構文

SET DATAEXPORTOPTIONS
  {
  DataExportLevel ALL | LEVEL0 | INPUT;
  DataExportDynamicCalc ON | OFF;
  DataExportNonExistingBlocks ON | OFF;
  DataExportDecimal n;
  DataExportPrecision n;
  DataExportColFormat ON | OFF;
  DataExportColHeader dimensionName;
  DataExportDimHeader ON | OFF;
  DataExportRelationalFile ON | OFF;
  DataExportOverwriteFile ON | OFF;
  DataExportDryRun ON | OFF;
  };

ノート

各SET DATAEXPORTOPTIONSコマンドは、次のSET DATAEXPORTOPTIONSコマンドが検出されるまでの一連のオプション値を指定します。 その時点で、オプション値はデフォルトにリセットされ、新しく指定されたオプション値が設定されます。

オプション・リストは、左カッコ({)で始まり、右カッコで終わり、その後にセミコロン(};)が続く必要があります。 各オプションはセミコロン(;)で終わります。 オプションは任意の順序でリストできます。 オプションを指定しない場合、デフォルト値が使用されます。

ここでは、次の3つのカテゴリでオプションについて説明します:

コンテンツ・オプション

DataExportLevel ALL | LEVEL0 | INPUT

  • ALL-(Default)連結および計算結果を含むすべてのデータ。

  • LEVEL0-レベル0のデータ・ブロックのみ(レベル0の疎メンバーの組合せのみを含むブロック)。

  • INPUT-入力ブロックのみ(前のデータ・ロードまたはグリッド・クライアント・データ更新操作からのデータを含むブロック)。 このオプションでは、動的に計算されたデータは除外されます。 DataExportDynamicCalcオプションも参照してください。

DataExportLevelオプションの値を指定する場合は、次のガイドラインを使用します:

  • 値は大文字と小文字が区別されません。 たとえば、LEVEL0またはlevel0を指定できます。

  • 値を引用符で囲むかどうかはオプションです。 たとえば、LEVEL0または"LEVEL0"を指定できます。

  • 値を指定しない場合、Essbaseではデフォルト値のALLが使用されます。

  • 値が正しく表されない場合(LEVEL 0やLEVEL2など)、Essbaseではデフォルト値のALLが使用されます。

説明

エクスポートするデータの量を指定します。

DataExportDynamicCalc ON | OFF

  • ON-(Default)の動的に計算された値がエクスポートに含まれます。

  • OFF-動的に計算された値はレポートに含まれません。

説明

テキスト・データ・エクスポートで動的に計算されたデータを除外するかどうかを指定します。

ノート:

  • テキスト・データのみがエクスポートされます。 バイナリ・エクスポート(DATAEXPORT BINFILE…)でDataExportDynamicCalc ONが検出された場合、無視されます。 動的に計算されるデータはエクスポートされません。

  • 「The DataExportDynamicCalc」オプションは属性値には適用されません。

  • DataExportLevel INPUTも指定され、FIX文の範囲に疎「動的計算」メンバーが含まれている場合、FIX文は無視されます。

DataExportNonExistingBlocks ON | OFF

  • ON-疎ディメンションのすべての組合せを含む、使用可能なすべてのデータ・ブロックのデータがエクスポートされます。

  • OFF-(Default)既存のデータ・ブロックのデータのみがエクスポートされます。

説明

使用可能なすべてのデータ・ブロックからデータをエクスポートするかどうかを指定します。 疎ディメンションに多数のメンバーが含まれる大きなアウトラインでは、潜在的なデータ・ブロックの数が非常に多くなる可能性があります。 可能性のあるすべてのブロックから動的計算メンバーをエクスポートすると、パフォーマンスに大きな影響を与える可能性があります。

DataExportPrecision n

n (オプション。デフォルトは16)-エクスポートされた数値データの位置の数を指定する値。 n < 0の場合、16桁の精度が使用されます。

説明

DATAEXPORT計算コマンドで、精度(精度)を重視して数値データを出力することを指定します。 データ値のサイズおよび小数点以下の桁数に応じて、数値フィールドによっては指数形式(678123e+008など)で記述されることがあります。 バックアップ用のエクスポート・ファイルや、データ範囲が非常に大きい値から非常に小さい値の場合は、DataExportPrecisionの使用を検討できます。 通常、出力ファイルは小さくなり、データ値はより正確になります。 ユーザーまたは一部の外部プログラムによって読み取られる出力データの場合は、かわりにDataExportDecimalオプションを指定することを検討できます。

ノート:

  • デフォルトでは、Essbaseは小数部を含む数値データの16桁をサポートしています。

  • DataExportDecimalオプションは、DataExportPrecisionオプションよりも優先されます。

例

SET DATAEXPORTOPTIONS
    { 
    DataExportPrecision 6;
    DataExportLevel ALL;
    DataExportColHeader "Measures";
    DataExportDynamicCalc ON;
    };
    DATAEXPORT "File" "," "output1.out";

初期データ・ロード値

"Sales" "COGS" "Margin" "Marketing" "Payroll" "Misc" "Total Expenses" "Profit" "Opening Inventory" "Additions" "Ending Inventory" "Margin %" "Profit %" 
"100-10" "New York"
"Jan" "Actual" 678123456.0 271123456.0 407123456.0 941234567890123456.0 51123456.0 0 145123456.0 262123456.0 2101123456.0 644123456.0 2067123456.0 60123456.029 38123456.6430
"Feb" "Actual" 645123 258123 3871234 9012345 5112345 112345678 14212345 24512345 2067123456 61912345 20411234 601234 37123456.98 
"Mar" "Actual" 675 270 405 94 51 1 146 259 2041 742 2108 60 38.37037037037037 
"Qtr1" "Actual" 1998 799 1199 278 153 2 433 766 2101 2005 2108 60.01001001001001 38.33833833833834

エクスポートされるデータ形式

"Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions","Ending Inventory","Margin %","Profit %","Profit per Ounce","100-10","New York"
"Jan","Actual",6.78123e+008,2.71123e+008,4.07e+008,9.41235e+017,5.11235e+007,0,9.41235e+017,-9.41235e+017,2.10112e+009,6.44123e+008,2.06712e+009,60.0186,-1.388e+011,-7.84362e+016
"Feb","Actual",645123,258123,387000,9.01235e+006,5.11235e+006,1.12346e+008,1.2647e+008,-1.26083e+008,2.06712e+009,6.19123e+007,2.04112e+007,59.9886,-19544.1,-1.05069e+007
"Mar","Actual",675,270,405,94,51,1,146,259,2041,742,2108,60,38.3704,21.5833

DataExportDecimal n

ここで、nは0から16までの値です。

値が指定されていない場合、エクスポートされるデータの小数点以下の桁数(最大16桁)またはDataExportPrecisionオプションで決定される値(指定されている場合)が使用されます。

説明

DATAEXPORT計算コマンドが、読みやすさを重視して数値データを出力することを指定します。出力データは、直線テキスト形式です。 データの小数点以下の桁数に関係なく、指定した数値が出力されます。 特に、データ範囲が非常に大きい値から非常に小さい値(小数点以下)の場合、データの精度が低下する可能性があります。

ノート:

  • デフォルトでは、Essbaseは小数部を含む数値データの16桁をサポートしています。

  • DataExportDecimalオプションとDataExportPrecisionオプションの両方を指定した場合、DataExportPrecisionオプションは無視されます。

例

SET DATAEXPORTOPTIONS
    {DataExportDecimal 4;
    DataExportLevel "ALL";
    DataExportColHeader "Measures";
    DataExportDynamicCalc ON;
    };
    DATAEXPORT "File" "," "output1.out";

初期データ・ロード値

"Sales" "COGS" "Margin" "Marketing" "Payroll" "Misc" "Total Expenses" "Profit" "Opening Inventory" "Additions" "Ending Inventory" "Margin %" "Profit %" 
"100-10" "New York"
"Jan" "Actual" 678123456.0 271123456.0 407123456.0 941234567890123456.0 51123456.0 0 145123456.0 262123456.0 2101123456.0 644123456.0 2067123456.0 60123456.029 38123456.6430
"Feb" "Actual" 645123 258123 3871234 9012345 5112345 112345678 14212345 24512345 2067123456 61912345 20411234 601234 37123456.98 
"Mar" "Actual" 675 270 405 94 51 1 146 259 2041 742 2108 60 38.37037037037037 
"Qtr1" "Actual" 1998 799 1199 278 153 2 433 766 2101 2005 2108 60.01001001001001 38.33833833833834

エクスポートされるデータ形式

"Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions","Ending Inventory","Margin %","Profit %","Profit per Ounce"
"100-10","New York"
"Jan","Actual",678123456.0000,271123456.0000,407000000.0000,941234567890123520.0000,51123456.0000,0.0000,941234567941246980.0000,-941234567534246910.0000,2101123456.0000,644123456.0000,2067123456.0000,60.0186,-138799883591.4395,-78436213961187248.0000
"Feb","Actual",645123.0000,258123.0000,387000.0000,9012345.0000,5112345.0000,112345678.0000,126470368.0000,-126083368.0000,2067123456.0000,61912345.0000,20411234.0000,59.9886,-19544.0820,-10506947.3333
"Mar","Actual",675.0000,270.0000,405.0000,94.0000,51.0000,1.0000,146.0000,259.0000,2041.0000,742.0000,2108.0000,60.0000,38.3704,21.5833

出力フォーマット・オプション

DataExportColFormat ON | OFF

  • ON-データは列形式で出力されます。

  • OFF-Default. データは、非列形式で出力されます。

説明

データを列形式で出力するかどうかを指定します。 列形式では、すべてのディメンションのメンバー名が表示されます。名前は行ごとに繰り返すことができ、Essbaseツール以外のアプリケーションで使用できます。 非列型フォーマットの場合、データ・ブロックを識別する疎メンバーは、ブロックにつき1回だけ含まれます。 非列型エクスポート・ファイルは小さくなり、Essbaseデータベースへのロードが高速になります。

ノート

DataExportColFormatオプションは、リレーショナル・データベースへの入力ファイルとして転送されるファイルの列形式をすでに想定しているDataExportRelationalFileオプションと組み合せて使用しないでください。

例

SET DATAEXPORTOPTIONS
 {
 DATAEXPORTCOLFORMAT ON;
 };
 FIX("100-10", Sales, COGS, Jan, Feb, Mar, Actual, Budget)
 DATAEXPORT "File" "," "test2.txt" ;
ENDFIX;

DataExportColHeader dimensionName

説明

エクスポート・ファイルで他のデータが参照される列ヘッダー(フォーカス)である密ディメンションの名前を指定します。 DataExportColHeaderオプションは、データをテキスト・ファイルにエクスポートする場合にのみ使用します。 たとえば、Sample BasicのYearディメンションが指定されている場合、出力データはYearディメンションの最初のメンバーに関連付けられたデータで始まります: Year. Yearのすべてのデータが出力された後、2番目のメンバーで続行されます: Qtr1など。

ノート

MaxL、「ESSCMDシェル」およびEssbaseのエクスポートには、同様の機能はありません。 これらのメソッドを使用して、Essbaseは出力データの焦点を決定します。

「レポート・ライター」を介してエクスポートすると、レポート・スクリプトでヘッダーを指定できます。

例

SET DATAEXPORTOPTIONS {DATAEXPORTCOLHEADER Scenario;};

エクスポート・ファイルのページ・ヘッダーとしてシナリオを指定します。 Scenarioディメンションには3つのメンバーが含まれています: シナリオ、実績および予算。 最初にすべてのシナリオ・データが表示され、次にすべての実績データ、次にすべての予算データが表示されます。

DataExportDimHeader ON | OFF

  • ON-ヘッダー・レコードが含まれます。

  • OFF-Default. ヘッダー・レコードは含まれません。

説明

DataExportDimHeaderオプションを使用して、オプションのヘッダー・レコードをエクスポート・ファイルの先頭に挿入します。 ヘッダー・レコードには、ファイルで使用されている順序ですべてのディメンション名が含まれます。 このコマンドを指定すると、データは常に列形式で書き込まれます。

例

SET DATAEXPORTOPTIONS 
 {
 DATAEXPORTLEVEL "ALL"; 
 DATAEXPORTDIMHEADER ON; 
 };
FIX("100-10", "New York", "Actual")
 DATAEXPORT "File" "," "2222.txt" ;
ENDFIX;

Sample Basicのエクスポート時に「DataExporttDimHeader ON」オプションを指定すると、各行に共通メンバーが繰り返され、データが列形式で書き込まれます。 次のサンプル・ファイルの最初の2行に示すように、データはディメンション・ヘッダーで始まります: 

"Product","Market","Year","Scenario","Measures"
"Sales","COGS","Marketing","Payroll","Misc","Opening Inventory","Additions","Ending Inventory"
"100-10","New York","Jan","Actual",678,271,94,51,0,2101,644,2067
"100-10","New York","Feb","Actual",645,258,90,51,1,2067,619,2041
"100-10","New York","Mar","Actual",675,270,94,51,1,2041,742,2108
"100-10","New York","Apr","Actual",712,284,99,53,0,2108,854,2250
"100-10","New York","May","Actual",756,302,105,53,1,2250,982,2476
"100-10","New York","Jun","Actual",890,356,124,53,0,2476,1068,2654
"100-10","New York","Jul","Actual",912,364,127,51,0,2654,875,2617
"100-10","New York","Aug","Actual",910,364,127,51,0,2617,873,2580
"100-10","New York","Sep","Actual",790,316,110,51,1,2580,758,2548
"100-10","New York","Oct","Actual",650,260,91,51,1,2548,682,2580
"100-10","New York","Nov","Actual",623,249,87,51,0,2580,685,2642
"100-10","New York","Dec","Actual",699,279,97,51,1,2642,671,2614

DataExportRelationalFile ON | OFF

  • ON-出力テキスト・エクスポート・ファイルは、リレーショナル・データベースにインポートするためにフォーマットされます。

    • データは列フォーマットです。疎メンバー名が繰り返されます。 (「The DataExportColFormat」オプションは無視されます。)

    • エクスポート・ファイルの最初のレコードはデータです。 DataExportDimHeaderオプションを使用して指定した場合でも、ディメンション・ヘッダーは含まれません。 DataExportColHeaderオプションが使用されている場合でも、リレーショナル・エクスポート・ファイルの最初の行にラベルが付けられる列はありませんが、DataExportColHeaderオプションで指定された密ディメンションは、エクスポート・ファイルで他のデータが参照されるフォーカスです。

    • 欠落しているデータおよび無効なデータはスキップされ、出力では連続したデリミタ(カンマ)が使用されます。 DATAEXPORTのオプションの「missing_char」パラメータは無視されます。

  • OFF-Default. データは、リレーショナル・データベースへの入力として使用するように明示的に書式設定されていません。

説明

DATAEXPORTでDataExportRelationalFileオプションを使用すると、リレーショナル・データベースの入力ファイルとして直接使用されるテキスト・エクスポート・ファイルをフォーマットできます。

例

SET DATAEXPORTOPTIONS {
 DataExportLevel "ALL";
 DataExportRelationalFile ON;
};

FIX (Jan)
 DATAEXPORT "File" "," "jan.txt"
ENDFIX;

処理オプション

DataExportOverwriteFile ON | OFF

  • ON-同じ名前とロケーションの既存のファイルが置換されます。

  • OFF-Default. 同じ名前とロケーションのファイルがすでに存在する場合、ファイルは出力されません。

説明

同じ名前とロケーションの既存のファイルが置換されるかどうかを管理します。

DataExportDryRun ON | OFF

  • ON-DATAEXPORTおよび関連するコマンドは、データをエクスポートせずに実行されます。

  • OFF-Default. データがエクスポートされます

説明

計算スクリプトのデータ・エクスポート・コマンドを実行して、データをエクスポートせずに、コード化されたエクスポートに関する情報を表示できるようにします。 DataExportDryRunオプションの値がONの場合、DATAEXPORTコマンドで指定された出力ファイルに次の情報が書き込まれます:

  • データ・エクスポート設定のサマリー

  • 情報メッセージ、警告メッセージおよびエラー・メッセージ

  • エクスポートされる正確なブロック数

  • I/O時間を除く推定時間。

ノート

  • 「The DataExportDryRun」オプションは、リレーショナル・データベースへのエクスポートでは機能しません。

  • 実際のエクスポートで再利用するためにスクリプトを変更する場合は、スクリプトからDataExportDryRunオプションを削除する以外に、エクスポート・ファイルの名前を変更することもできます。

例

SET DATAEXPORTOPTIONS 
 {
 DataExportLevel "ALL";
 DataExportColHeader "Measures";
 DataExportColFormat ON;
 DataExportDimHeader ON;
 DataExportDynamicCalc OFF;
 DataExportDecimal 0;
 DataExportDryRun ON;
 DataExportOverwriteFile ON;
 };

FIX("Qtr1")
 DATAEXPORT "File" "," "log.txt" ;
ENDFIX;

次の情報を含むファイル"E:\temp\log.txt"を作成します: 

  <EXPORT_OPTIONS>
        <DELIMITER>
        ,
        </DELIMITER>
        <MISSING_VALUE>
        #Mi
        </MISSING_VALUE>
        <EXPORT_LEVEL>
        ALL
        </EXPORT_LEVEL>
        <DYNAMIC_CALC_EXPORT>
        OFF
        </DYNAMIC_CALC_EXPORT>
        <COLUMN HEADER>
        Measures
        </COLUMN HEADER>
        <COLUMN_FORMAT>
        ON
        </COLUMN_FORMAT>
        <DIMENSION_HEADER_WRITE>
        ON
        </DIMENSION_HEADER_WRITE>
    <FILE_OVERWRITE>
    ON 
    </FILE_OVERWRITE>
    <DECIMAL_POINT>
        0N
    </DECIMAL_POINT>
    <PRECISION POINT>
    16
    </PRECISION_POINT>
    <RELATIONAL_EXPORT>
        OFF
        </RELATIONAL_EXPORT>
  </EXPORT_OPTIONS>
  <MESSAGE>
        <INFO>
        DataExport Warning: FIX statement contains Dynamic Calc member [Qtr1]. No Dynamic Calc members are exported with the DataExportDynamicCalc option set to OFF.
  </INFO>
        <INFO>
        Data Export Completed. Total blocks: [332]. Elapsed time: [3.846] secs.
        </INFO>
  </MESSAGE>