Il file Transform.cfg

IMPORTANTE

Ulteriori informazioni su Data Workbench Annuncio di fine vita.

Il file data workbenchTransform.cfg contiene i parametri che definiscono le origini di registro, le trasformazioni dei dati e gli esportatori.

Le trasformazioni definite manipolano i dati non elaborati raccolti da Sensor ( .vsl file) o contenuti in file di testo, file XML o database conformi a ODBC e inviarli in campi esistenti, sovrascrivendo i dati correnti o in campi definiti di recente.

Per configurare la funzionalità di trasformazione, è necessario modificare Data Workbench Transform.cfg all’interno della cartella Dataset per il profilo per il quale desideri esportare i dati dell’evento. In genere, questo profilo è dedicato alla funzionalità di trasformazione (ovvero, l’elaborazione dei dati non viene eseguita se non in base a quanto definito all’interno di Data Workbench) Transform.cfg file). È importante notare che tutte le istruzioni di elaborazione specificate nella Log Processing Dataset Include i file per eventuali profili ereditati vengono applicati in aggiunta a quelli specificati in Data Workbench Transform.cfg file.

Per informazioni sui file di inclusione dei set di dati, vedi Dataset Include Files (File inclusi nel set di dati).

Se i dati da esportare vengono elaborati da un cluster di server di Data Workbench, ciascuno dei server di elaborazione (DPU) del cluster elabora i dati, ma solo la prima DPU (server di elaborazione n. 0 nel profile.cfg file) scriverà i dati di output nel file system locale.

Per modificare il file Transform.cfg di Data Workbench

  1. Quando lavori nel profilo per il quale desideri esportare i dati, apri la Profile Manager e fai clic su Dataset per visualizzare il contenuto della directory.
  2. Fai clic con il pulsante destro del mouse sul segno di spunta accanto a Data Workbench Transform.cfg, quindi fai clic su Make Local. Un segno di spunta per questo file viene visualizzato nel User colonna.
  3. Fai clic con il pulsante destro del mouse sul segno di spunta appena creato e fai clic su Open > from the workbench. Data Workbench Transform.cfg viene visualizzata la finestra .
  4. Modifica i parametri nel file di configurazione utilizzando la tabella seguente come guida:
Parametro Descrizione
Ora di fine

Facoltativo. Filtra i dati per includere voci di registro con marche temporali fino a questa volta, ma non incluse. L'Adobe consiglia di utilizzare per il tempo uno dei seguenti formati:

  • 1 gennaio 2013:MM:EDT SS
  • 1 gennaio 2013 HH:MM:SS GMT

Ad esempio, specificando 29 luglio 2013 00:00:00 EDT come Ora di fine include i dati fino al 28 luglio 2013, alle ore 11:59:59

È necessario specificare un fuso orario. Il fuso orario non viene impostato su GMT se non viene specificato. Per un elenco delle abbreviazioni del fuso orario supportate dal server di Data Workbench, vedi Codici del fuso orario .

Il parametro Use Start/End Times per le origini di file Sensor e log è correlato a questo parametro.

Esportatori

I sottocampi di un esportatore specificano come vengono elaborati e/o formattati i dati di output. Puoi definire più esportatori per un set di origini di registro. Ogni tipo di esportatore crea la produzione in modo indipendente.

Esistono tre tipi di esportatori:

  • ExportTextFile
  • ExportDelimitedTextFile
  • ExportVSLFile

Per ulteriori informazioni sui tipi di esportazione, vedi Definizione degli esportatori .

Soglia hash Facoltativo. Un fattore di campionamento per il sottocampionamento casuale delle righe. Se impostato su un numero n, per l’esportazione viene selezionato solo un ID di tracciamento su ogni n, riducendo il numero totale di righe esportate di un fattore n. Per esportare tutte le righe, imposta Hash Threshold su 1.
Condizione voce di registro (Log Entry Condition) Facoltativo. Definisce le regole in base alle quali le voci di registro vengono considerate per l'esportazione. Per ulteriori informazioni sulla Condizione voce di registro , vedi File di configurazione dell’elaborazione del registro .
Origini del registro

Le fonti di dati. Origini del registro può .vsl file, file di registro o file XML o dati provenienti da database conformi a ODBC. Per informazioni su origini di log , vedi File di configurazione dell’elaborazione del registro .

Trasforma si aspetta che tutti i dati di origine siano in ordine cronologico all’interno dei file di input ordinati in modo lessicografico. Se questo requisito non è soddisfatto, Come i calcoli sono errati e i dati di input aggiuntivi possono essere elaborati dopo la chiusura dei file di output.

Modalità offline

Facoltativo. True o false. Se true, Trasforma presuppone che tutti i file di input siano presenti quando inizia a elaborare i dati. Quando tutti i dati di input sono stati letti, Trasforma chiude tutti i file di output senza attendere la ricezione di dati aggiuntivi. Il valore predefinito è false.

Nota: Se Modalità offline è impostato su true, Trasforma prevede che tutti i dati di origine siano presenti prima dell’avvio dell’elaborazione. Viene generato un messaggio di avviso nella variabile VisualServer.log se vengono ricevuti dati aggiuntivi dopo la chiusura dei file di output.

