アーティファクトの選択的かつ順序付きインポート
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」もコメント化します。
- テキスト・ファイルの最後にある
- 複数のキューブがあるアプリケーションで単一のキューブをインポート
SampleアプリケーションにはBasic、Basic1、Basic2の3つのキューブがあり、Basicのみをインポートします。
- テキスト・ファイルの最後にある
IMPORT
セクションで、Basicキューブのエントリ(import @Databases/Basic、import @Databases/Basic/Xml_filesなど)を除くすべてのエントリをコメント化します。 -overwrite
オプションを指定しない場合は、Basicキューブのみのインポートまたはオーバーライドが行われ、そのアプリケーションの他のキューブ(Basic1、Basic2)は影響を受けることなく維持されます。-overwrite
オプションを指定した場合は、アプリケーションが削除され、Basicキューブのみを使用して再作成されます。
- テキスト・ファイルの最後にある