Configurer un schéma relationnel manuel manual-schema

Sur cette page : découvrez comment créer manuellement un schéma relationnel dans l’interface d’utilisation, ajouter des attributs, lier des schémas, et créer et activer un jeu de données pour les campagnes orchestrées.

Les schémas relationnels peuvent être créés directement via l’interface utilisateur, ce qui permet une configuration détaillée des attributs, des clés primaires, des champs de contrôle de version et des relations.

L’exemple suivant définit manuellement le schéma Membres du programme de fidélité pour illustrer la structure requise pour les campagnes orchestrées.

  1. Création manuelle d’un schéma relationnel à l’aide de l’interface Adobe Experience Platform.

  2. Ajoutez des attributs tels que l’ID du client, le niveau d’abonnement et les champs de statut.

  3. Liez votre schéma à des schémas intégrés tels que les destinataires pour le ciblage de la campagne.

  4. Créez un jeu de données basé sur votre schéma et activez-le pour l’utiliser dans des campagnes orchestrées.

  5. Ingérez des données dans votre jeu de données à partir de sources prises en charge.

➡️ Pour en savoir plus sur les schémas relationnels, consultez la documentation d’Adobe Experience Platform.

Créer votre schéma schema

NOTE
Le diagramme Afficher les relations de l’onglet Relation est en lecture seule. Pour créer ou modifier une relation, ouvrez le schéma à partir de l’onglet Parcourir à la place.

Commencez par créer manuellement un nouveau schéma relationnel dans Adobe Experience Platform. Ce processus vous permet de définir la structure du schéma à partir de zéro, y compris son nom et son comportement.

  1. Connectez-vous à Adobe Experience Platform.

  2. Accédez au menu Gestion des données > Schéma.

  3. Cliquez sur Créer un schéma.

  4. Sélectionnez Relationnel pour votre Type de schéma.

    {modal="regular"}

  5. Choisissez Créer manuellement pour créer un schéma en ajoutant manuellement des champs.

  6. Saisissez votre nom d’affichage du schéma.

    {modal="regular"}

  7. Cliquez sur Terminer pour procéder à la création de votre schéma.

Vous pouvez maintenant commencer à ajouter des attributs à votre schéma pour définir sa structure.

Ajouter des attributs à votre schéma schema-attributes

Ajoutez ensuite des attributs pour définir la structure de votre schéma. Ces champs représentent les points de données clés utilisés dans les campagnes orchestrées, tels que les identifiants des clientes et des clients, les détails d’abonnement et les dates d’activité. Leur définition précise garantit une personnalisation, une segmentation et un suivi fiables.

Tout schéma utilisé pour le ciblage doit inclure au moins un champ d’identité de type String avec un espace de noms d’identité associé. Cela garantit la compatibilité avec les fonctionnalités de ciblage et de résolution des identités d’Adobe Journey Optimizer.

Les fonctions suivantes sont prises en charge lors de la création de schémas relationnels dans Adobe Experience Platform.
  • ENUM
    Les champs ENUM sont pris en charge pour la création de schémas manuelle ou basée sur un fichier DDL, ce qui vous permet de définir des attributs avec un ensemble fixe de valeurs autorisées.

  • Libellé de schéma pour la gouvernance des données
    L’étiquetage est pris en charge au niveau du champ de schéma pour appliquer les politiques de gouvernance des données, telles que le contrôle d’accès et les restrictions d’utilisation. Pour plus d’informations, consultez la documentation Adobe Experience Platform.

  • Clé composite
    Les clés primaires composites couvrant plusieurs champs sont prises en charge dans les définitions de schéma relationnel, ce qui permet d’utiliser plusieurs champs ensemble pour identifier des enregistrements de manière unique.

  1. Dans la zone de travail, cliquez sur en regard du nom de votre schéma pour commencer à ajouter des attributs.

    {modal="regular"}

  2. Saisissez votre attribut Nom du champ, Nom d’affichage et Type.

    Dans cet exemple, nous avons ajouté les attributs présentés dans le tableau ci-dessous au schéma Membres du programme de fidélité.

    accordion
    Exemples d’attributs
    table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 5-row-3 6-row-3 7-row-3 8-row-3
    Nom de l’attribut Type de données Attributs supplémentaires
    client ou cliente CHAÎNE Clé primaire
    membership_level CHAÎNE Obligatoire
    points_balance ENTIER Obligatoire
    enrollment_date DATE Obligatoire
    last_status_change DATE Obligatoire
    expiration_date DATE -
    is_active BOOLÉEN Obligatoire
    lastmodified DATEHEURE Obligatoire
  3. Attribuez les champs appropriés comme Clé primaire et Descripteur de version.

    Lors de la création d’un schéma manuel, assurez-vous que les champs essentiels suivants sont inclus :

    • Au moins une clé primaire
    • Un identifiant de version, tel qu’un champ lastmodified de type datetime ou number.
    • Pour l’ingestion Capture des données modifiées (CDC), une colonne spéciale nommée _change_request_type de type String, qui indique le type de modification des données (par exemple, insertion, mise à jour, suppression) et permet un traitement incrémentiel. Notez que le _change_request_type ne doit pas faire partie du schéma de la table, il doit uniquement être ajouté au fichier de données lors de l’ingestion.

    {modal="regular"}

  4. Cliquez sur Enregistrer.

