1. Oracle Essbase計算および問合せリファレンス
  2. 計算コマンド
  3. 計算コマンド・リスト
  4. SET DATAEXPORTOPTIONS

SET DATAEXPORTOPTIONS

SET DATAEXPORTOPTIONS計算コマンドは、Essbaseデータベース・エクスポート操作のオプションを指定します。

構文

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;
  DataExportCSVFormat ON | OFF
  DataExportOverwriteFile ON | OFF;
  DataExportDryRun ON | OFF;
  };

ノート

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

オプション・リストは、左中カッコ({)で始まり、右中カッコの後にセミコロン(};)で終わる必要があります。各オプションの末尾にはセミコロンを付けます。オプションは任意の順序でリストに含められます。オプションが指定されていない場合、デフォルト値とみなされます。

オプションのカテゴリを次に示します:

コンテンツ・オプション

DataExportLevel ALL | LEVEL0 | INPUT

  • ALL—(デフォルト)連結と計算結果を含むすべてのデータ。

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

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

DataExportLevelオプションの値を指定する際は、次のガイドラインを使用してください。

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

  • 値を引用符で囲むことは省略できます。たとえば、LEVEL0または"LEVEL0"を指定できます。

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

  • 値が正しく表現されていない場合(たとえば、LEVEL 0またはLEVEL2)、Essbaseはデフォルト値のALLを使用します。

Description

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

DataExportDynamicCalc ON | OFF

  • ON—(デフォルト)動的に計算された値がエクスポートに含まれます。

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

Description

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

ノート:

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

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

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

DataExportNonExistingBlocks ON | OFF

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

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

Description

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

DataExportPrecision n

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

Description

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オプションが指定されている場合、このオプションの値によって決定されます。

Description

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: デフォルト。データは非列形式で出力されます。

Description

データを列形式で出力するかどうかを指定します。列形式では、すべてのディメンションのメンバー名が表示されます。名前は行ごとに繰り返されるようにできるため、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

Description

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

ノート

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

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

例

SET DATAEXPORTOPTIONS {DATAEXPORTCOLHEADER Scenario;};

エクスポート・ファイルのページ・ヘッダーとしてScenarioを指定します。Scenarioディメンションには、Scenario、Actual、Budgetの3つのメンバーが含まれています。最初にすべてのScenarioデータが表示され、次にすべてのActualデータ、次にすべてのBudgetデータが表示されます。

DataExportDimHeader ON | OFF

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

  • OFF: デフォルト。ヘッダー・レコードは含まれません。

Description

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: 出力テキスト・エクスポート・ファイルは、リレーショナル・データベースにインポートするための形式になります。

    • データは列形式です。スパース・メンバー名が繰り返されます。DataExportColFormatオプションは無視されます。

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

    • 欠落している無効なデータはスキップされ、出力に連続した区切り文字(コンマ)が生成されます。DATAEXPORTのオプションの"missing_char"パラメータは無視されます。

  • OFF: デフォルト。データは、明示的にはリレーショナル・データベースへの入力として使用するための形式になりません。

Description

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

例

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

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

DataExportCSVFormat ON | OFF

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

  • OFF: デフォルト。データはCSV以外の形式で出力されます。

Description

データをCSV (カンマ区切り値)形式で出力するかどうかを指定します。このオプションは、DBMS_CLOUDパッケージに必要な形式でデータをエクスポートするために役立ちます(フェデレーテッド・パーティションを使用してキューブをAutonomous Data Warehouseと統合する場合に適用可能)。ファクト表のピボット・ディメンションをDataExportColHeaderとして指定すると、DBMS_CLOUDに必要な形式でデータファイルを生成できます: 列名はヘッダーにあり、各データ・レコードのフィールドはカンマで区切られます。

例1: ピボット・ディメンションはMeasures

SET DATAEXPORTOPTIONS
  {
  DataExportColHeader "Measures";
  DataExportOverwriteFile ON;
  DATAEXPORTDIMHEADER ON;
  DATAEXPORTCSVFORMAT ON;
  };
  DATAEXPORT "File" "," "out.txt" "NULL";

例1の出力

"Year","Product","Market","Scenario","Sales","COGS","Margin","Marketing","Payroll","Misc","Total Expenses","Profit","Opening Inventory","Additions","Ending Inventory"
"Jan","100-10","New York","Actual",678,271,407,94,51,0,145,262,2101,644,2067
"Feb","100-10","New York","Actual",645,258,387,90,51,1,142,245,2067,619,2041
"Mar","100-10","New York","Actual",675,270,405,94,51,1,146,259,2041,742,2108

例2: ピボット・ディメンションはYear

SET DATAEXPORTOPTIONS
  {
  DataExportColHeader "Year";
  DataExportOverwriteFile ON;
  DATAEXPORTDIMHEADER ON;
  DATAEXPORTCSVFORMAT ON;
  };
  DATAEXPORT "File" "," "out.txt" "NULL";

例2の出力

"Product","Market","Scenario","Measures","Jan","Feb","Mar","Apr","May","Jun","Jul","Aug","Sep","Oct","Nov","Dec"
"100-10","Utah","Actual","Additions",1762.0,1681.0,1482.0,1201.0,1193.0,1779.0,2055.0,1438.0,1991.0,1443.0,1379.0,1415.0
"100-10","Utah","Actual","COGS",598.0,714.0,630.0,510.0,510.0,756.0,697.0,533.0,624.0,535.0,536.0,600.0
"100-10","Utah","Actual","Ending Inventory",5417.0,8379.0,10294.0,4125.0,3823.0,7861.0,7283.0,4636.0,6383.0,9805.0,9247.0,8757.0
"100-10","Utah","Actual","Margin",383.0,449.0,363.0,389.0,431.0,445.0,458.0,394.0,401.0,350.0,353.0,437.0
"100-10","Utah","Actual","Marketing",201.0,240.0,210.0,171.0,171.0,254.0,235.0,178.0,209.0,180.0,180.0,202.0
"100-10","Utah","Actual","Misc",2.0,1.0,3.0,1.0,1.0,0.0,0.0,3.0,2.0,2.0,1.0,0.0
"100-10","Utah","Actual","Opening Inventory",4636.0,7861.0,9805.0,3823.0,3571.0,7283.0,6383.0,4125.0,5417.0,9247.0,8757.0,8379.0
"100-10","Utah","Actual","Payroll",121.0,116.0,116.0,116.0,116.0,116.0,121.0,116.0,121.0,116.0,116.0,116.0
"100-10","Utah","Actual","Profit",59.0,92.0,34.0,101.0,143.0,75.0,102.0,97.0,69.0,52.0,56.0,119.0

処理オプション

DataExportOverwriteFile ON | OFF

  • ON: 同じ名前と場所の既存のファイルが置き換えられます。

  • OFF: デフォルト。同じ名前と場所のファイルがすでに存在する場合、ファイルは出力されません。

Description

同じ名前と場所の既存のファイルを置き換えるかどうかを管理します。

DataExportDryRun ON | OFF

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

  • OFF: デフォルト。データがエクスポートされます

Description

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

  • データ・エクスポート設定の概要

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

  • エクスポートするブロックの正確な数

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

ノート

  • 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>