[Disponibilité limitée]{class="badge informative"}

Schémas basés sur des modèles

Les schémas basés sur des modèles fournissent un modèle de modélisation contrôlé et flexible pour représenter les données structurées dans le lac de données Adobe Experience Platform. Ils prennent en charge les clés primaires appliquées, les relations au niveau du schéma et un contrôle affiné des enregistrements, le tout sans recourir à des schémas d’union ou à des systèmes de base de données relationnelle complets.

Utilisez des schémas basés sur des modèles pour :

Différences entre les schémas basés sur des modèles et les schémas XDM standard

Les schémas XDM standard d’Experience Platform adoptent l’un des trois comportements de données suivants : enregistrement, série temporelle ou ad hoc. Pour obtenir des définitions et des détails, voir Comportements des données XDM.

Dans le modèle traditionnel, les schémas d’enregistrement et de série temporelle participent aux schémas d’union (consultez également le guide de l’interface utilisateur du schéma d’union 🔗). Ces schémas évoluent automatiquement à mesure que les groupes de champs partagés sont mis à jour et que les champs personnalisés doivent être imbriqués sous un espace de noms client. Bien que puissant, ce modèle peut ralentir l’intégration, produire des schémas trop complexes avec des champs inutilisés et nécessiter un mappage ou une transformation des données supplémentaires. Ces facteurs augmentent la courbe d’apprentissage et l’effort de maintenance continu.

Les schémas basés sur des modèles suppriment les dépendances de schéma d’union, ce qui élimine les mises à jour automatiques des groupes de champs partagés et permet de définir directement des champs sans restrictions d’espace de noms client. Vous avez un contrôle explicite sur les clés primaires, les relations et la conception initiale du schéma, ce qui facilite la modélisation des données en fonction de vos besoins au moment de la création.

Fonctionnalités des schémas basés sur des modèles

Utilisez les fonctionnalités suivantes pour modéliser des données structurées dans le lac de données tout en préservant la gouvernance, l’intégrité et l’interopérabilité.

Champs obligatoires

Les schémas basés sur des modèles nécessitent certains descripteurs, à savoir des métadonnées dans la définition de schéma qui contrôlent les comportements et contraintes clés. Ajoutez les descripteurs suivants dans le cadre de votre définition de schéma.

descripteur de clé de Principal

Utilisez un descripteur de clé primaire pour vous assurer que chaque enregistrement est identifiable de manière unique. Les configurations prises en charge sont les suivantes :

Exemple (champ unique) :

{
  "xdm:descriptor": "xdm:descriptorPrimaryKey",
  "xdm:sourceProperty": "customerId"
}

Exemple (composite pour une série temporelle)

{
  "xdm:descriptor": "xdm:descriptorPrimaryKey",
  "xdm:sourceProperty": ["customerId", "eventTimestamp"]
}

Descripteur de version (identifiant)

Définissez un descripteur de version (identifiant) pour conserver un état d’enregistrement correct et vous assurer que la dernière mise à jour est appliquée. Lorsque plusieurs enregistrements partagent la même clé primaire, l'enregistrement ayant la valeur de version la plus élevée est considéré comme le plus récent.

Exemple :

{
  "xdm:descriptor": "xdm:descriptorVersion",
  "xdm:sourceProperty": "lastModified"
}

Descripteur d’horodatage (identifiant)

Pour les schémas de série temporelle, définissez un descripteur d’horodatage (identifiant) afin de définir l’heure de l’événement à classer.

Exemple :

{
  "xdm:descriptor": "xdm:descriptorTimestamp",
  "xdm:sourceProperty": "eventTimestamp"
}

Pour obtenir des instructions sur la création de descripteurs dans l’éditeur de schémas, voir Créer des descripteurs dans l’éditeur de schémas. Pour la création basée sur l’API, voir Création de descripteurs à l’aide de l’API.

Prise en charge des relations relationship-support

La modélisation des données relationnelles est une utilisation principale des schémas basés sur des modèles. Les cas d’utilisation des applications peuvent même faire référence à ces schémas en tant que « schémas relationnels ». Les descripteurs de relation permettent ces connexions en liant les jeux de données entre les schémas sans incorporer de clés étrangères dans les lignes de données. Ils améliorent l’intégrité du référentiel, activent des modèles de modélisation réutilisables et prennent en charge les requêtes connectées entre les applications.

Créez des descripteurs de relation au niveau du schéma pour la résolution dynamique au moment de la requête. Les valeurs de cardinalité (1:1, plusieurs-à-un) fournissent des conseils, mais n’appliquent pas de contraintes lors de l’ingestion, ce qui permet une modélisation des données flexible sur les jeux de données connectés.

Avant d’ajouter des descripteurs de relation, déterminez le type et la cible appropriés :

Exemple : relation un-à-un

{
  "xdm:descriptor": "xdm:descriptorRelationship",
  "xdm:sourceProperty": "accountId",
  "xdm:destinationSchema": "https://ns.adobe.com/xdm/context/account",
  "xdm:destinationProperty": "accountId"
}

Exemple : relation multiple-à-un

{
  "xdm:descriptor": "xdm:descriptorRelationship",
  "xdm:sourceProperty": "customerId",
  "xdm:destinationSchema": "https://ns.adobe.com/xdm/context/customer",
  "xdm:destinationProperty": "customerId"
}

Pour obtenir la liste des types de descripteur de relation et de la syntaxe associée, reportez-vous à la référence de l’API descriptors.Pour apprendre à appliquer ces concepts en pratique, suivez les tutoriels définir une relation dans l’API ou créer une relation dans l’interface utilisateur.

Considérations relatives à la suppression des données et à l’hygiène data-hygiene-support

Les schémas basés sur des modèles permettent des suppressions précises au niveau des enregistrements, avec des implications universelles pour toutes les applications et tous les cas d’utilisation. Les descripteurs de clé de Principal, de version et d’horodatage fournissent la base d’une identification précise des enregistrements lors des opérations de suppression.

Incidences de la suppression universelle

Toutes les applications qui utilisent des schémas basés sur des modèles doivent tenir compte des points suivants :

Pour obtenir des conseils d’implémentation, voir Suppression d’enregistrements des jeux de données basés sur des modèles.

Restrictions et considérations limitations

Examinez les limites suivantes avant d’utiliser des schémas basés sur des modèles :