Vue d’ensemble
La page Schema — Design and manage your data model schema — est l’endroit où le modèle de données du Datagraph est construit. Ouvrez DataHub → Datagraph → Schema. Il existe un Datagraph Schema par compte, avec une version Draft et une version Published.Avant de commencer
- Les Datasources que vous souhaitez modéliser doivent déjà exister dans le DataHub.
- Les noms et types de colonnes sont lus depuis le field mapping de la Datasource : consultez d’abord le field mapping.
- La publication nécessite la permission de mise à jour sur Datagraph Schema.
Disposition de l’éditeur
L’onglet Visual permet de modifier les tables, les colonnes et les relations. Son sélecteur JSON change la vue de l’éditeur. Utilisez Save pour enregistrer le Draft et PUBLISH pour le publier. Les onglets Diagram, Relations et Datasources permettent d’explorer le modèle. Diagram inclut des commandes de zoom, tandis que Relations affiche l’analyse des jointures.Ajouter une table
- Cliquez sur Add table.
- Sélectionnez la Datasource dans le champ Datasource. Le nom de la table correspond toujours à la Datasource sélectionnée.
- Renseignez éventuellement la Description pour documenter le contenu de la table.
- Ajoutez les colonnes dans l’onglet Columns, puis les relations dans l’onglet Relations.
- Cliquez sur Save pour enregistrer le Draft.
Colonnes
Cliquez sur Add column dans l’onglet Columns. Une colonne reflète toujours un champ de la Datasource.Add column est désactivé quand la table n’a pas encore de Datasource, ou quand tous les champs de la Datasource sont déjà des colonnes. La liste affiche le nombre de colonnes, ce qui permet de vérifier la couverture d’un coup d’œil.
number, un booléen pour une colonne boolean, une chaîne pour une colonne string.
Relations
Les relations sont les liens sur lesquels le Datagraph effectue ses jointures. Cliquez sur Add relation dans l’onglet Relations.
Les deux côtés doivent lister le même nombre de colonnes, et chaque colonne référencée doit exister.
Exemple concret
Une Datasource de catalogue produits et une Datasource d’achats partagent une référence produit.
Avec cette relation, un Objet peut joindre les achats au catalogue et retourner les noms, prix et images des produits déjà commandés par une personne.
Erreurs de validation
L’enregistrement valide l’ensemble du modèle. Les définitions suivantes sont rejetées :Publication
Cliquez sur PUBLISH pour publier le Draft. La fenêtre de confirmation indique que la version Draft sera publiée. Après publication :- La version Published précédente devient Inactive.
- Une nouvelle copie Draft de la définition Live est créée, pour poursuivre les modifications.
- Les colonnes de sortie des Objets sont recalculées sur le nouveau modèle Published.
La validité structurelle n’est pas la qualité des données. Un modèle peut être parfaitement valide et contenir des relations dont les valeurs se recoupent à peine. Vérifiez le join match dans l’onglet Relations avant de publier.
Et ensuite ?
Vues de Schema
Inspectez les onglets Diagram, Relations et Datasources.
Objets
Interrogez le modèle et exposez les résultats aux Workflows.
Field Mapping
Revoyez comment les champs bruts deviennent des champs typés.
API Datagraph Schema
Automatisez les mises à jour et la validation du modèle.