Export et import de schéma

Exportez et importez les schémas d’entité et d’ensemble de choix dans Data Fabric/Data Service afin de prendre en charge la gestion du cycle de vie des applications pour le développement, les tests et la production.

Vue d'ensemble (Overview)

Un schéma représente les métadonnées de chaque entité et ensemble de choix, contenant des informations telles que le type de données des champs d'entité ou les relations entre les champs d'entité.

En exportant et en important un schéma, vous pouvez mettre en œuvre les meilleures pratiques de gestion du cycle de vie d'une application — développement, tests, déploiement — en tenant compte des capacités telles que la copie du schéma entre les locataires et les dossiers ou le suivi des modifications de schéma via l'outil de contrôle de code source de votre choix.

L’exportation du schéma télécharge un fichier JSON contenant les métadonnées d’entité sur votre machine locale. Vous pouvez partager le fichier à importer par différents développeurs dans leurs locataires ou leurs dossiers, et vous pouvez vous-même importer des schémas développés par la communauté.

Clonage des entités entre les étendues

Vous pouvez utiliser l’exportation et l’importation pour cloner un schéma d’entité natif d’une étendue à une autre. Par exemple, exportez une entité au niveau du locataire et importez-la dans un dossier pour créer une copie à l'échelle du dossier avec le même schéma. Seul le schéma est cloné - aucune donnée n'est copiée. L'entité importée est indépendante de l'original et peut être modifiée séparément.

Cette option est utile lorsque vous souhaitez réutiliser une conception d'entité existante dans un dossier à utiliser avec des solutions sans recréer le schéma manuellement.

Autorisations

Les autorisations administratives suivantes doivent être définies pour que les utilisateurs puissent exporter et importer le schéma :

Opération (Operation)	Permission
Exporter le schéma	Afficher le schéma
Importer le schéma	Personnaliser le schéma (Customize Schema) Afficher le schéma (View Schema)

Pour savoir comment définir les autorisations requises, consultez la page Gestion de l'accès .

Exportation du schéma

Remarque :

• Seuls les utilisateurs disposant des autorisations adéquates peuvent exporter le schéma.
• Toutes les entités natives présentes dans le locataire sont exportées.
• Les entités créées par le système et les champs système correspondants sont exclues de l'exportation.

Pour exporter le schéma:

1. Accédez au locataire souhaité dans Data Fabric/Data Service.
2. Sélectionnez Importer/Exporter.
3. Sélectionnez Exporter le schéma (Export Schema). Un message contextuel vous invite à confirmer l'exportation.
4. Sélectionnez Confirmer pour déclencher l'exportation. Un fichier .JSON contenant le schéma est téléchargé sur votre machine.

Importation du schéma

Remarque :

• Seuls les utilisateurs disposant des autorisations adéquates peuvent importer le schéma.
• Le fichier de schéma importé doit être :
  • valide
  • au format JSON
  • d'une taille inférieure à 30 Mo
• Les champs Créé par (Created by) et Modifié par (Modified by) du schéma importé sont remplis avec le nom de l'utilisateur qui a effectué l'importation.
• Les champs d'heure de création et de dernière modification sont remplis avec l'horodatage de l'importation.
• Une fois démarré, le processus d'importation ne peut pas être arrêté.

Pour importer un schéma, procédez comme suit:

1. Accédez au locataire ou au dossier souhaité dans Data Fabric/Data Service.
2. Sélectionnez Importer/Exporter.
3. Sélectionnez Importer le schéma (Import Schema).
4. Sélectionnez l’emplacement de destination (locataire ou dossier) de l’importation.
5. Recherchez le fichier de schéma et sélectionnez-le.
   Remarque :

   Le fichier de schéma doit être au format JSON et valide. Si vous générez des fichiers de schéma via des agents de codage, vérifiez que les types de champs correspondent aux types Data Fabric attendus, car des types incorrects peuvent entraîner un comportement inattendu.

6. Sélectionnez les entités et les ensembles de choix que vous souhaitez importer.
7. Si aucun doublon n’est détecté, les entités sélectionnées seront importées dans la destination sélectionnée. En cas de doublons, la fenêtre Importation des entités s'affiche, vous permettant d'ajouter des champs en double aux entités existantes ou de ne pas importer les doublons.

Gestion des doublons

Le processus d’importation d’un schéma compare les entités, les champs ou les ensembles de choix existants dans la destination sélectionnée à ceux du schéma importé.

Pour chaque doublon identifié dans le schéma importé, les options suivantes s'affichent :

Ajouter à l'entité existante (option par défaut)

• Les champs d’entité et les ensembles de choix qui n’existent pas dans la destination sélectionnée sont importés.
• Les entités contenant des champs et des ensembles de choix avec des propriétés différentes (telles que le nom ou le type de données) sont ignorées lors de l'importation.

Ne pas importer

• L’entité n’est pas importée dans la destination sélectionnée.