ファイルベース・データの移行

ユーザーは、スプレッドシートなどのデータ・ファイルをOracle Analytics Cloudにアップロードしてデータセットを作成します。新しいOracle Analytics Cloud環境に移行するとき、このファイルベースのデータを取得できます。場合によっては、ネットワークの接続性またはストレージ・アクセスの問題により、スナップショットのデータ・ファイルを移行できないことがあります。そのような場合のために、Oracle Analytics Cloudには、新しい場所へのデータ・ファイルの移動を可能にするCLIユーティリティ(コマンドライン・インタフェース)が用意されています。スナップショットCLIユーティリティで、データ・ビジュアライゼーション用にユーザーがアップロードする可能性のあるマップ関連のプラグインおよび拡張ファイルも移行されます。

1. 環境の詳細を確認します。

   • ソースとターゲットの両方のシステムで、Oracle Analytics Cloud 5.3以降を使用していることを確認します。以前のバージョンではCLIユーティリティを使用できません。

     よくわからない場合、オラクル社の担当に問い合せてください。

   • ソースとターゲットの両方のシステムが稼働中であり、Oracle Analytics Cloudが有効なストレージ資格証明を使用して構成されていることを確認します。

   • ローカル環境を確認します。CLIユーティリティを実行するには、Java 1.8以上が必要です。

   • CLIユーティリティを実行する予定のローカル環境から、ソース環境およびターゲットのOracle Analytics Cloudにアクセスできることを確認します。

   • ファイルベースのデータが含まれている、以前にダウンロードしたスナップショットの名前および場所を確認します。たとえば、/tmp/20190307095216.barなどです。
2. CLIユーティリティをダウンロードします。
   1. ターゲットのOracle Analytics Cloudで、「コンソール」、「スナップショット」の順にクリックします。
   2. 「ページ・メニュー」をクリックし、「データ移行ユーティリティのダウンロード」を選択します。
      指示に従ってmigrate-oac-data.zipファイルをローカルに保存します。
3. migrate-oac-data.zipを解凍します。

   ZIPファイルには次の3つのファイルが含まれます:

   • migrate-oac-data.jar
   • config.properties
   • readme
4. 1回のステップで、ソース環境に保存されているデータ・ファイルをターゲットに直接移行する場合は、config.propertiesの[MigrateData]セクションを構成します。

   [MigrateData]
   # Migrate data files from a source Oracle Analytics Cloud environment (OAC) to a target Oracle Analytics Cloud environment.
       # Specify the source environment as Oracle Analytics Cloud.
         SOURCE_ENVIRONMENT=OAC
       # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
         SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

       # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
         SOURCE_USERNAME=<Source Administrator User Name>
       # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
         BAR_PATH=<Path to Source Snapshot>
       # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
         TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
       # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
         TARGET_USERNAME=<Target Administrator User Name>

5. 最初にソースのOracle Analytics Cloudからローカル環境にデータ・ファイルをダウンロードし、次にターゲットのOracle Analytics Cloud環境にデータ・ファイルをアップロードする場合、config.propertiesの[DownloadDataFiles]および[UploadDataFiles]セクションを構成します。

   [DownloadDataFiles]
   #Download Data Files: Download data files from Oracle Analytics Cloud storage to a local repository
       # Specify the source environment as Oracle Analytics Cloud.
         SOURCE_ENVIRONMENT=OAC
       # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
         SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

       # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
         SOURCE_USERNAME=<Source Administrator User Name>
       # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
         BAR_PATH=<Path to Source Snapshot>
       # Local data file directory. Make sure you have enough space to download the data files to this directory. For example: /tmp/mydatafiledir 
         DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
        # Data fragment size. Data files are downloaded in fragments. Default fragment size is 500MB.
         MAX_DATA_FRAGMENT_SIZE_IN_MB=500

   [UploadDataFiles]
   #Upload data files: Upload data files to the target Oracle Analytics Cloud. 
       # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
         TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
       # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
         TARGET_USERNAME=<Target Administrator User Name>
       # Local directory containing the data files you want to upload. For example: /tmp/mydatafiledir
         DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
       # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
         BAR_PATH=<Path to Source Snapshot>

6. ローカル環境でmigrate-oac-data.jarファイルを実行します。

   構文:

   migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]

   ここで:

   • -config configfile : config.propertiesファイルの名前

   • -d : config.propertiesの情報を使用して、データをローカルにダウンロードします

   • -help : ヘルプを表示します

   • -m : config.propertiesファイルのソースおよびターゲット情報を使用してデータを移行します

   • -u : config.propertiesファイルの情報を使用してデータをアップロードします

   たとえば、1回のステップでデータ・ファイルを移行するには、次のように指定します。

   java -jar migrate-oac-data.jar -m -config config.properties

   たとえば、データ・ファイルをローカルにダウンロードするには、次のように指定します。

   java -jar migrate-oac-data.jar -d -config config.properties

   たとえば、データ・ファイルをアップロードするには、次のように指定します。

   java -jar migrate-oac-data.jar -u -config config.properties

7. ターゲットのOracle Analytics Cloudにサインインします。
8. Oracle Analytics Cloudでデータ・ファイルを公開するには、2回目の残りのコンテンツの移行で使用したスナップショットをリストアする必要があります。今回は、「カスタム」復元オプションを選択する必要があります。
   1. コンソールを開き、「スナップショット」をクリックします。
   2. データ・ファイルが含まれるスナップショットを選択します。
   3. 「カスタム」復元オプションを選択し、「ファイルベース・データ」オプションを選択します。
      他のすべてのオプションを選択解除します。
   4. 「リストア」をクリックします。
9. データ・ファイルが使用可能であることを確認します。