Migrer des données basées sur des fichiers

Les utilisateurs peuvent charger des fichiers de données, tels que des feuilles de calcul, dans Oracle Analytics Cloud pour créer des jeux de données. Lorsque vous effectuez une migration vers un nouvel environnement Oracle Analytics Cloud, vous pouvez migrer ces fichiers de données. Des problèmes de connectivité au réseau ou d'accès au stockage empêchent parfois la migration des fichiers de données dans l'instantané. Si tel est le cas, Oracle Analytics Cloud offre un utilitaire CLI (interface de ligne de commande) qui vous permet de déplacer les fichiers de données vers le nouvel emplacement. L'utilitaire CLI d'instantané déplace également les plugiciels liés aux cartes et les fichiers d'extension que les utilisateurs peuvent charger pour leurs visualisations de données.

Exécutez l'utilitaire CLI de migration des données si vous voyez le message Restauration réussie avec erreurs - échec de la restauration des données ou un message similaire lorsque vous tentez de restaurer un instantané contenant des fichiers de données. Ce message s'affiche dans les cas suivants :

Vous migrez un contenu depuis une autre région.
Vous migrez un contenu d'Oracle Analytics Cloud Gen 1 ou d'Oracle Cloud Infrastructure version classique vers Oracle Analytics Cloud Gen 2.
Le processus de restauration échoue en raison d'autres problèmes de connectivité au réseau ou d'accès à la mémoire.

L'utilitaire CLI vous permet de déplacer des fichiers de données directement d'un environnement vers un autre en une seule étape. Ou, si vous préférez, vous pouvez télécharger les données basées sur des fichiers dans un fichier ZIP, puis 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 version 5.3 ou ultérieure. L'utilitaire CLI n'est pas disponible dans les versions antérieures.
  
  En cas de doute, demandez au représentant Oracle.
- Vérifiez que les systèmes source et cible sont fonctionnels, et que Oracle Analytics Cloud est configuré à l'aide de données 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 pouvez accéder à l'environnement source et à l'environnement Oracle Analytics Cloud cible depuis l'environnement local où vous planifiez d'exécuter l'utilitaire CLI.
- Vérifiez le nom et l'emplacement de l'instantané téléchargé précédemment, qui contient les données basées sur des fichiers. Par exemple, /tmp/20190307095216.bar.
Téléchargez l'utilitaire CLI.
1. Dans votre environnement Oracle Analytics Cloud cible, cliquez sur Console, puis sur Instantanés.
2. Cliquez sur le menu Page, , et sélectionnez Télécharger l'utilitaire de migration des données.
  Suivez les instructions pour enregistrer le fichier migrate-oac-data.zip en local.
Décompressez le fichier migrate-oac-data.zip.
Le fichier zip contient trois fichiers :
- migrate-oac-data.jar
- config.properties
- readme

Si vous voulez 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 le fichier 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 souhaitez d'abord télécharger des fichiers de données de votre environnement Oracle Analytics Cloud source vers votre environnement local et ensuite charger les fichiers de données vers l'environnement Oracle Analytics Cloud cible, configurez les sections [DownloadDataFiles] et [UploadDataFiles] dans le fichier 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 : Nom du fichier config.properties
- -d : Télécharge les données localement à l'aide des informations figurant dans le fichier config.properties
- -help : Affiche l'aide
- -m : Migre les données à l'aide des informations des environnements source et cible figurant dans le fichier config.properties
- -u : Charge les données à l'aide des informations figurant dans le fichier config.properties
Par exemple, pour migrer des fichiers de données en une seule étape :
```
java -jar migrate-oac-data.jar -m -config config.properties
```
Par exemple, pour télécharger des fichiers de données localement :
```
java -jar migrate-oac-data.jar -d -config config.properties
```
Par exemple, pour charger des fichiers de données :
```
java -jar migrate-oac-data.jar -u -config config.properties
```
Connectez-vous à votre application Oracle Analytics Cloud cible.
Pour exposer les fichiers de données dans Oracle Analytics Cloud, vous devez restaurer une deuxième fois l'instantané utilisé pour migrer le reste de votre contenu. Cette fois, vous devez sélectionner l'option de restauration personnalisée.
1. Ouvrez la console et cliquez sur Instantanés.
2. Sélectionnez l'instantané contenant vos fichiers de données.
3. Sélectionnez l'option de restauration personnalisée, puis sélectionnez l'option Données basées sur des fichiers.
  Désélectionnez toutes les autres options.
4. Cliquez sur Restaurer.
Vérifiez que vos fichiers de données sont disponibles.