DocumentazioneJourney OptimizerGuida di Journey Optimizer

Creare schemi basati su modelli utilizzando un file DDL file-upload-schema

Last update: Fri Oct 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Si applica a:
  • Campaign Orchestration

Definisci il modello di dati basato su modello richiesto per le campagne orchestrate creando schemi come Iscrizioni fedeltà, Transazioni fedeltà e Premi fedeltà. Ogni schema deve includere una chiave primaria, un attributo di controllo delle versioni e relazioni appropriate con entità di riferimento quali Destinatari o Marchi.

Gli schemi possono essere creati manualmente tramite l’interfaccia o importati in blocco utilizzando un file DDL.

Questa sezione fornisce istruzioni dettagliate su come creare uno schema basato su modelli in Adobe Experience Platform caricando un file DDL (Data Definition Language). L’utilizzo di un file DDL consente di definire in anticipo la struttura del modello dati, incluse tabelle, attributi, chiavi e relazioni.

  1. Caricare un file DDL per creare schemi basati su modelli e definirne la struttura.

  2. Definisci le relazioni tra le tabelle nel modello dati.

  3. Collega schemi per collegare i dati basati su modelli con entità profilo esistenti, ad esempio Destinatari o Marchi.

  4. Acquisisci i dati nel set di dati da origini supportate.

➡️ Ulteriori informazioni sugli schemi basati su modelli nella documentazione di Adobe Experience Platform

Carica un file DDL ddl-upload

Caricando un file DDL, puoi definire in anticipo la struttura del modello dati, incluse tabelle, attributi, chiavi e relazioni.

Sono supportati i caricamenti di file di schema basati su Excel. Scarica il modello fornito per preparare facilmente le definizioni dello schema.

Le seguenti funzioni sono supportate durante la creazione di schemi basati su modelli in Adobe Experience Platform

  • ENUM
    I campi ENUM sono supportati sia nella creazione manuale dello schema basata su DDL, che consente di definire gli attributi con un set fisso di valori consentiti.
    Ecco un esempio:

    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)
);

  • Etichetta schema per governance dei dati
    L’etichettatura è supportata a livello di campo dello schema per applicare i criteri di governance dei dati, ad esempio il controllo degli accessi e le restrizioni di utilizzo. Per ulteriori dettagli, consulta Documentazione di Adobe Experience Platform.

  1. Accedi a Adobe Experience Platform.

  2. Passa al menu Gestione dati > Schema.

  3. Fare clic su Crea schema.

  4. Seleziona Basato su modello come Tipo di schema.

  5. Seleziona Carica un file DDL per definire un diagramma di relazioni tra entità e creare gli schemi

    La struttura della tabella deve contenere:

    • Almeno una chiave primaria.
    • Un identificatore di versione, ad esempio un campo lastmodified di tipo datetime o number.
    • Per l'acquisizione Change Data Capture (CDC), una colonna speciale denominata _change_request_type di tipo String che indica il tipo di modifica dei dati (ad esempio, inserimento, aggiornamento, eliminazione) e abilita l'elaborazione incrementale.
    • Il file DDL non deve definire più di 200 tabelle.
    note important
    IMPORTANT
    Qualsiasi schema utilizzato per il targeting deve includere almeno un campo di identità di tipo String con un spazio dei nomi identità associato.
    Questo garantisce la compatibilità con le funzionalità di targeting e risoluzione delle identità di Adobe Journey Optimizer.

  6. Trascina il file DDL e fai clic su Avanti.

    La dimensione massima supportata per un file DDL è 10 MB.

  7. Digita il nome dello schema.

  8. Configura ogni schema e le relative colonne, assicurandoti di specificare una chiave primaria e un descrittore di versione.

    Un attributo, ad esempio lastmodified, deve essere designato come descrittore di versione (tipo datetime, long o int) per garantire che i set di dati vengano aggiornati con i dati più recenti. Gli utenti possono modificare il descrittore di versione, che diventa obbligatorio una volta impostato. Un attributo non può essere sia una chiave primaria (PK) che un descrittore di versione.

  9. Contrassegna un attributo come identity e mappalo su uno spazio dei nomi di identità definito.

  10. Rinominare, eliminare o aggiungere una descrizione a ogni tabella.

  11. Al termine, fai clic su Fine.

