Migration de données basées sur un fichier

Les utilisateurs téléchargent des fichiers de données, tels que des feuilles de calcul, vers Oracle Analytics Cloud pour créer des ensembles de données. Lorsque vous réalisez une migration vers un nouvel environnement Oracle Analytics Cloud, vous pouvez inclure ces données basées sur un fichier. Parfois, des problèmes de connectivité réseau ou d'accès au stockage peuvent vous empêcher de migrer les fichiers de données du cliché. Pour ces situations, Oracle Analytics Cloud offre un utilitaire CLI (interface de ligne de commande) qui permet de déplacer les fichiers de données vers le nouvel emplacement. L'utilitaire CLI de cliché déplace également tous les fichiers d'extension et les modules d'extension associés à la carte que les utilisateurs peuvent télécharger pour leurs visualisations de données.

Exécutez l'utilitaire CLI de migration de données si vous voyez le message Restauration terminée avec des erreurs. Echec de la restauration des données ou un message similaire lorsque vous essayez de restaurer un cliché qui contient des fichiers de données. Ce message apparaît dans les cas suivants :

Vous migrez du contenu à partir d'une autre région.
Vous migrez du contenu d'Oracle Analytics Cloud sur Gen 1 ou d'Oracle Cloud Infrastructure Classic vers Oracle Analytics Cloud sur Gen 2.
Le processus de restauration échoue à cause d'un problème de connectivité réseau ou d'accès au stockage.

L'utilitaire CLI vous permet de déplacer des fichiers de données directement à partir d'un environnement vers un autre en une seule étape. Si vous préférez, vous pouvez télécharger vos données basées sur un fichier vers un fichier ZIP en local, puis télécharger les fichiers de données vers l'environnement de votre choix en deux étapes distinctes.

Vérifiez les détails de votre environnement.
- Vérifiez que les systèmes source et cible utilisent Oracle Analytics Cloud 5.3 ou version ultérieure. L'utilitaire CLI n'est pas disponible dans les versions antérieures.
  
  En cas de doute, adressez-vous à votre représentant Oracle.
- Vérifiez que les systèmes source et cible sont en fonctionnement et qu'Oracle Analytics Cloud est configuré avec des informations d'identification de stockage valides.
- Vérifiez votre environnement local. Vous devez disposer de Java 1.8 ou d'une version ultérieure pour exécuter l'utilitaire CLI.
- Vérifiez que vous avez accès à l'environnement source et à l'instance Oracle Analytics Cloud cible à partir de l'environnement local dans lequel vous avez l'intention d'exécuter l'utilitaire CLI.
- Vérifiez le nom et l'emplacement du cliché que vous avez téléchargé précédemment et qui contient vos données basées sur un fichier. Par exemple, /tmp/20190307095216.bar.
Téléchargez l'utilitaire CLI.
1. Dans l'instance Oracle Analytics Cloud cible, cliquez sur Console, puis sur Clichés.
2. Cliquez sur le menu Page et sélectionnez Télécharger en local l'utilitaire de migration de données.
  Suivez les instructions pour enregistrer le fichier migrate-oac-data.zip en local.
Décompressez migrate-oac-data.zip.
Le fichier ZIP contient trois fichiers :
- migrate-oac-data.jar
- config.properties
- readme

Si vous souhaitez migrer des fichiers de données stockés dans votre environnement source directement vers l'environnement cible en une seule étape, configurez la section [MigrateData] dans 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 vous voulez d'abord télécharger des fichiers de données à partir de votre environnement Oracle Analytics Cloud source vers votre environnement local, puis télécharger les fichiers de données vers l'environnement Oracle Analytics Cloud cible, configurez les sections [DownloadDataFiles] et [UploadDataFiles] dans 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>

Exécutez le fichier migrate-oac-data.jar dans votre environnement local.
Syntaxe :
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
Où :
- -config configfile : est le nom du fichier config.properties
- -d : télécharge en local les données à l'aide des informations contenues dans config.properties
- -help : affiche l'aide
- -m : migre les données à l'aide des informations source et cible contenues dans le fichier config.properties
- -u : télécharge vers le serveur les données à l'aide des informations contenues dans le fichier config.properties
Par exemple, pour migrer des fichiers de données en une seul étape, indiquez :
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Par exemple, pour télécharger en local des fichiers de données, indiquez :
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Par exemple, pour télécharger des fichiers de données vers le serveur, indiquez :
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Connectez-vous à votre environnement Oracle Analytics Cloud cible.
Pour afficher les fichiers de données dans Oracle Analytics Cloud, vous devez une nouvelle fois restaurer le cliché utilisé pour migrer le reste du contenu. Cette fois, vous devez sélectionner l'option de restauration Personnalisé.
1. Ouvrez la console et cliquez sur Clichés.
2. Sélectionnez le cliché contenant vos fichiers de données.
3. Sélectionnez l'option de restauration Personnalisé, puis l'option Données basées sur un fichier.
  Désélectionnez toutes les autres options.
4. Cliquez sur Restaurer.
Vérifiez que vos fichiers de données sont disponibles.