移轉檔案型資料

使用者可以將資料檔案 (例如試算表) 上傳至 Oracle Analytics Cloud 以建立資料集。移轉至新的 Oracle Analytics Cloud 環境時，可以將此檔案型資料一併進行移轉。有的時候，您可能會因為網路連線或儲存存取問題，而無法在快照中移轉資料檔案。針對這類情況，Oracle Analytics Cloud 提供 CLI 公用程式 (命令行介面)，可讓您將資料檔移至新位置。快照 CLI 公用程式也會一併移動所有地圖相關 Plug-in，以及使用者可能上傳以用於其資料視覺化的擴充檔案。

嘗試回復包含資料檔案的快照時，若見到回復成功，但有錯誤 - 資料回復失敗或類似訊息時，請執行資料移轉 CLI 公用程式。以下情況會出現此訊息：
  • 移轉其他區域的內容。
  • 將 Oracle Analytics Cloud (Gen 1) 或 Oracle Cloud Infrastructure Classic 的內容移轉至 Oracle Analytics Cloud (Gen 2)。
  • 回復處理作業因發生某些其他的網路連線或儲存存取問題而失敗。

CLI 公用程式讓您只需要單一步驟，就能將資料檔從一個環境直接移至另一個環境。或者，也可以採用兩個步驟，亦即先將檔案型資料下載成壓縮檔，再將資料檔案上傳至選擇的環境。

  1. 檢查您的環境詳細資訊。

    • 確認來源和目標系統都使用 Oracle Analytics Cloud 5.3 或更新版本。較舊的版本並未提供 CLI 公用程式。

      如果您不確定，請詢問您的 Oracle 業務代表。

    • 確定來源和目標系統都已啟動並在執行中，而且 Oracle Analytics Cloud 已設定有效的儲存證明資料。

    • 檢查本機環境。您需要有 Java 1.8 或更新版本，才能夠執行 CLI 公用程式。

    • 確定可從計畫執行 CLI 公用程式的本機環境存取來源環境和目標 Oracle Analytics Cloud。

    • 檢查先前下載內含檔案型資料的快照名稱和位置。例如 /tmp/20190307095216.bar。
  2. 下載 CLI 公用程式。
    1. 在目標 Oracle Analytics Cloud 中，依序按一下主控台和快照。
    2. 按一下頁面功能表 頁面功能表，然後選取下載資料移轉公用程式。
      依指示將 migrate-oac-data.zip 檔案儲存到本機。
  3. 解壓縮 migrate-oac-data.zip。

    壓縮檔會包含 3 個檔案：

    • migrate-oac-data.jar
    • config.properties
    • readme
  4. 如果希望只用單一步驟就將來源環境中儲存的資料檔案直接移轉至目標環境，請設定 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 檔案中的資訊上傳資料

    例如，若要透過單一步驟移轉資料檔案：

    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. 確認您的資料檔案可以使用。