Migrácia dát založených na súbore

Používatelia nahrávajú dátové súbory, ako sú hárky, do služby Oracle Analytics Cloud na vytváranie množín dát. Keď vykonávate migráciu do nového prostredia Oracle Analytics Cloud, môžete preniesť tieto dáta zo súborov. Migrácii dátových súborov v snímke môžu niekedy brániť problémy s pripojením k sieti alebo s prístupom k ukladaciemu priestoru. V takýchto prípadoch služba Oracle Analytics Cloud poskytuje utilitu CLI (rozhranie príkazového riadka), ktorá umožňuje presunúť dátové súbory na nové miesto. Utilita CLI snímky dát tiež presunie všetky pluginy súvisiace s mapovaním a súbory rozšírení, ktoré môžu používatelia nahrať pre vizualizácie dát.

Utilitu migrácie dát CLI spúšťajte v prípade, že pri pokuse o obnovenie snímky obsahujúcej dátové súbory sa zobrazí hlásenie Restore succeeded with errors - data restore failed (Obnovenie bolo úspešné s chybami - obnovenie dát zlyhalo) (alebo hlásenie s podobným znením). Toto hlásenie sa zobrazí, keď:

Migrujete obsah z inej oblasti.
Migrujete obsah zo služby Oracle Analytics Cloud on Gen 1 alebo Oracle Cloud Infrastructure Classic do služby Oracle Analytics Cloud on Gen 2.
Na obnovenie po zlyhaní procesu z dôvodu problému s pripojením nejakej inej siete alebo s prístupom k ukladaciemu priestoru.

Utilita CLI umožňuje priamo presunúť dátové súbory z jedného prostredia do druhého v jedinom kroku. Môžete tiež stiahnuť svoje dáta založené na súbore do súboru ZIP a potom nahrať dátové súbory do vybraného prostredia v dvoch oddelených krokoch.

Skontrolujte detaily prostredia.
- Overte, či zdrojové aj cieľové systémy používajú službu Oracle Analytics Cloud 5.3 alebo novšiu. Utilita CLI nie je v starších verziách k dispozícii.
  
  Ak nemáte istotu, spýtajte sa zástupcu spoločnosti Oracle.
- Skontrolujte, či sú zdrojové aj cieľové systémy v prevádzke a či je služba Oracle Analytics Cloud nakonfigurovaná pomocou platných dokladov ukladacieho priestoru.
- Skontrolujte lokálne prostredie. Na spustenie utility CLI sa vyžaduje Java, verzia 1.8 alebo novšia.
- Skontrolujte, či môžete získať prístup k zdrojovému prostrediu a cieľovej službe Oracle Analytics Cloud z lokálneho prostredia, v ktorom plánujete spustiť utilitu CLI.
- Overte názov a umiestnenie stiahnutej snímky, ktorá obsahuje dáta súborov. Napríklad /tmp/20190307095216.bar.
Stiahnite si utilitu CLI.
1. V cieľovej službe Oracle Analytics Cloud kliknite na položku Konzola a potom na položku Snímky.
2. Kliknite na ponuku stránky a vyberte položku Stiahnuť utilitu migrácie dát.
  Podľa pokynov lokálne uložte súbor migrate-oac-data.zip.
Dekomprimujte súbor migrate-oac-data.zip.
Súbor zip obsahuje tri súbory:
- migrate-oac-data.jar
- config.properties
- readme

Ak chcete migrovať dátové súbory, ktoré sú uložené v zdrojovom prostredí, priamo do cieľového prostredia v jednom kroku, nakonfigurujte časť [MigrateData] v súbore 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>

Ak chcete najprv stiahnuť dátové súbory zo zdrojového prostredia Oracle Analytics Cloud do lokálneho prostredia a potom ich nahrať do cieľového prostredia Oracle Analytics Cloud, nakonfigurujte časti [DownloadDataFiles] a [UploadDataFiles] v súbore 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>

Spustite súbor migrate-oac-data.jar vo svojom lokálnom prostredí.
Syntax:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Kde:
- -config configfile: názov súboru config.properties
- -d: stiahne dáta do lokálneho prostredia pomocou informácií v súbore config.properties
- -help: zobrazí pomoc
- -m: migruje dáta pomocou informácií o zdrojovom a cieľovom prostredí v súbore config.properties
- -u: nahrá dáta pomocou informácií o zdrojovom a cieľovom prostredí v súbore config.properties
Ak napríklad chcete migrovať dátové súbory v jednom kroku:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Ak napríklad chcete stiahnuť dátové súbory do lokálneho prostredia:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Ak napríklad chcete nahrať dátové súbory:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Prihláste sa do cieľového prostredia Oracle Analytics Cloud.
Ak chcete sprístupniť dátové súbory v službe Oracle Analytics Cloud, je potrebné, aby ste snímku, ktorú ste použili na migráciu zvyšku obsahu, obnovili druhýkrát. Tentokrát vyberte voľbu obnovenia Vlastné.
1. Otvorte konzolu a kliknite na položku Snímky.
2. Vyberte snímku obsahujúcu dátové súbory.
3. Vyberte voľbu obnovenia Vlastné a potom vyberte voľbu Dáta založené na súbore.
  Zrušte výber všetkých ostatných volieb.
4. Kliknite na položku Obnoviť.
Skontrolujte, či sú dátové súbory k dispozícii.