Après avoir créé et enregistré des attributs, vous pouvez lier le schéma à d’autres schémas relationnels en définissant des relations.

➡️ Pour en savoir plus sur les schémas relationnels, consultez la documentation d’Adobe Experience Platform.

La création d’une relation entre deux schémas permet d’enrichir vos campagnes orchestrées avec des données stockées en dehors du schéma de profil principal.

  1. Dans le schéma que vous venez de créer, sélectionnez l’attribut à utiliser comme lien et cliquez sur Ajouter une relation.

    {modal="regular"}

  2. Choisissez les champs Schéma de référence et Champ de référence avec lesquels établir la relation.

    Dans cet exemple, l’attribut customer est lié au schéma recipients.

    {modal="regular"}

  3. Saisissez un nom de relation à partir du schéma actuel et un nom de relation à partir du schéma de référence.

  4. Cliquez sur Appliquer une fois la configuration terminée.

Créer un jeu de données pour le schéma dataset

Après avoir défini votre schéma, vous pouvez maintenant créer un jeu de données basé sur celui-ci. Le jeu de données stocke les données ingérées et doit être activé pour que les campagnes orchestrées soient accessibles.

  1. Accédez au menu Gestion des données > Jeux de données et sélectionnez Créer un jeu de données.

    {modal="regular"}

  2. Sélectionnez Créer un jeu de données à partir d’un schéma.

  3. Sélectionnez le schéma créé précédemment, ici Membres du programme de fidélité, puis cliquez sur Suivant.

    {modal="regular"}

  4. Saisissez le Nom de votre Jeu de données, puis cliquez sur Terminer.

Vous devez maintenant activer votre jeu de données pour les campagnes orchestrées.

Activer le jeu de données pour les campagnes orchestrées enable

Après avoir créé votre jeu de données, vous devez l’activer explicitement pour les campagnes orchestrées. Cette étape permet de s’assurer que votre jeu de données est disponible pour l’orchestration et la personnalisation en temps réel dans Adobe Journey Optimizer.

Consultez la documentation Adobe Developer pour valider ou activer l’extension Campagne orchestrée sur le jeu de données.

  1. Recherchez votre jeu de données dans la liste Jeux de données.

  2. Dans les paramètres Jeux de données, activez l’option Campagnes orchestrées pour pouvoir utiliser le jeu de données dans vos campagnes orchestrées.

    {modal="regular"}

  3. Patientez quelques minutes pour que le processus d’activation se termine. Notez que l’ingestion de données et l’utilisation de campagnes ne seront possibles qu’une fois ce paramètre entièrement activé.

Vous pouvez maintenant commencer à ingérer des données dans votre schéma à l’aide de la source de votre choix.

➡️ Découvrez comment ingérer des données

Si un schéma ou un jeu de données renvoie un code d’erreur, consultez Erreurs de schéma relationnel et de jeu de données.

AI Knowledge Reference

This section contains structured knowledge intended to support interpretation, retrieval, and question answering related to this topic.

