Migración de datos basados en archivos

Los usuarios cargan archivos de datos (como hojas de cálculo) a Oracle Analytics Cloud para crear juegos de datos. Al migrar a un nuevo entorno de Oracle Analytics Cloud, puede llevarse estos datos basados en archivos. En ocasiones, los problemas de conectividad de red o de acceso al almacenamiento podrían impedirle migrar los archivos de datos en la instantánea. Para estos casos, Oracle Analytics Cloud ofrece una utilidad CLI (interfaz de línea de comandos) que le permite mover los archivos de datos a la nueva ubicación. La utilidad CLI de instantánea también transfiere todos los plugins y los archivos de extensión relacionados con los mapas que cargan los usuarios para la visualización de sus datos.

Ejecute la utilidad CLI de migración de datos si ve el mensaje Restore succeeded with errors - data restore failed (o similar) al tratar de restaurar una instantánea que contenga archivos de datos. Este mensaje aparece cuando:

Migra contenido de una región diferente.
Migra contenido de Oracle Analytics Cloud de 1ª generación o de Oracle Cloud Infrastructure Classic a Oracle Analytics Cloud de 2ª generación.
El proceso de restauración falla debido a otros problemas de conectividad de red o acceso al almacenamiento.

La utilidad CLI le permite mover archivos de datos directamente de un entorno a otro en un único paso. Si lo prefiere, también puede descargar los datos basados en archivos en un archivo ZIP y, a continuación, cargar los archivos de datos al entorno que desee en dos pasos independientes.

Compruebe los detalles del entorno.
- Verifique que tanto el sistema de origen como el de destino utilizan Oracle Analytics Cloud 5.3 o posterior. La utilidad CLI no está disponible en versiones anteriores.
  
  Si no está seguro, pregunte a su representante de Oracle.
- Compruebe que tanto el sistema de origen como el de destino estén activos y en ejecución, así como que Oracle Analytics Cloud esté configurado con credenciales de almacenamiento válidas.
- Compruebe el entorno local. Necesita Java 1.8 o posterior para poder ejecutar la utilidad CLI.
- Asegúrese de que puede acceder al entorno de origen y al destino de Oracle Analytics Cloud desde el entorno local en el que planea ejecutar la utilidad CLI.
- Verifique el nombre y la ubicación de la instantánea que ha descargado anteriormente y que contiene sus datos basados en archivos. Por ejemplo, /tmp/20190307095216.bar.
Descargue la utilidad CLI.
1. En el destino de Oracle Analytics Cloud, haga clic en Consola y, a continuación, en Instantáneas.
2. Haga clic en el menú Página y seleccione Descargar utilidad de migración de datos.
  Siga las instrucciones para guardar localmente el archivo migrate-oac-data.zip.
Descomprima migrate-oac-data.zip.
El archivo ZIP contiene tres archivos:
- migrate-oac-data.jar
- config.properties
- readme

Si desea migrar archivos de datos almacenados en el entorno de origen directamente al destino en un único paso, configure la sección [MigrateData] en 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>

Si desea descargar primero los archivos de datos del origen de Oracle Analytics Cloud a su entorno local para, a continuación, cargar los archivos de datos al entorno de destino de Oracle Analytics Cloud, configure las secciones [DownloadDataFiles] y [UploadDataFiles] en 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>

Ejecute el archivo migrate-oac-data.jar en su entorno local.
Sintaxis:
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Dónde:
- -config configfile: Nombre del archivo config.properties
- -d: Descarga los datos de manera local y utiliza la información en config.properties
- -help : muestra la ayuda
- -m : Migra datos utilizando la información de origen y destino del archivo config.properties.
- -m : Carga datos utilizando la información presente en el archivo config.properties.
Por ejemplo, para migrar archivos de datos en un único paso:
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Por ejemplo, para descargar archivos de datos localmente:
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Por ejemplo, para cargar archivos de datos:
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Conéctese al Oracle Analytics Cloud de destino.
Para mostrar los archivos de datos en Oracle Analytics Cloud, debe restaurar la instantánea que ha utilizado para migrar el resto del contenido por segunda vez. En esta ocasión, debe seleccionar la opción de restauración Personalizado.
1. Abra la consola y haga clic en Instantáneas.
2. Seleccione la instantánea que contiene los archivos de datos
3. Seleccione la opción de restauración Personalizada y, a continuación, seleccione la opción Datos basados en archivos.
  Anule la selección de todas las demás opciones.
4. Haga clic en Restaurar.
Verifique que los archivos de datos están disponibles.