Il file Transform.cfg

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 dai Sensor ( .vsl file) o contenuti in file di testo, file XML o database conformi a ODBC e li inviano nei campi esistenti, sovrascrivendo i dati correnti o in campi di nuova definizione.

Per configurare la funzionalità di trasformazione, è necessario modificare il file di Data Workbench Transform.cfg all’interno della cartella Dataset per il profilo per il quale si desidera 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 nel file di Data Workbench Transform.cfg ). È importante notare che tutte le istruzioni di elaborazione specificate nei file Log Processing Dataset Include per eventuali profili ereditati vengono applicate in aggiunta a quelle specificate nel file Data Workbench Transform.cfg .

Per informazioni sui file di inclusione dei set di dati, consulta 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 file profile.cfg) scriverà i dati di output nel proprio 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 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 nella colonna User.
  3. Fai clic con il pulsante destro del mouse sul segno di spunta appena creato e fai clic su Open > from the workbench. Viene visualizzata la finestra Data Workbench Transform.cfg .
  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 2013HH:MM:SS EDT
  • 1 gennaio 2013 OH:MM:SS GMT

Ad esempio, specificando 29 luglio 2013 00:00:00 EDT come Ora di fine sono inclusi i dati fino al 28 luglio 2013, alle 11:59:59 PM 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, consulta 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, consulta 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 , vedere File di configurazione dell’elaborazione del registro .
Origini del registro

Le fonti di dati. Le origini di registro possono essere .vsl file, file di registro o file XML o dati da database conformi ODBC. Per informazioni sulle origini di registro , vedere Log Processing Configuration File .

Transform prevede che tutti i dati di origine siano in ordine cronologico all’interno di 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. Un messaggio di avviso viene generato nel file 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. La modifica di questo parametro e il salvataggio del file sul computer Trasforma avvia la rielaborazione dei dati.

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

Fasi

Facoltativo. I nomi delle fasi di elaborazione che possono essere utilizzate nel file Dataset di elaborazione del registro Includono file che vengono eseguiti oltre al file Data Workbench Transform.cfg . Le fasi di elaborazione forniscono un modo per ordinare le trasformazioni definite in Log Processing Dataset Include files . Questo parametro è molto utile se hai definito una o più trasformazioni all’interno di più file di inclusione del set di dati di elaborazione del registro e desideri che trasformazioni specifiche vengano eseguite in punti specifici durante il processo di esportazione.

L'ordine in cui si elencano le fasi qui determina l'ordine in cui le trasformazioni nei file Dataset di elaborazione del registro Dataset Include vengono eseguite durante l'esportazione dei dati. La preelaborazione e la postelaborazione sono fasi integrate; La preelaborazione è sempre la prima fase e la postelaborazione è sempre l’ultima fase. Per impostazione predefinita, esiste una fase denominata Predefinito .

Per aggiungere una nuova fase di elaborazione

  • Nella finestra Data Workbench Transform.cfg , fai clic con il pulsante destro del mouse su Stages , quindi fai clic su Aggiungi nuovo > Stage .
  • Immettere un nome per il nuovo passaggio.

Per eliminare una fase di elaborazione esistente

  • Fare clic con il pulsante destro del mouse sul numero corrispondente all'area di visualizzazione che si desidera eliminare e fare clic su Rimuovi < #stage_number .

Nota: Quando si specifica uno stage in un file Dataset di elaborazione del registro Include il nome dell'area di visualizzazione deve corrispondere esattamente al nome immesso. Per ulteriori informazioni sui file di inclusione dei set di dati, consulta 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:SS EDT
  • 1 gennaio 2013 OH:MM:SS GMT

Ad esempio, specificando 29 luglio 2013 00:00:00 EDT come Ora di inizio sono inclusi 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, consulta 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 dati .

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

  • AppendURI
  • CrossRows
  • ODBCLookup
  • Sessionize
NOTA

Se vengono ricevuti dati aggiuntivi dopo la chiusura dei file di output (vedere 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, le versioni successive di questo file saranno denominate 20070701-ABC(1).vsl, 20070701-ABC(2).vsl e 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 con ordinamento lessicografico e, se Offline Mode è impostato su true, che tutti i dati di origine siano presenti prima dell’avvio dell’elaborazione. Per ulteriori informazioni, vedere le voci Log Sources e Offline Mode nella tabella precedente.

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

    Per descrizioni ed esempi delle trasformazioni utilizzabili con la funzionalità di trasformazione, consulta Trasformazioni dati .

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

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

    NOTA

    Per informazioni sulla rielaborazione dei dati per l'esportazione, vedere Rielaborazione e ritrasformazione.

In questa pagina