フェデレーテッド・パーティションのデータ・ロード

Essbaseフェデレーテッド・パーティション・キューブから、Autonomous Data Warehouseのファクト表にデータをロードできます。それを実行するには、EssbaseをOCIオブジェクト・ストレージに統合し、configure-dbms-writebackスクリプトを使用してDBMS_CLOUD資格証明を構成する必要があります。

EssbaseとOCIオブジェクト・ストレージの統合

フェデレーテッド・パーティション・キューブからAutonomous Data Warehouseのファクト表にデータをロードするために、Essbaseは、Autonomous Databaseで使用できるDBMS_CLOUDパッケージを使用します。

DBMS_CLOUDパッケージにアクセスするには、Oracle Cloud MarketplaceからOracle Essbaseスタックをデプロイしたときに、EssbaseとOCIオブジェクト・ストレージとの統合を選択している必要があります。

完全な詳細は、フェデレーテッド・パーティションのためのMarketplaceからのEssbaseのデプロイを参照してください。

データ・ロード用の資格証明の設定

EssbaseからAutonomous Data Warehouseへのデータ・ロード操作を実行するには、その前にステップのワークフローを実行して、フェデレーテッド・パーティションで使用できるようにクラウド資格証明を有効にする必要があります。

データ・ロード資格証明ワークフローのユーザー・タイプ

次のタイプのアクセス権を持つユーザーは、データ・ロード用のフェデレーテッド・パーティション・キューブを設定するために必要なワークフローに関与しているか、関与できます。組織内で、(設定がコラボレーション可能なワークフローになるように)これらのロールを分離したり、ロールを結合したり(1人の人物が必要なすべてのアクセス権を持つ)できます。

ユーザー・タイプ ワークフロー内のロール
SSHユーザー

オペレーティング・システム・コマンド・ラインを使用して、Oracle Cloud InfrastructureにデプロイされたEssbaseインスタンスにopcユーザーとしてアクセスできます。(EssbaseをOCI上のスタックとしてデプロイした人物と同じ人物である場合があります)。
DBユーザー

Autonomous Data Warehouseスキーマ名とパスワードを知っています。これは、Oracle DatabaseへのEssbase接続を作成するために使用されたのと同じスキーマおよびパスワードです(フェデレーテッド・パーティションを作成する前の必須の前提条件)。
OCIユーザー

Essbaseカタログのオブジェクト・ストレージ・バケットを含むOCIコンソールにアクセスできます。
DB管理者

Oracle Database管理者スキーマの名前とパスワードを知っています。
Essbase管理者

Essbaseシステム管理者。(OCIユーザーの場合もある)アイデンティティ・ドメイン管理者によって作成される最初のEssbase管理者の場合があります。または、Essbaseデプロイメントの完了後に作成される別のEssbaseシステム管理者の場合があります。
Essbaseアプリケーション・マネージャ

Essbaseデプロイメントの完了後に作成されたEssbaseアプリケーションのマネージャ/所有者。

データ・ロード資格証明ワークフロー

ステップの次のワークフローは、フェデレーテッド・パーティションに使用しているデータベース・スキーマごとに完了する必要があります。

  1. OCIユーザー: フェデレーテッド・パーティションのためのMarketplaceからのEssbaseのデプロイの手順に従って、フェデレーテッド・パーティションに適した選択肢でEssbaseをOCIテナンシにデプロイします。

  2. DBユーザー、Essbase管理者、またはEssbaseアプリケーション・マネージャ: Essbase Webインタフェースにログインし、フェデレーテッド・パーティションの接続の作成の説明に従ってAutonomous Data Warehouseへの接続を作成します。

  3. DBユーザー、Essbase管理者またはEssbaseアプリケーション・マネージャ: フェデレーテッド・パーティションの作成の説明に従って、フェデレーテッド・パーティションを作成します。

  4. OCIユーザー: OCIコンソールのユーザー・プロファイルから、認証トークンを生成し、コピーします。これとユーザー名をSSHユーザーに提供します。

    認証トークンの取得を参照してください。


    生成された認証トークンをコピーするためのOCIコンソール・インタフェース

  5. SSHユーザー: OCI上のEssbaseインスタンスで使用可能なデータ・ロード準備スクリプトを実行します。スクリプトを実行する必要があるのはAutonomous Data Warehouseのデータベース・スキーマごとに1回だけです。

    例:

    1. oracleユーザーに切り替えます。

      sudo su oracle

    2. スクリプトの場所に移動します。

      cd /u01/vmtools/config/adwwb_dbms

    3. スクリプトを実行します。

      ./configure-dbms-writeback.sh

      注:

      スクリプト・オプションを表示するには、-hまたは--help引数を指定してスクリプトを実行します。構文: ./configure-dbms-writeback.sh [--help | -h]

      注:

      オプションで、vaultオプションを指定してスクリプトを実行します。このオプションは、DB管理者の資格証明をボールトに格納し、パスワードを求めるかわりにOCIDを使用してアクセスするようにスクリプトを設定します。構文: ./configure-dbms-writeback.sh [--vault | -V]

    4. 要求された場合、必要な情報を入力します:

      • vaultオプションを指定してスクリプトを実行しなかった場合は、DB管理者パスワード。パスワードは保護された情報であるため、コマンド・プロンプトへの入力時にテキストは表示されません。
      • DBユーザーのユーザー名とパスワード。パスワードは保護された情報であるため、コマンド・プロンプトへの入力時にテキストは表示されません。
      • OCIユーザーのユーザー名と認証トークン。完全なユーザーID文字列を入力します。この文字列を見つけるには、OCIコンソールで、右上隅にある「プロファイル」アイコンをクリックして、ユーザー・プロファイルの概要を表示します。「プロファイル」の下、「テナンシ」の上に表示された完全な文字列をコピーします。
        OCIコンソールの「プロファイル」の下、「テナンシ」の上に表示された完全なユーザーID文字列

    スクリプトは、必要なクラウド資格証明を作成し、データベース・スキーマ内に格納します。OCI、Essbase、またはEssbaseアプリケーションを再起動する際に、スクリプトを再実行する必要はありません。

