Migracja danych opartych na plikach

Użytkownicy mogą - w celu tworzenia zbiorów danych - wysyłać pliki danych (takie jak arkusze kalkulacyjne) do Oracle Analytics Cloud. Przechodząc do nowego środowiska Oracle Analytics Cloud, można przenieść do niego wszystkie dane oparte na plikach. Niekiedy problemy z łącznością sieciową lub dostępem do miejsca składowania mogą uniemożliwić migrację plików danych z zapisu stanu. Dla takich przypadków Oracle Analytics Cloud oferuje narzędzie CLI (Command Line Interface) umożliwiające przeniesienie plików danych do nowej lokalizacji. Narzędzie CLI "snapshot" przenosi także wszystkie wtyczki odwzorowywania oraz pliki rozszerzeń, które użytkownicy mogli wysłać na potrzeby wizualizacji danych.

Narzędzia CLI migracji danych należy używać wtedy, gdy podczas próby przywracania z zapisu stanu pojawi się komunikat Przywrócono z pewnymi błędami - nie udało się odtworzyć danych lub podobny. Ten komunikat pojawia się, gdy:

Jest przeprowadzana migracja zawartości z innego regionu.
Następuje migracja z Oracle Analytics Cloud Gen 1 lub Oracle Cloud Infrastructure Classic do Oracle Analytics Cloud Gen 2.
Proces odtwarzania kończy się niepowodzeniem ze względu na jakiś inny problem z połączeniem sieciowym lub dostępem do miejsca składowania.

Narzędzie CLI umożliwia bezpośrednie przeniesienie plików danych z jednego środowiska do innego. Można też pobrać dane oparte na plikach do pliku ZIP, a następnie wysłać pliki danych do wybranego środowiska, wykonując dwie czynności.

Sprawdzić szczegóły środowiska.
- Sprawdzić, czy źródłowy i docelowy system używają najnowszej wersji Oracle Analytics Cloud 5.3 lub nowsza. Narzędzie CLI nie jest dostępne w starszych wersjach.
  
  Nie mając pewności, zapytać się przedstawiciela Oracle.
- Sprawdzić, czy środowiska źródłowe i docelowe działają oraz czy Oracle Analytics Cloud jest skonfigurowana z użyciem poprawnych uwierzytelnień dla usługi składowania.
- Sprawdzić środowisko lokalne. Do uruchomienia narzędzia CLI jest potrzebne oprogramowanie Java 1.8 lub w wersji nowszej.
- Sprawdzić, czy można uzyskać dostęp do środowiska źródłowego i docelowej usługi Oracle Analytics Cloud ze środowiska lokalnego, w którym narzędzie CLI będzie uruchamiane.
- Sprawdzić nazwę i lokalizację pobranego wcześniej zapisu, zawierającego dane plikowe. Na przykład /tmp/20190307095216.bar.
Pobrać narzędzie CLI.
1. W docelowej Oracle Analytics Cloud przejść do konsoli, po czym wybrać Zapisy stanu.
2. Kliknąć menu strony i wybrać Pobierz narzędzie migracji danych.
  Postępując zgodnie z wyświetlanym instrukcjami, zapisać lokalnie plik migrate-oac-data.zip.
Rozpakować plik migrate-oac-data.zip.
Ten plik ZIP zawiera trzy pliki:
- migrate-oac-data.jar
- config.properties
- readme

Aby przenieść bezpośrednio pliki danych ze środowiska źródłowego do docelowego, skonfigurować w pliku config.properties sekcję [MigrateData].

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

Aby najpierw pobrać pliki danych ze źródłowego środowiska Oracle Analytics Cloud do środowiska lokalnego, a następnie wysłać je do docelowego środowiska Oracle Analytics Cloud, skonfigurować sekcje [DownloadDataFiles] i [UploadDataFiles] w pliku 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>

Uruchomić plik migrate-oac-data.jar w środowisku lokalnym.
Składnia:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Gdzie:
- -config configfile: nazwa pliku config.properties
- -d: pobieranie danych lokalnie z użyciem informacji zawartych w pliku config.properties
- -help: wyświetlenie Pomocy
- -m: migracja danych z użyciem informacji o źródle i celu, zawartych w pliku config.properties
- -u: wysłanie danych z użyciem informacji zawartych w pliku config.properties
Na przykład, aby przeprowadzić bezpośrednią migrację plików danych:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Na przykład, aby pobrać pliki danych lokalnie:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Na przykład, aby wysłać pliki danych:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Zalogować się do docelowej Oracle Analytics Cloud.
Aby wyeksponować pliki w Oracle Analytics Cloud, po raz drugi odtworzyć zapis stanu używany do migracji reszty zawartości. Tym razem trzeba wybrać opcję odtwarzania Niestandardowe.
1. Otworzyć konsolę i kliknąć Zapisy stanu.
2. Wybrać zapis stanu zawierający pliki danych.
3. Wybrać opcję odtwarzania Niestandardowe, po czym wybrać opcję Dane oparte na pliku.
  Anulować wybór wszystkich pozostałych opcji.
4. Kliknąć przycisk Przywróć.
Sprawdzić, czy pliki danych są dostępne.