Миграция данных на основе файлов

Пользователи загружают файлы данных, например электронные таблицы, в Oracle Analytics Cloud для создания наборов данных. При миграции в новую среду Oracle Analytics Cloud можно переместить эти файловые данные. Иногда проблемы с подключением к сети или доступом к системе хранения препятствуют миграции файлов данных в снимке. В таких случаях Oracle Analytics Cloud предлагает утилиту с интерфейсом командной строки, которая позволяет перемещать ваши файлы данных. Данная утилита с интерфейсом командной строки для снимков также перемещает любые связанные с картами подключаемые модули и файлы расширений, которые пользователи могут загрузить для визуализаций данных.

Запускайте средство миграции данных с интерфейсом командной строки, если при попытке восстановить снимок с файлами данных отображается сообщение

Восстановление выполнено с ошибками — не удалось восстановить данные

или аналогичное. Это сообщение появляется в следующих случаях:

при миграции контента из другой области;
при миграции контента из Oracle Analytics Cloud (поколение 1) в Oracle Analytics Cloud (поколение 2) или Oracle Cloud Infrastructure Classic;
когда происходит сбой восстановления из-за некоторых проблем с сетевым подключением или доступом к хранилищу.

Данная утилита с интерфейсом командной строки позволяет переносить файлы данных непосредственно из одной среды в другую за один шаг. Или, при желании, вы можете выгрузить данные на основе файлов в ZIP-файл, а затем загрузить файлы данных в выбранную среду за два отдельных шага.

Проверьте сведения о среде.
- Проверьте исходную и целевую системы с помощью Oracle Analytics Cloud 5.3.x или более поздняя версия. В более ранних версиях эта утилита с интерфейсом командной строки недоступна.
  
  Если вы не уверены, обратитесь к представителю Oracle.
- Убедитесь, что исходная и целевая системы работают и сервис Oracle Analytics Cloud настроен с использованием действительных учетных данных хранилища.
- Проверьте свою локальную среду. Для выполнения данной утилиты с интерфейсом командной строки нужна версия Java 1.8 или более поздняя.
- Убедитесь в наличии доступа к исходной среде и целевому сервису Oracle Analytics Cloud из локальной среды, в которой планируется запустить данную утилиту с интерфейсом командной строки.
- Проверьте имя и расположение снимка, выгруженного ранее и содержащего файловые данные. Например, /tmp/20190307095216.bar.
Выгрузите утилиту с интерфейсом командной строки.
1. В целевом сервисе Oracle Analytics Cloud нажмите Консоль, а затем Снимки.
2. Откройте меню "Страница" и выберите Выгрузить средство миграции данных.
  Следуйте данным инструкциям, чтобы сохранить файл migrate-oac-data.zip локально.
Распакуйте архив migrate-oac-data.zip.
ZIP-файл содержит три файла:
- migrate-oac-data.jar
- config.properties
- readme

Чтобы перенести файлы данных, хранящиеся в исходной среде, непосредственно в целевую среду за один шаг, настройте раздел [MigrateData] в 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>

Чтобы сначала выгрузить файлы данных из исходной среды Oracle Analytics Cloud в локальную среду и затем загрузить файлы данных в целевую среду Oracle Analytics Cloud, настройте разделы [DownloadDataFiles] и [UploadDataFiles] в 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>

Выполните файл migrate-oac-data.jar в своей локальной среде.
Синтаксис:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Где:
- -config configfile: имя файла config.properties
- -d: выгрузка данных локально с использованием информации в config.properties
- -help: отображение справки
- -m: миграция данных с использованием информации об исходной и целевой средах в файле config.properties
- -u: загрузка данных с использованием информации в файле config.properties
Например, чтобы перенести файлы данных за один шаг:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Например, чтобы выгрузить файлы данных локально:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Например, чтобы загрузить файлы данных:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Войдите в свою целевую среду Oracle Analytics Cloud.
Чтобы открыть файлы данных в Oracle Analytics Cloud, необходимо восстановить снимок, который использовался для миграции остального контента во второй раз. В это время необходимо выбрать параметр восстановления Пользовательский.
1. Откройте консоль и нажмите Снимки.
2. Выберите снимок, содержащий нужные файлы данных.
3. Выберите вариант восстановления Пользовательский, затем выберите параметр Данные на основе файлов.
  Отмените выбор всех других параметров.
4. Нажмите кнопку Восстановить.
Проверьте доступность всех своих файлов данных.