Gestione dati SQL

L'attività SQL Data Management consente di scrivere script SQL personalizzati per creare e popolare tabelle di lavoro.

Prerequisiti

Prima di configurare l’attività, verifica che siano soddisfatti i seguenti prerequisiti:

  • L’attività è disponibile solo per le origini dati remote. Il pacchetto FDA (Federated Data Access) deve quindi essere installato nell’istanza. Ulteriori informazioni.

    Per ulteriori informazioni, a seconda della versione di Campaign, consulta queste sezioni:

    Documentazione di Campaign v7

    Documentazione di Campaign v8

  • Lo schema in uscita deve esistere nel database ed essere collegato a un database FDA.

  • L’operatore che esegue il flusso di lavoro deve avere il USE SQL DATA MANAGEMENT ACTIVITY (useSqlDmActivity) con nome right. Ulteriori informazioni.

Configurazione dell'attività di gestione dati SQL

  1. Specifica l'attività Label.

  2. Seleziona il External account da utilizzare, quindi seleziona il Outbound schema collegato a questo account esterno.

    ATTENZIONE

    Lo schema in uscita è fisso e non può essere modificato.

  3. Aggiungi lo script SQL.

    ATTENZIONE

    È responsabilità dell'autore dello script SQL assicurarsi che lo script SQL funzioni e che i relativi riferimenti (nomi di campi, ecc.) sono conformi allo schema in uscita.

    Se si desidera caricare un codice SQL esistente, selezionare l'opzione The SQL script is contained in an entity stored in the database. Gli script SQL devono essere creati e memorizzati nel menu Administration / Configuration / SQL scripts.

    In caso contrario, digitare o copiare-incollare lo script SQL nell'area dedicata.

    L’attività ti consente di utilizzare le seguenti variabili nello script:

    • activity.tableName: Nome SQL della tabella di lavoro in uscita.

    • task.entrionTransitionByName(‘name’).tableName: Nome SQL della tabella di lavoro gestita dalla transizione in entrata da utilizzare (la transizione è identificata dal suo nome).

      NOTA

      Il valore ('name') corrisponde al campo Name delle proprietà di transizione.

  4. Se lo script SQL contiene già comandi per creare una tabella di lavoro in uscita, deselezionare l'opzione Automatically create work table. In caso contrario, una tabella di lavoro viene creata automaticamente una volta eseguito il flusso di lavoro.

  5. Fai clic su Ok per confermare la configurazione dell’attività.

L’attività è ora configurata. È pronto per essere eseguito nel flusso di lavoro.

ATTENZIONE

Una volta eseguita l’attività, il conteggio dei record di transizione in uscita è indicativo solo. Può variare a seconda del livello di complessità dello script SQL.

Se l’attività viene riavviata, l’intero script viene eseguito dall’inizio, indipendentemente dallo stato di esecuzione.

Esempi di script SQL

NOTA

Gli esempi di script in questa sezione devono essere eseguiti in PostgreSQL.

Lo script sottostante consente di creare una tabella di lavoro e inserire dati in questa stessa tabella di lavoro:

CREATE UNLOGGED TABLE <%= activity.tableName %> (
  iRecipientId INTEGER DEFAULT 0,
  sFirstName VARCHAR(100),
  sMiddleName VARCHAR(100),
  sLastName VARCHAR(100),
  sEmail VARCHAR(100)
);

INSERT INTO <%= activity.tableName %>
SELECT iRecipientId, sFirstName, sMiddleName, sLastName, sEmail
FROM nmsRecipient
GROUP BY iRecipientId, sFirstName, sMiddleName, sLastName, sEmail;

Lo script sottostante consente di eseguire un'operazione CTAS (CREATE TABLE AS SELECT) e creare un indice della tabella di lavoro:

CREATE TABLE <%= activity.tableName %>
AS SELECT iRecipientId, sEmail, sFirstName, sLastName, sMiddleName
FROM nmsRecipient
WHERE sEmail IS NOT NULL
GROUP BY iRecipientId, sEmail, sFirstName, sLastName, sMiddleName;

CREATE INDEX ON <%= activity.tableName %> (sEmail);

ANALYZE <%= activity.tableName %> (sEmail);

Lo script sottostante consente di unire due tabelle di lavoro:

CREATE TABLE <%= activity.tableName %>
AS SELECT i1.sFirstName, i1.sLastName, i2.sEmail
FROM <%= task.incomingTransitionByName('input1').tableName %> i1
JOIN <%= task.incomingTransitionByName('input2').tableName %> i2 ON (i1.id = i2.id)

In questa pagina