Migrar Dados Baseados em Arquivo

Os usuários fazem upload de arquivos de dados, como planilhas, no Oracle Analytics Cloud para criar conjuntos de dados. Ao migrar para um novo ambiente do Oracle Analytics Cloud, você poderá levar esses dados baseados em arquivo. Às vezes, problemas de conectividade de rede ou acesso ao armazenamento podem impedir você de migrar os arquivos de dados no snapshot. Nesses casos, o Oracle Analytics Cloud oferece um utilitário de CLI (interface da linha de comando) que permite a você mover seus arquivos de dados para o novo local. O utilitário de CLI de snapshot também move qualquer plug-in e arquivo de extensão relacionados a mapa que os usuários podem carregar por upload em suas visualizações de dados.

Execute o utilitário da CLI de migração de dados caso você veja a mensagem Restore succeeded with errors - data restore failed (ou semelhante) quando tentar restaurar um snapshot que contém arquivos de dados. Essa mensagem ocorre quando:

Você migra conteúdo de outra região.
Você migra conteúdo do Oracle Analytics Cloud Geração 1 ou do Oracle Cloud Infrastructure Classic para o Oracle Analytics Cloud Geração 2.
O processo de restauração falha por causa de algum problema de conectividade de rede ou acesso ao armazenamento.

O utilitário de CLI permite que você mova os arquivos de dados diretamente de um ambiente para outro em uma única etapa. Ou, se preferir, você poderá fazer download dos dados baseados em arquivo para um arquivo ZIP e, em seguida, fazer upload dos arquivos de dados para seu ambiente escolhido em duas etapas distintas.

Verifique os detalhes do seu ambiente.
- Verifique se os sistemas de origem e de destino usam o Oracle Analytics Cloud 5.3 ou mais recente. O utilitário de CLI não está disponível em versões anteriores.
  
  Caso não tenha certeza, pergunte ao representante da Oracle.
- Verifique se os sistemas de origem e destino estão ativos e em execução e se o Oracle Analytics Cloud está configurado com credenciais de armazenamento válidas.
- Verifique seu ambiente local. Você precisa do Java 1.8 ou mais recente para executar o utilitário de CLI.
- Certifique-se de poder acessar o ambiente de origem e o Oracle Analytics Cloud de destino no ambiente local em que você planeja executar esse utilitário.
- Confirme se o nome e o local do snapshot que você baixou anteriormente contêm os dados baseados em arquivo. Por exemplo, /tmp/20190307095216.bar.
Faça o download do utilitário de CLI.
1. No Oracle Analytics Cloud de destino, clique em Console e depois clique em Snapshots.
2. Clique no menu Página e selecione Fazer Download do Utilitário de Migração de Dados.
  Siga as instruções para salvar o arquivo migrate-oac-data.zip localmente.
Descompacte o arquivo migrate-oac-data.zip.
O arquivo ZIP contém três arquivos:
- migrate-oac-data.jar
- config.properties
- readme

Se você quiser migrar os arquivos de dados armazenados em seu ambiente de origem diretamente para o destino em uma única etapa, configure a seção [MigrateData] em 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>

Se desejar primeiro fazer download dos arquivos de dados do Oracle Analytics Cloud de origem para o ambiente local e subsequentemente fazer upload dos arquivos de dados para o ambiente do Oracle Analytics Cloud de destino, configure as seções [DownloadDataFiles] e [UploadDataFragments] em config.properties.

[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>

Execute o arquivo migrate-oac-data.jar em seu ambiente local.
Sintaxe:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Em que:
- -config configfile : nome do arquivo config.properties
- -d : faz download dos dados localmente usando as informações em config.properties
- -help : Exibe a ajuda
- -m : migra os dados usando as informações de origem e de destino no arquivo config.properties
- -u : faz upload dos dados usando as informações no arquivo config.properties
Por exemplo, para migrar os arquivos de dados em uma única etapa:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Por exemplo, para fazer download dos arquivos de dados localmente:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Por exemplo, para fazer upload dos arquivos de dados:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Acesse o Oracle Analytics Cloud de destino.
Para expor os arquivos de dados no Oracle Analytics Cloud, restaure o snapshot que você usou para migrar o restante de seu conteúdo pela segunda vez. Dessa vez, você deve selecionar a opção de restauração Personalizar.
1. Abra a Console e clique em Snapshots.
2. Selecione o snapshot que contém seus arquivos de dados.
3. Selecione a opção de restauração Personalizado e depois selecione a opção Dados baseados em arquivo.
  Desmarque todas as outras opções.
4. Clique em Restaurar.
Verifique se seus arquivos de dados estão disponíveis.