파일 기반 데이터 이전

사용자는 스프레드시트와 같은 데이터 파일을 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 파일에는 세 개의 파일이 들어 있습니다.

   • 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. 데이터 파일이 사용 가능한지 확인합니다.