機械翻訳について

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

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

データファイルを含むスナップショットをリストアしようとしたときに、メッセージRestore succeeded with errors - data restore failed (または同様)が表示された場合は、データ移行CLIユーティリティを実行します。 これは、次の場合に発生します:

• コンテンツを別のリージョンから移行する。
• Gen 1またはOracle Cloud Infrastructure ClassicのOracle Analytics CloudからGen 2のOracle Analytics Cloudにコンテンツを移行します。
• 復元プロセスが、一部のその他のネットワーク接続またはストレージ・アクセスの問題により失敗した。

CLIユーティリティを使用すると、1回のステップでデータ・ファイルを環境間で移行できます。 または、ファイルベースのデータをZIPファイルにダウンロードし、選択した環境に2つの異なるステップでデータ・ファイルをアップロードすることもできます。

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

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

     不明な場合は、Oracle担当者に確認してください。

   • ソースとターゲットのシステムが両方とも稼働していること、および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. ソース環境に格納されているデータファイルを単一のステップのターゲットに直接移行する場合は、セクション[MigrateData]をconfig.propertiesで構成します。

   [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でデータファイルを公開するには、残りのコンテンツの移行に使用したスナップショットを再度リストアする必要があります。 今回は、「カスタム」リストア・オプションを選択する必要があります。
   1. コンソールを開き、「スナップショット」をクリックします。
   2. データ・ファイルを含むスナップショットを選択します。
   3. 「カスタム」リストア・オプションを選択し、「ファイルベースのデータ」オプションを選択します。
      その他のすべてのオプションの選択を解除します。
   4. 「リストア」をクリックします。
9. データ・ファイルが使用可能であることを確認します。