選択的および順序付きのアーティファクトのインポート

Essbaseのアーティファクトのインポートは、選択リスト・テキスト・ファイルを使用して制御できます。このファイルには、11gの移行用(11g LCMエクスポート・ユーティリティを使用)とクラウド・サービスの移行用(CLIユーティリティを使用)があります。

選択リストのテキスト・ファイルには、セクションごとにグループ化された、エクスポートされたzip内のすべてのアーティファクトのリストが含まれています。lcmexportコマンドを使用して、エクスポート時にファイルを生成できます。ファイルの最後には、インポートされるアーティファクト・エントリのリストを含むIMPORTセクションがあります。

lcmimportコマンドを使用して、ファイルを編集し、インポートでスキップするアーティファクトの行を削除またはコメント化できます。lcmimport操作の引数としてテキスト・ファイルを指定します。インポートの順序を制御することもできます。

サンプルの選択リストのテキスト・ファイル

@Provisions
/Sample/Provisions/CalcAssociation.csv

@Databases/Basic/Calc_scripts
/Sample/Databases/Basic/Calc scripts/Default Calc
/Sample/Databases/Basic/Calc scripts/CalcAll.csc

# ------------IMPORT-----------------
import @Provisions
import @Databases/Basic/Calc_scripts
# ------------IMPORT----------------

この機能を使用する方法

  • エクスポートに11g LCMエクスポート・ユーティリティを使用する場合は、オプションの引数–generateartifactlistを指定してエクスポートされるアーティファクトのリストが含まれているテキスト・ファイルを生成できます。
  • .rulファイルのようなファイルの完全なカテゴリをスキップするには、テキスト・ファイルの最後にある、対応するIMPORTセクションをコメント化します。
  • 特定のファイルをスキップするには、テキスト・ファイル内のそのエントリを削除またはコメント化します。
  • インポート順序を制御するには、特定のカテゴリの下のエントリをインポートしたい順序に並べ替えます。ファイルは、そのカテゴリの下にリストされている順序でインポートされます。インポートの際に、次を使用してこのファイルを指定します。
    -al,-artifactlist
  • lcmimportコマンドには-overwriteオプションがあります。
    • –overwriteがtrueの場合は、インポート操作でアプリケーション全体が再作成されます。テキスト・ファイルにリストされているアーティファクトまたはファイルのみがインポートされます。
    • –overwriteがfalseの場合、インポート操作では、テキスト・ファイルでコメント化されていないアーティファクトまたはファイルのみがインポートされます。ターゲット・アプリケーションにすでに存在する他のアーティファクトには影響しません。

サンプルのユースケース

  • エクスポートされたzipからデータのみをインポート

    Sampleアプリケーションのエクスポートされたzipがあり、Sample/Basicからデータのみをインポートします。

    • lcmexport時に生成されたテキスト・ファイルで、import @Databases/Basic以外のすべてののインポート・エントリをコメントにします。
    • また、データのみをインポートするために、@Databases/Basicの下の/Sample/Databases/Basic/Basic outlineもコメント化します。
    • このユース・ケース(データのみのインポート)では、-overwriteオプションが無効であることに注意してください。理由は、インポート時にLCMではアプリケーション全体を削除し、ブランクとしてインポートするためです。その後、アウトラインなしでデータのみをインポートしようとするため、アプリケーションは無効になります。
  • アウトラインのみをインポート

    エクスポートされたzipからアウトラインのみを持つSample.Basicキューブを更新します。

    • テキスト・ファイルの最後にあるIMPORTセクションで、"import @Databases/Basic"以外のすべてのエントリをコメントにします。
    • アウトラインのみをインポートするために、"@Databases/Basic"の下の"/Sample/Databases/Basic/Data"もコメント化します。
  • 複数のキューブを持つアプリケーションの単一のキューブをインポート

    サンプル・アプリケーションには、Basic、Basic1、Basic2という名前の3つのキューブがあり、Basicのみをインポートします。

    • テキスト・ファイルの最後にあるIMPORTセクションで、"Basic"キューブ以外のすべてのエントリがコメント化されます(import @Databases/Basic、import @Databases/Basic/Xml_filesなど)。
    • -overwriteオプションを指定しないと、Basicキューブのみがインポートまたはオーバーライドされますが、そのアプリケーション内の他のキューブ(Basic1、Basic2)は影響を受けてず、そのまま残ります。
    • -overwriteオプションを指定すると、Basicキューブのみを使用して、アプリケーションを削除して再作成します。