Créer des schémas relationnels à l’aide d’un fichier DDL file-upload-schema

Définissez le modèle de données relationnelles requis pour les campagnes orchestrées en créant des schémas tels que Membres du programme de fidélité, Transactions de fidélité et Récompenses de fidélité. Chaque schéma doit inclure une clé primaire, un attribut de contrôle de version et des relations appropriées pour référencer des entités telles que les Destinataires ou les Marques.

Les schémas peuvent être créés manuellement par le biais de l’interface ou importés en masse à l’aide d’un fichier DDL.

Cette section fournit des instructions détaillées sur la création d’un schéma relationnel dans Adobe Experience Platform en chargeant un fichier DDL (Data Definition Language). L’utilisation d’un fichier DDL permet de définir à l’avance la structure de votre modèle de données, y compris les tables, les attributs, les clés et les relations.

  1. Chargez un fichier DDL pour créer des schémas relationnels et définir leur structure.

  2. Définissez des relations entre les tables de votre modèle de données.

  3. Liez des schémas pour connecter vos données relationnelles à des entités de profil existantes telles que les Destinataires ou les Marques.

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

Charger un fichier DDL ddl-upload

En chargeant un fichier DDL, vous pouvez définir à l’avance la structure de votre modèle de données, y compris les tables, les attributs, les clés et les relations.

Les chargements de fichiers de schéma basés sur le format Excel sont pris en charge. Téléchargez le modèle fourni pour préparer facilement vos définitions de schéma.

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 lors de la création de schémas manuelle et basée sur DDL, ce qui vous permet de définir des attributs avec un ensemble fixe de valeurs autorisées.
    Voici un exemple :

    code language-none
    CREATE TABLE orders (
    order_id     INT NOT NULL,
    product_id   INT NOT NULL,
    order_date   DATE NOT NULL,
    customer_id  INT NOT NULL,
    quantity     INT NOT NULL,
    order_status enum ('PENDING', 'SHIPPED', 'DELIVERED', 'CANCELLED'),
    PRIMARY KEY (order_id, product_id)
    );
    
  • Libellé de schéma pour la gouvernance des données
    La création d’étiquettes est prise 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 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. 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 comme Type de schéma.

  5. Sélectionnez Charger un fichier DDL pour définir un diagramme de relations d’entités et créer des schémas.

    La structure de la table doit contenir :

    • 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.
    • Le fichier DDL ne doit pas définir plus de 200 tables.
    note important
    IMPORTANT
    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.
  6. Faites glisser et déposez votre fichier DDL, puis cliquez sur Suivant.

    Notez que la taille maximale prise en charge pour un fichier DDL est de 10 Mo.

  7. Saisissez le nom de votre schéma.

  8. Configurez chaque schéma et ses colonnes en veillant à spécifier une clé primaire.

    Un attribut, tel que lastmodified, doit être désigné comme descripteur de version (type datetime, long ou int) pour s’assurer que les jeux de données sont mis à jour avec les données les plus récentes. Les utilisateurs et utilisatrices peuvent modifier le descripteur de version, qui devient obligatoire une fois défini. Un attribut ne peut pas être à la fois une clé primaire (PK) et un descripteur de version.

  9. Marquez un attribut comme identity et mappez-le à un espace de noms d’identité défini.

  10. Renommez, supprimez ou ajoutez une description à chaque table.

  11. Cliquez sur Terminé une fois l’opération terminée.

Vous pouvez maintenant vérifier les définitions de table et de champ dans la zone de travail. En savoir plus dans la section ci-dessous

Définir des relations relationships

Pour définir des connexions logiques entre les tables de votre schéma, procédez comme suit.

  1. Accédez à la vue Zone de travail de votre modèle de données et sélectionnez les deux tables à lier.

  2. Cliquez sur le bouton en regard de la jointure Source, puis faites glisser la flèche vers la jointure cible pour établir la connexion.

    note note
    NOTE
    Les clés composites sont prises en charge si elles sont définies dans le fichier DDL.

  3. Remplissez le formulaire donné pour définir le lien et cliquez sur Appliquer une fois configuré.

    Cardinalité  :

    • 1-N  : à une occurrence du tableau source peuvent correspondre plusieurs occurrences du tableau cible, mais à une occurrence du tableau cible peut correspondre au plus une occurrence du tableau source.

    • N-1  : à une occurrence du tableau cible peuvent correspondre plusieurs occurrences du tableau source, mais à une occurrence du tableau source peut correspondre au plus une occurrence du tableau cible.

    • 1-1  : à une occurrence du tableau source peut correspondre au plus une occurrence du tableau cible.

  4. Tous les liens définis dans votre modèle de données sont représentés par des flèches dans la vue Zone de travail. Cliquez sur une flèche entre deux tableaux pour afficher les détails, apporter des modifications ou supprimer le lien selon les besoins.

  5. Utilisez la barre d’outils pour personnaliser et ajuster la zone de travail.

    • Zoom avant  : agrandissez la zone de travail pour afficher plus clairement les détails de votre modèle de données.

    • Zoom arrière  : réduisez la taille de la zone de travail pour obtenir une vue plus large de votre modèle de données.

    • Ajuster la vue  : ajustez le zoom pour qu’il s’adapte à l’ensemble des schémas dans la zone visible.

    • Filtre  : choisissez le schéma à afficher dans la zone de travail.

    • Forcer la disposition automatique  : organisez automatiquement les schémas pour une meilleure organisation.

    • Afficher la carte  : activez une superposition de mini-carte pour parcourir plus facilement les dispositions de schémas volumineux ou complexes.

  6. Cliquez sur Enregistrer lorsque vous avez terminé. Cette action crée les schémas et les jeux de données associés et permet au jeu de données d’être utilisé dans des campagnes orchestrées.

  7. Cliquez sur Ouvrir les traitements pour surveiller la progression du traitement de création. Ce processus peut prendre quelques minutes, selon le nombre de tables définies dans le fichier DDL.

    Vous pouvez également accéder à vos traitements relationnels en ouvrant la fenêtre Charger un fichier DDL et en sélectionnant Afficher tous les traitements relationnels.

IMPORTANT
Seules les relations explicitement définies dans le fichier DDL sont reconnues par le système. Toutes les relations d’entité qui existent en dehors du fichier DDL seront ignorées et ne seront pas traitées.

Établissez une relation entre le schéma Transactions de fidélité et le schéma Destinataires pour associer chaque transaction à l’enregistrement client correct.

  1. Accédez à Schémas et ouvrez vos Transactions de fidélité créées précédemment.

  2. Cliquez sur Ajouter une relation dans les Propriétés du champ client.

  3. Sélectionnez Multiples-à-un comme Type de relation.

  4. Liez vers le schéma Destinataires existant.

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

  6. Cliquez sur Appliquer pour enregistrer vos modifications.

Continuez en créant une relation entre le schéma Récompenses de fidélité et le schéma Marques pour associer chaque entrée de récompense à la marque appropriée.

recommendation-more-help
b22c9c5d-9208-48f4-b874-1cefb8df4d76