Ora puoi verificare le definizioni della tabella e dei campi all’interno dell’area di lavoro. Ulteriori informazioni sono disponibili nella sezione qui sotto

Definire le relazioni relationships

Durante la creazione dello schema, è possibile specificare relazioni direttamente all'interno del file DDL. Se preferisci definire relazioni esterne al file, puoi farlo nell’interfaccia seguendo i passaggi seguenti.

  1. Accedi alla vista area di lavoro del modello dati e scegli le due tabelle da collegare

  2. Fai clic sul pulsante accanto a Join di origine, quindi trascina e guida la freccia verso Join di destinazione per stabilire la connessione.

    note note
    NOTE
    Le chiavi composite sono supportate se definite nel file DDL.

  3. Compila il modulo specificato per definire il collegamento e, una volta configurato, fai clic su Applica.

    Cardinalità:

    • 1-N: un’occorrenza della tabella di origine può avere diverse occorrenze corrispondenti della tabella target, ma un’occorrenza della tabella target può avere al massimo un’occorrenza corrispondente della tabella di origine.

    • N-1: un’occorrenza della tabella di origine può avere diverse occorrenze corrispondenti della tabella target, ma un’occorrenza della tabella target può avere al massimo un’occorrenza corrispondente della tabella di origine.

    • 1-1: un’occorrenza della tabella di origine può avere al massimo un’occorrenza corrispondente della tabella target.

  4. Tutti i collegamenti definiti nel modello dati sono rappresentati da frecce nella vista area di lavoro. Fai clic su una freccia tra due tabelle per visualizzare i dettagli, apportare modifiche o rimuovere il collegamento in base alle esigenze.

  5. Utilizza la barra degli strumenti per personalizzare e regolare l’area di lavoro.

    • Ingrandisci: ingrandisci l’area di lavoro per visualizzare più chiaramente i dettagli del modello dati.

    • Riduci: riduci le dimensioni dell’area di lavoro per una visualizzazione più ampia del modello dati.

    • Adatta vista: regola lo zoom per adattarlo a tutti gli schemi all’interno dell’area visibile.

    • Filtro: scegli lo schema da visualizzare nell’area di lavoro.

    • Forza layout automatico: disponi automaticamente gli schemi per una migliore organizzazione.

    • Visualizza mappa: consente di attivare o disattivare la sovrapposizione minima per spostarsi più facilmente nei layout di schema complessi o di grandi dimensioni.

    • Espandi tutto/comprimi tutto: espandi o comprimi rapidamente tutti i nodi dello schema per mostrare o nascondere i relativi attributi.

    • Scarica: scarica il diagramma ER come file .png.

  6. Al termine, fai clic su Salva. Questa azione crea gli schemi e i set di dati associati e abilita il set di dati da utilizzare nelle campagne orchestrate.

  7. Fai clic su Processi aperti per monitorare l’avanzamento del processo di creazione. Questo processo può richiedere alcuni minuti, a seconda del numero di tabelle definite nel file DDL.

    Per accedere ai processi di importazione DDL, aprire la finestra Carica file DDL e selezionare Visualizza tutti i processi di importazione DDL.

IMPORTANT
Solo le relazioni definite in modo esplicito all'interno del file DDL vengono riconosciute dal sistema. Tutte le relazioni di entità esistenti al di fuori del file DDL verranno ignorate e non elaborate.

Stabilisci una relazione tra lo schema transazioni fedeltà e lo schema Destinatari per associare ogni transazione al record cliente corretto.

  1. Passa a Schemi e apri le transazioni fedeltà create in precedenza.

  2. Fai clic su Aggiungi relazione dalle proprietà del campo Cliente.

  3. Seleziona Molti a uno come Tipo di relazione.

  4. Collega allo schema Destinatari esistente.

  5. Immetti un nome di relazione dallo schema corrente e un nome di relazione dallo schema di riferimento.

  6. Fai clic su Applica per salvare le modifiche.

Continua creando una relazione tra lo schema premi fedeltà e lo schema Brand per associare ogni premio al brand appropriato.

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