Concept : modifications des schémas des jeux de données

Un schéma est un ensemble de règles qui définissent la façon dont les données sont organisées, structurées et limitées. Plusieurs artefacts et composants Workday ont un schéma, notamment des jeux de données et des composants de jeu de données.

Un jeu de données peut être composé de plusieurs schémas en fonction de sa configuration. Chacun des composants du jeu de données suivants a son propre schéma :

Les fichiers contenant des données externes que vous chargez dans un jeu de données de base.
Le rapport personnalisé que vous créez pour intégrer des données Workday dans un jeu de données de base.
L'entrée dans une phase. Pour la première phase dans un jeu de données de base, ce schéma est déterminé par la source du jeu de données.
La sortie d'une phase. Pour la dernière phase du pipeline principal, ce schéma détermine le schéma de sortie de l'ensemble du jeu de données.

Les modifications de schéma peuvent avoir lieu à n'importe quel endroit dans un jeu de données. Les schémas changent lorsque vous ajoutez de nouveaux champs ou supprimez des champs existants, par exemple lorsque vous :

Ajoutez un champ calculé Prism.
Masquer ou afficher un champ.
Ajoutez une phase qui ajoute ou supprime des champs dans cette phase.

Les schémas peuvent également changer dans les jeux de données de base lorsque vous :

Télécharger un fichier externe.
Importer un fichier à partir d'un serveur SFTP.
Importez des données à partir d'un rapport personnalisé.

Lorsque des modifications se produisent dans un jeu de données, celles-ci peuvent affecter d'autres composants du jeu de données. Les modifications apportées aux schémas de jeu de données peuvent corrompre des composants qui étaient basés sur le schéma d'origine. L'emplacement des modifications peut également affecter la façon dont vous gérez les modifications.

Lorsque vous importez des données qui modifient le schéma d'un jeu de données de base à partir d'un serveur SFTP ou d'un rapport personnalisé, vous devez modifier manuellement le jeu de données de base pour intégrer les modifications. Lorsque de nouveaux champs sont ajoutés au jeu de données en raison d'une modification du schéma source, Workday les masque automatiquement. Exposez les nouveaux champs et enregistrez le jeu de données de base pour inclure les champs dans le schéma du jeu de données.

Workday vous recommande de vous assurer que le jeu de données est à jour et qu'il contient les champs souhaités. Dans la plupart des cas, vous utilisez la phase Gérer les champs pour gérer les modifications de schéma du jeu de données.

La phase Gérer les champs utilise la sortie de la phase précédente comme référence à partir de laquelle contrôler les modifications. Lorsque cette référence change, Workday vous prévient dans le panneau de détail du pipeline. Si la référence change, dans la phase Gérer les champs, Workday :

Affiche tous les champs nouveaux et supprimés.
N'inclut pas encore toutes les modifications apportées au schéma du jeu de données.
N'affiche aucune donnée dans l'exemple de table.

Voici les recommandations de Workday :

Ajoutez une phase Gérer les champs au début du pipeline principal d'un jeu de données dérivé lorsque vous souhaitez surveiller le schéma de la table ou du jeu de données dont il est issu.
Ajouter une phase Gérer les champs à la fin du pipeline principal d'un jeu de données que vous prévoyez de publier. Cela vous permet de détecter toute modification de schéma susceptible de corrompre les rapports utilisant la source de données Prism de ce jeu de données publié.
Ajoutez une phase Gérer les champs à la fin d'un pipeline lorsque vous avez besoin de masquer des champs ou d'exposer de nouveaux champs.
Ajoutez une phase Gérer les champs dans un jeu de données de base pour garantir qu'aucune intégration future ne supprime un champ existant par inadvertance.
N'incluez pas plus de deux phases Gérer les champs dans un même pipeline.

Dans certains cas, Workday gère les modifications de schéma sans utiliser de phase Gérer les champs. Exemple : lors du téléchargement d'une nouvelle version d'un fichier source dans un jeu de données de base, Workday gère les modifications de schéma en fonction de la ligne d'en-tête du fichier source :

Le fichier source contient une ligne d'en-tête	Résultat
Oui	Workday utilise les noms de champ dans la ligne d'en-tête du jeu de données de base pour déterminer quels champs se trouvent dans le nouveau fichier source. Vous pouvez ajouter ou supprimer des champs à n'importe quel endroit dans le fichier source. Si les noms de champ dans le fichier source ne changent pas, Workday met à jour le schéma du jeu de données de base dans lequel vous importez le nouveau fichier source.
Non	Workday gère les modifications qui ont lieu uniquement à la fin du fichier source. Vous pouvez uniquement ajouter de nouveaux champs à la fin du fichier source. Le cas échéant, Workday met à jour le schéma du jeu de données de base dans lequel vous importez le nouveau fichier source.