Rielaborazione

Facoltativo. È possibile inserire qui qualsiasi carattere o combinazione di caratteri. Modifica di questo parametro e salvataggio del file nel Trasforma viene avviata la rielaborazione dei dati.

Per informazioni sulla rielaborazione dei dati, consulta Rielaborazione e ritrasformazione .

Fasi

Facoltativo. Nomi delle fasi di elaborazione che possono essere utilizzate in Include set di dati di elaborazione del registro file eseguiti in aggiunta a Data Workbench Transform.cfg file. Le fasi di elaborazione forniscono un modo per ordinare le trasformazioni definite in Include set di dati di elaborazione del registro file. Questo parametro è molto utile se hai definito una o più trasformazioni all’interno di più Include set di dati di elaborazione del registro file e desideri che trasformazioni specifiche vengano eseguite in punti specifici durante il processo di esportazione.

L'ordine in cui si elencano gli stadi determina l'ordine in cui le trasformazioni nel Include set di dati di elaborazione del registro i file vengono eseguiti durante l’esportazione dei dati. Pre-elaborazione e Postelaborazione sono fasi integrate; Pre-elaborazione è sempre la prima fase, e Postelaborazione è sempre l'ultimo stadio. Per impostazione predefinita, è disponibile una fase denominata Predefinito .

Per aggiungere una nuova fase di elaborazione

  • All’interno di Data Workbench Transform.cfg finestra, clic con il pulsante destro del mouse Fasi , quindi fai clic su Aggiungi nuovo > Stage .
  • Immettere un nome per il nuovo passaggio.

Per eliminare una fase di elaborazione esistente

  • Fai clic con il pulsante destro del mouse sul numero corrispondente all’area di visualizzazione da eliminare e fai clic su Rimuovi < #stage_number >.

Nota: Quando si specifica uno stage in un Include set di dati di elaborazione del registro il nome dell'area di visualizzazione deve corrispondere esattamente al nome immesso. Per ulteriori informazioni sui file di inclusione dei set di dati, vedi Dataset Include Files (File inclusi nel set di dati) .

Ora di inizio

Facoltativo. Filtrare i dati per includere voci di registro con marche temporali in o dopo questo momento. L'Adobe consiglia di utilizzare per il tempo uno dei seguenti formati:

  • 1 gennaio 2013 HH:MM:EDT SS
  • 1 gennaio 2013 HH:MM:SS GMT

Ad esempio, specificando 29 luglio 2013 00:00:00 EDT come ora di inizio include i dati a partire dal 29 luglio 2013 alle 12:00:00 EDT.

È necessario specificare un fuso orario. Il fuso orario non viene impostato su GMT se non viene specificato. Per un elenco delle abbreviazioni del fuso orario supportate dal server di Data Workbench, vedi Codici del fuso orario .

Nota: Il parametro Use Start/End Times per le origini di file Sensor e log è correlato a questo parametro.

Trasformazioni

Facoltativo. Definisce le trasformazioni da applicare ai dati. Per informazioni sui tipi di trasformazione disponibili, consulta Trasformazioni dei dati .

Nota: I seguenti tipi di trasformazione non funzionano quando definiti all’interno di Data Workbench Transform.cfg file:

  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessionize
NOTA

Se vengono ricevuti dati aggiuntivi dopo la chiusura dei file di output (vedi Log Sources e Offline Mode nella tabella precedente), Transform crea nuovi file di output con i dati aggiuntivi. I nomi dei nuovi file di output vengono generati dal nome del file di output originale con l'aggiunta di un numero di versione con parentesi prima dell'estensione. Ad esempio, se il file di output originale è 20070701-ABC.vsl, verranno denominate le versioni successive di questo file 20070701-ABC(1).vsl, 20070701-ABC(2).vsle così via. L’utilizzo dei file con versione come input per il server di Data Workbench può causare errori di elaborazione.

Adobe consiglia di evitare la creazione di file di output con versione, verificando che tutti i dati di origine siano in ordine cronologico all’interno di file di input ordinati in modo lessicografico e, se Offline Mode è impostato su true e tutti i dati di origine sono presenti prima dell'avvio dell'elaborazione. Per ulteriori informazioni, consulta la sezione Log Sources e Offline Mode le voci della tabella precedente.

  1. Aggiungi le trasformazioni facendo clic con il pulsante destro del mouse Transformations e facendo clic su Add new > Transformation type. Compila i campi di trasformazione.

    Vedi Trasformazioni dei dati per descrizioni ed esempi delle trasformazioni utilizzabili con la funzionalità di trasformazione.

  2. Fai clic con il pulsante destro del mouse (modified) nella parte superiore della finestra, quindi fai clic su Save.

  3. Per rendere effettive le modifiche apportate localmente, nella Profile Manager, fai clic con il pulsante destro del mouse sul segno di spunta per Data Workbench Transform.cfg in User , quindi fai clic su Save to > profile name, dove nome profilo è il nome del profilo per il quale stai esportando i dati. La rielaborazione dei dati inizia dopo la sincronizzazione del profilo.

    NOTA

    Per informazioni sulla rielaborazione dei dati per l’esportazione, consulta Rielaborazione e ritrasformazione.

In questa pagina