Migrar Dados Baseados em Ficheiros

Os utilizadores podem carregar ficheiros de dados, tais como folhas de cálculo, para o Oracle Analytics Cloud de modo a criar conjuntos de dados. Quando migrar para um novo ambiente do Oracle Analytics Cloud, pode levar consigo estes dados baseados em ficheiros. Por vezes, problemas de conectividade da rede ou de acesso ao armazenamento poderão impedi-lo de migrar os ficheiros de dados no instantâneo. Para esses casos, o Oracle Analytics Cloud oferece um utilitário CLI (interface da linha de comandos) que lhe permite deslocar os seus ficheiros de dados para a nova localização. O utilitário CLI do instantâneo também desloca quaisquer plug-ins relacionados com mapas e ficheiros de extensões que os utilizadores poderão carregar para as respetivas visualizações de dados.

Execute o utilitário de CLI de migração de dados se vir a mensagem A reposição foi concluída com erros - falha na reposição de dados (ou semelhante) quando tentar repor um instantâneo com ficheiros de dados. Esta mensagem ocorre quando:
  • Migra conteúdo de uma região diferente.
  • Migra conteúdo do Oracle Analytics Cloud Gen 1 ou Oracle Cloud Infrastructure Classic para o Oracle Analytics Cloud Gen 2.
  • O processo de reposição falha devido a outro problema de conectividade de rede ou de acesso ao armazenamento.

O utilitário CLI permite-lhe deslocar ficheiros de dados diretamente de um ambiente para outro num único passo. Ou, se preferir, pode descarregar os dados baseados em ficheiros para um ficheiro ZIP e, em seguida, carregar os ficheiros de dados para o seu ambiente escolhido em dois passos distintos.

  1. Verifique os detalhes do ambiente.

    • Verifique se os sistemas de origem e de destino utilizam o Oracle Analytics Cloud 5.3 ou posterior. O utilitário CLI não está disponível em versões anteriores.

      Caso não tenha a certeza, pergunte ao seu representante da Oracle.

    • Verifique se os sistemas de origem e de destino estão ambos a funcionar e se o Oracle Analytics Cloud está configurado com credenciais de armazenamento válidas.

    • Verifique o seu ambiente local. Precisa do Java 1.8 ou posterior para executar o utilitário CLI.

    • Certifique-se de que consegue aceder ao ambiente de origem e ao Oracle Analytics Cloud de destino a partir do ambiente local onde pretende executar o utilitário CLI.

    • Verifique o nome e a localização do instantâneo que descarregou anteriormente que contém os seus dados baseados em ficheiros. Por exemplo, /tmp/20190307095216.bar.
  2. Descarregue o utilitário CLI.
    1. No seu Oracle Analytics Cloud de destino, clique em Consola e, em seguida, clique em Instantâneos.
    2. Clique no menu Página menu Página e selecione Descarregar Utilitário de Migração de Dados.
      Siga as instruções para gravar o ficheiro migrate-oac-data.zip localmente.
  3. Descomprima o migrate-oac-data.zip.

    O ficheiro ZIP contém três ficheiros:

    • migrate-oac-data.jar
    • config.properties
    • readme
  4. Se pretender migrar ficheiros de dados armazenados no seu ambiente de origem diretamente para o destino num único passo, configure a secçã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>
  5. Se pretender descarregar primeiro os ficheiros de dados do seu Oracle Analytics Cloud de origem para o seu ambiente local e, subsequentemente, carregar os ficheiros de dados para o ambiente do Oracle Analytics Cloud de destino, configure as secções [DownloadDataFiles] e [UploadDataFiles] 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>
  6. Execute o ficheiro migrate-oac-data.jar no seu ambiente local.

    Sintaxe:

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

    Em que:

    • -config configfile: Nome do ficheiro config.properties

    • -d: Descarrega dados localmente utilizando informações em config.properties

    • -help: Apresenta o auxílio

    • -m: Migra dados utilizando informações de origem e de destino no ficheiro config.properties

    • -u: Carrega dados utilizando informações do ficheiro config.properties

    Por exemplo, para migrar ficheiros de dados num único passo:

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

    Por exemplo, para descarregar ficheiros de dados localmente:

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

    Por exemplo, para carregar ficheiros de dados:

    java -jar migrate-oac-data.jar -u -config config.properties
  7. Entre em sessão no seu Oracle Analytics Cloud de destino.
  8. Para expor os ficheiros de dados no Oracle Analytics Cloud, deve repor o instantâneo que utilizou para migrar o resto do seu conteúdo pela segunda vez. Desta vez, deve selecionar a opção de reposição Customizado.
    1. Abra a Consola e clique em Instantâneos.
    2. Selecione o instantâneo com os seus ficheiros de dados.
    3. Selecione a opção de reposição Customizado e, em seguida, selecione a opção Dados baseados em ficheiros.
      Anule a seleção de todas as outras opções.
    4. Clique em Repor.
  9. Verifique se os seus ficheiros de dados estão disponíveis.