Op bestanden gebaseerde gegevens migreren

Gebruikers kunnen gegevensbestanden, zoals spreadsheets, uploaden naar Oracle Analytics Cloud om gegevenssets te maken. Wanneer u migreert naar een nieuwe Oracle Analytics Cloud omgeving, kunt u deze op bestanden gebaseerde gegevens meenemen. Soms kunt u door problemen met de netwerkverbinding of opslagtoegang de gegevensbestanden niet migreren in de snapshot. Voor dergelijke gevallen biedt Oracle Analytics Cloud een CLI-hulpprogramma (Command-Line Interface) waarmee u gegevensbestanden naar de nieuwe locatie kunt verplaatsen. Met het CLI-hulpprogramma voor snapshots kunnen kaartgerelateerde plug-ins en uitbreidingsbestanden worden verplaatst die gebruikers kunnen uploaden voor hun gegevensvisualisaties.

Voer het CLI-hulpprogramma voor gegevensmigratie alleen uit als u een melding krijgt in de trant van Herstel geslaagd met fouten - Gegevensherstel is mislukt wanneer u een snapshot probeert te herstellen dat gegevensbestanden bevat. Dit bericht wordt weergegeven wanneer:

U vanuit een andere regio migreert.
U content migreert vanuit Oracle Analytics Cloud op Gen 1 of vanuit Oracle Cloud Infrastructure Classic migreert naar Oracle Analytics Cloud op Gen 2.
Het herstelproces mislukt vanwege andere problemen met netwerkverbindingen of toegang tot opslag.

Met het CLI-hulpprogramma kunt u gegevensbestanden in één stap rechtstreeks van de ene naar de andere omgeving verplaatsen. Als u dat prettiger vindt, kunt u ook de op bestanden gebaseerde gegevens naar een zipbestand downloaden en vervolgens de gegevensbestanden in twee afzonderlijke stappen naar de door u gekozen omgeving uploaden.

Controleer de omgevingsdetails.
- Verifieer of zowel het bron- als doelsysteem gebruikmaakt van Oracle Analytics Cloud 5.3 of hoger. In eerdere versies is het CLI-hulpprogramma niet beschikbaar.
  
  Als u niet weet welke versie u hebt, neemt u contact op met uw Oracle vertegenwoordiger.
- Controleer of zowel het bron- als doelsysteem actief zijn en of Oracle Analytics Cloud is geconfigureerd met geldige opslagreferenties.
- Controleer uw lokale omgeving. Voor het uitvoeren van het CLI-hulpprogramma is Java 1.8 of hoger vereist.
- Controleer of u vanuit de lokale omgeving waar u het CLI-hulpprogramma wilt gebruiken, toegang hebt tot de bronomgeving en het Oracle Analytics Cloud doel.
- Controleer de naam en de locatie van de snapshot die u eerder hebt gedownload en die uw op bestanden gebaseerde gegevens bevat. Bijvoorbeeld /tmp/20190307095216.bar.
Het CLI-hulpprogramma downloaden
1. Klik in uw Oracle Analytics Cloud doel op Console en vervolgens op Snapshots.
2. Klik op het menu 'Pagina' en selecteer Hulpprogramma voor gegevensmigratie downloaden.
  Volg de instructies om het bestand migrate-oac-data.zip lokaal op te slaan.
Decomprimeer migrate-oac-data.zip.
Het ZIP-bestand bevat drie bestanden:
- migrate-oac-data.jar
- config.properties
- readme

Als u gegevensbestanden die in de bronomgeving zijn opgeslagen, in één stap rechtstreeks naar het doel wilt migreren, configureert u de sectie [MigrateData] in 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>

Als u eerst gegevensbestanden van uw Oracle Analytics Cloud bron wilt downloaden naar uw lokale omgeving om de gegevens vervolgens naar de Oracle Analytics Cloud doelomgeving te uploaden, configureert u de secties [DownloadDataFiles] en [UploadDataFiles] in 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>

Voer het bestand migrate-oac-data.jar uit in uw lokale omgeving.
Syntaxis:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Hierbij geldt het volgende:
- -config configfile: naam van het bestand config.properties
- -d: gegevens lokaal downloaden met behulp van de gegevens in config.properties
- -help: help weergeven
- -m: gegevens migreren met behulp van de gegevens over bron en doel in het bestand config.properties
- -u: gegevens uploaden met behulp van de gegevens in het bestand config.properties
Voorbeeld voor het in één stap migreren van gegevensbestanden:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Voorbeeld voor het lokaal downloaden van gegevensbestanden:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Voorbeeld voor het uploaden van gegevensbestanden:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Meld u aan bij het Oracle Analytics Cloud doel.
Als u de gegevensbestanden in Oracle Analytics Cloud wilt weergeven, moet u de gebruikte snapshot terugzetten om de rest van uw inhoud nogmaals te migreren. Selecteer deze keer de optie Aangepast.
1. Open de console en klik op Snapshots.
2. Selecteer de snapshot die de gegevensbestanden bevat.
3. Selecteer de hersteloptie Aangepast en selecteer vervolgens de optie Op bestanden gebaseerde gegevens.
  Deselecteer alle overige opties.
4. Klik op Terugzetten.
Controleer of uw gegevensbestanden nu beschikbaar zijn.