これで、Essbaseを通じてデータをロードして、Autonomous Data Warehouseファクト表を更新できます。

注:

SSHユーザーへ – データ・ロード準備スクリプトで使用されたOCIユーザーの認証トークンがEssbaseカタログのオブジェクト・ストレージ・バケットにアクセスできなくなった場合は、データ・ロード準備ワークフローのユーザー・タイプにリストされている要件を満たす別のOCIユーザーを見つけて、ワークフローのステップを繰り返す必要があります。

フェデレーテッド・パーティションのデータ・ロードに関するその他のノート

ソース・データ・ファイルの場所

Essbaseを通じてファクト表へのデータ・ロードを実行する前に、Essbaseサーバーにデータ・ファイルをアップロードすることをお薦めします。クライアント側のデータ・ロードはサポートされますが、時間がかかります。

非Essbaseデータ・ロード・ツール

Essbaseを介したAutonomous Data Warehouseへのデータ・ロードが不要な場合は、Autonomous Databaseでデータ・ツールを使用してファクト表にデータをロードし、他の管理タスクを実行できます。ただし、キューブ・アウトラインとファクト表が非同期になっていないことを確認してください。フェデレーテッド・パーティション・キューブのメタデータに関する注意を参照してください。

DBMS形式のデータ・ファイル

Essbaseで書式設定されたデータ・エクスポート・ファイルをフェデレーテッド・パーティション・キューブにロードするのは時間がかかる場合があります。データ・ロードを最適化するには、DBMS形式のソース・ファイルを使用します。これを作成するには、DATAEXPORT計算コマンドをDataExportCSVFormatオプション付きで使用します。CSV形式のファイルは、ソース・ファイルのDBMS_CLOUDパッケージ形式のオプションに準拠しているため、より高速にロードできます。

ファクト表とデータ・ロード入力ソースのピボット・ディメンション

データ・ロード入力ファイルで使用されるピボット・ディメンションは、ファクト表のピボット・ディメンションと同じである必要があります。

たとえば、次のファクト表で、ピボット・ディメンションはメジャー・ディメンションです(Sales、COGS、Marginなど)。


SQL Developerに表示された非正規化データおよびメタデータのファクト表。"Year"、"Product"、"Market"、"Scenario"、"Sales"、"COGS"、"Margin"、"Marketing"、"Payroll"、"Misc"、"Total Expenses"、"Profit"、"Opening Inventory"、"Additions"および"Ending Inventory"という列ヘッダーがあります。

このファクト表の、許容可能なデータ・ロード入力ファイルの形状は類似しています。これは、それに同じピボット・ディメンションがあるためです。例(切捨て済):

"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

入力ファイルのピボット・ディメンションがファクト表のピボット・ディメンションと異なる場合、エラーが返されてデータ・ロード・ジョブは終了されます。

MaxLでの複数のインポート・ファイルはサポートされていない

ワイルドカード文字付きでMaxL import文を使用して複数のファイルから並列にデータをインポートすることは、フェデレーテッド・パーティション・キューブではサポートされていません。