Migrarea datelor din fişiere

Utilizatorii pot încărca fişiere de date, de exemplu, foi de calcul, în Oracle Analytics Cloud, pentru a crea seturi de date. Atunci când migraţi într-un nou mediu Oracle Analytics Cloud, puteţi lua aceste date bazate pe fişiere cu dvs. Uneori, problemele de conectare la reţea sau de acces la spaţiul de stocare vă pot împiedica să migraţi fişierele de date din instantaneu. Pentru astfel de cazuri, Oracle Analytics Cloud oferă un utilitar CLI (interfaţă pentru linia de comandă) care vă permite să vă mutaţi fişierele de date în noua locaţie. Utilitarul CLI pentru instantanee mută şi fişierele de plug-inuri şi de extensii aferente hărţilor pe care le-ar putea încărca utilizatorii pentru vizualizările lor de date.

Rulaţi utilitarul CLI doar dacă vedeţi mesajul Restore succeeded with errors - data restore failed (Restabilire reuşită, dar cu erori - Restabilirea datelor a eşuat sau altul similar) când încercaţi să restabiliţi un instantaneu ce conţine fişiere de date. Acest mesaj apare când:

Migraţi conţinut din altă regiune.
Migraţi conţinut din Oracle Analytics Cloud pe Gen 1 sau Oracle Cloud Infrastructure Classic în Oracle Analytics Cloud pe Gen 2.
Procesul de restabilire eşuează din cauza unor alte probleme de conectivitate la reţea sau de acces la stocare.

Utilitarul CLI vă permite să mutaţi fişierele de date direct dintr-un mediu în altul, într-un singur pas. Sau, dacă preferaţi, puteţi descărca datele din fişiere într-o arhivă ZIP şi puteţi apoi încărca fişierele în mediul dorit, în doi paşi separaţi.

Verificaţi detaliile mediului.
- Verificaţi dacă sistemul sursă şi cel destinaţie folosesc ambele Oracle Analytics Cloud versiunea 5.3 sau una mai nouă. Utilitarul CLI nu este disponibil în versiunile anterioare.
  
  Dacă nu ştiţi sigur, luaţi legătura cu reprezentantul Oracle.
- Asiguraţi-vă că atât sistemul sursă, cât şi cel de destinaţie sunt active şi rulează şi că Oracle Analytics Cloud este configurat cu acreditări de stocare valide.
- Verificaţi mediul dvs. local. Pentru a rula utilitarul CLI aveţi nevoie de Java 1.8 sau o versiune ulterioară.
- Asiguraţi-vă că puteţi accesa mediul sursă şi Oracle Analytics Cloud de destinaţie, din mediul local în care intenţionaţi să rulaţi utilitarul CLI.
- Verificaţi numele şi locaţia instantaneului descărcat anterior care conţine datele bazate pe fişiere. De exemplu, /tmp/20190307095216.bar.
Descărcaţi utilitarul CLI.
1. În mediul Oracle Analytics Cloud de destinaţie, faceţi clic pe Consolă, apoi pe Instantanee.
2. Faceţi clic pe meniul paginii şi selectaţi Descărcare utilitar de migrare a datelor.
  Urmaţi instrucţiunile pt. salvarea pe un disc local a fişierului migrate-oac-data.zip.
Dezarhivaţi fişierul migrate-oac-data.zip.
Fişierul ZIP conţine trei fişiere:
- migrate-oac-data.jar
- config.properties
- readme

Dacă doriţi să migraţi fişierele de date stocate în mediul sursă direct în destinaţie, într-un singur pas, configuraţi secţiunea [MigrateData] din 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>

Dacă doriţi să descărcaţi mai întâi fişiere de date din sursa Oracle Analytics Cloud în mediul dvs. local şi ulterior să încărcaţi fişierele de date în mediul Oracle Analytics Cloud destinaţie, configuraţi secţiunile [DownloadDataFiles] şi [UploadDataFiles] în 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>

Rulaţi fişierul migrate-oac-data.jar în mediul loca.
Sintaxă:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Unde:
- -config configfile: Numele fişierului config.properties
- -d: Descarcă datele local, utilizând informaţiile din config.properties
- -help: afişează resursele de ajutor
- -m: Migrează datele utilizând informaţiile despre sursă şi destinaţie din fişierul config.properties
- -u: Încarcă datele utilizând informaţiile din fişierul config.properties
De exemplu, pt. a migra fişierele de date într-un singur pas:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
De exemplu, pt. a descărca fişierele de date local:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
De exemplu, pt. a încărca fişierele de date:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Conectaţi-vă la mediul Oracle Analytics Cloud destinaţie.
Pentru a expune fişierele de date în Oracle Analytics Cloud, trebuie să restabiliţi pentru a doua oară instantaneul pe care l-aţi utilizat pentru a migra restul conţinutului. De această dată, trebuie să selectaţi opţiunea de restabilire Personalizat.
1. Deschideţi consola şi faceţi clic pe Instantanee.
2. Selectaţi instantaneul care conţine fişierele dvs. de date.
3. Selectaţi opţiunea de restabilire Personalizat, apoi selectaţi opţiunea Date bazate pe fişier.
  Deselectaţi toate celelalte opţiuni.
4. Faceţi clic pe Restabilire.
Verificaţi dacă găsiţi fişierele de date.