For complete understanding, this information should be combined with the documentation on this page. Neither source is intended to stand alone; the page describes the feature, while this section provides additional context that helps disambiguate terminology, intent, applicability, and constraints.

  • TL;DR: This page explains how to manually create a relational schema in Adobe Experience Platform, add attributes, link schemas, and create and enable a dataset for use in Orchestrated campaigns.

Intents:

  • Create a relational schema manually through the Adobe Experience Platform interface.
  • Add attributes to a relational schema, including primary key, version descriptor, and required fields.
  • Link a relational schema to another schema, such as Recipients, to extend Orchestrated campaigns with additional data.
  • Create a dataset from a relational schema and enable it for Orchestrated campaigns.
  • Ingest data into the enabled dataset.

Glossary:

  • Relational schema: a schema type created directly through the Adobe Experience Platform interface, enabling detailed configuration of attributes, primary keys, versioning fields, and relationships (product-specific)
  • Version Descriptor: a field, such as lastmodified of type datetime or number, used as a version identifier in a manual schema (product-specific)
  • _change_request_type: a special column of type String used for Change Data Capture (CDC) ingestion, indicating the type of data change (insert, update, delete) and enabling incremental processing (product-specific)
  • Composite Key: a primary key spanning multiple fields, supported in relational schema definitions (product-specific)
  • Schema Label: a data governance label supported at the schema field level to enforce policies such as access control and usage restrictions (product-specific)

Guardrails:

  • Any schema used for targeting must include at least one identity field of type String with an associated identity namespace, to ensure compatibility with Adobe Journey Optimizer’s targeting and identity resolution capabilities.
  • A manual schema must include at least one primary key and a version identifier, such as a lastmodified field of type datetime or number.
  • For Change Data Capture (CDC) ingestion, the _change_request_type column must not be part of the table schema; it must only be added to the data file during ingestion.
  • ENUM fields are supported in both DDL-based and manual schema creation.
  • Composite primary keys spanning multiple fields are supported in relational schema definitions.
  • The View relationships diagram on the Relationship tab is read-only; to create or edit a relationship, the schema must be opened from the Browse tab instead.
  • After enabling a dataset for Orchestrated campaigns, data ingestion and campaign use are only possible once the enablement setting is fully activated.

Terminology:

  • Canonical name: Adobe Experience Platform — Acronym: AEP

FAQ:

  • Q: What fields must a manual relational schema include? — At least one primary key and a version identifier, such as a lastmodified field of type datetime or number.
  • Q: What is required for a schema used for targeting? — At least one identity field of type String with an associated identity namespace.
  • Q: Where does the _change_request_type column belong? — It is used for Change Data Capture (CDC) ingestion and must only be added to the data file during ingestion, not to the table schema.
  • Q: Can I edit a relationship from the View relationships diagram? — No, that view on the Relationship tab is read-only; open the schema from the Browse tab to create or edit a relationship.
  • Q: What must be done after creating a dataset from a relational schema? — The dataset must be explicitly enabled for Orchestrated campaigns before data ingestion and campaign use are possible.

Related pages:

  • To ingest data into the created dataset: Configuration steps (orchestrated/ingest-data.md)
  • If a schema or dataset returns an error code: Relational schema and dataset errors (orchestrated/relational-schema-errors.md)

Personas:

  • developer: Can add attributes such as customer, membership_level, points_balance, enrollment_date, and lastmodified when defining a relational schema. Can use a special column named _change_request_type of type String to indicate insert, update, or delete for Change Data Capture ingestion. The page states that _change_request_type must only be added to the data file during ingestion, not to the table schema. Where: “Add attributes to your schema”.
  • admin: Can create a dataset from a relational schema and enable the Orchestrated campaigns option from the Datasets settings. Can locate the dataset in the Datasets list before enabling it. The page states that data ingestion and campaign use are only possible once this setting is fully activated. Where: “Enable dataset for orchestrated campaigns”.

Onboarding:

  • Level: Experienced
  • First minimal step: Create a relational schema manually using the Adobe Experience Platform interface.
  • Success check: You can now start ingesting data into your schema using the source of your choice.
  • Next: Ingest data into the enabled dataset: Configuration steps (orchestrated/ingest-data.md); If a schema or dataset returns an error code: Relational schema and dataset errors (orchestrated/relational-schema-errors.md)
recommendation-more-help
journey-optimizer-help