Passa al contenuto principale
Documentazione
Documentazione
Adaptive Planning
Ultimo aggiornamento: 2024-02-02
Procedura: Configurare le origini dati con script

Procedura: Configurare le origini dati con script

Le origini dati con script consentono di risolvere scenari complessi e personalizzati di estrazione e trasformazione dei dati. È possibile creare script ETL Kettle per specificare le origini dalle quali estrarre i dati e quindi applicare regole aziendali specifiche del cliente ai dati estratti. Prima di configurare un'origine dati con script, è necessario che l'Agente dati sia installato in un server Windows locale della rete. Consultare Concetto: Agenti dati per ulteriori informazioni.
La piattaforma o gli script utilizzati in Kettle non vengono aggiornati o migrati automaticamente. Se si utilizza l'agente dati legacy (con Kettle 4.4), è necessario utilizzare il collegamento nella sezione Scarica agente legacy nell'interfaccia utente Agente dell'integrazione. Per eseguire l'aggiornamento a Kettle 6, è necessario reinstallare il nuovo Agente dati e la nuova versione di Kettle su un sistema su cui non è mai stata installata una versione di Kettle in precedenza.
Le origini dati con script sono destinate ai responsabili dell'implementazione di processi ETL avanzati, con esperienza nella creazione di script Pentaho Kettle e nell'utilizzo dell'interfaccia utente Spoon. Per ulteriori informazioni su Pentaho Kettle e Spoon, tra cui un'ampia documentazione ed esercitazioni, consultare https://docs.hitachivantara.com/p/pentaho-dia.
Per configurare un'origine dati con script:
  1. Accedere a Designer dati selezionando
    Integrazione > Progettazione integrazioni
    .
  2. Nella cartella Origine dati della Libreria dei componenti, sul lato destro dello schermo, fare clic su
    Crea nuova origine dati
    . Viene visualizzata la finestra di dialogo Crea nuovo.
  3. Selezionare
    Origine dati con script
     come tipo di origine dati e immettere un nome per l'origine dati.
  4. Fare clic su
    Crea
    . L'area centrale della schermata mostra le impostazioni della nuova origine dati e altre informazioni.
  5. Immettere le informazioni dell'origine dati:
    • Agente associato:
       selezionare l'agente dall'elenco a discesa.
    • Punto di ingresso:
       selezionare un punto di ingresso dall'elenco a discesa. Il punto di ingresso è uno script ETL nel sistema. È possibile modificarlo in un secondo momento.
    • Livello registro:
       selezionare un livello di registro dall'elenco a discesa per specificare i dettagli della registrazione per questa origine dati. Le opzioni disponibili sono:
    • Errore:
       registra solo gli errori gravi.
    • Info:
       registra tutte le informazioni di base, ad esempio quando è stata aggiornata l'origine dati.
    • Dettagli:
       fornisce informazioni dettagliate su tutte le fasi e le azioni. Questo livello viene utilizzato principalmente per il debug o la verifica, perché può aggiungere al registro una quantità di informazioni eccessiva.
    • URI origine:
       immettere gli URI a cui si connettono gli script, separati da punti e virgola (;). Questo campo viene utilizzato solo per consentire all'utente di identificare e documentare i sistemi di origine sottostanti ai quali si connettono gli script, e non viene utilizzato dal software per nessun altro scopo.
  6. Fare clic su
    Salva
     nel menu Azioni.

Avviare Spoon

Dopo aver salvato le informazioni di base per l'origine dati con script, è possibile avviare l'editor di script ETL Spoon, utilizzare lo script e aggiungere tabelle all'origine dati con script.
Per visualizzare e modificare lo script:
  1. Nel menu Start di Windows, fare clic su
    Tutti i programmi
    .
  2. Aprire la cartella Workday Adaptive Planning Data Agent. Per le versioni dell'agente dati 7.1.44 e precedenti, aprire la cartella Adaptive Data Agent.
  3. Fare clic su Adaptive Script Editor. Dopo una schermata iniziale di Pentaho e un suggerimento di avvio, viene visualizzata la schermata di Spoon.
  4. Immettere il
    Adaptive Planning
     e-mail e password di accesso e fare clic
    su Accedi ora/Aggiorna elenco tenant
    . Se sono stati sincronizzati utenti da Workday, consultare Accesso all'agente dati e all'editor di script con credenziali Workday.
  5. Selezionare il tenant dall'elenco a discesa. In genere è presente un solo tenant. Spoon aggiorna l'elenco dei tenant.
  6. Selezionare l'agente in uso per l'origine dati corrente dall'elenco a discesa. Spoon aggiorna l'elenco degli agenti.
  7. Selezionare l'origine dati con script appena creata dall'elenco a discesa in Edit Script.
Dopo aver eseguito l'accesso e aver indicato a Spoon l'agente e l'origine dati su cui si sta lavorando, è possibile iniziare a modificare lo script.
  1. Fare clic su Data Integration nell'angolo in alto a destra della schermata di Spoon. Viene visualizzata la prospettiva dell'integrazione di Spoon.
  2. Selezionare
    File > Open
     e individuare lo script che si desidera visualizzare e modificare, quindi fare clic su
    OK
    . Gli script origine dati con script di esempio inclusi nell'integrazione forniscono informazioni sulla struttura degli script e sulle connessioni al database che possono essere utili quando si sviluppano script personalizzati.
  3. Modificare lo script in base alle esigenze, quindi salvarlo.
  4. Fare clic su Adaptive Insights in alto a destra per tornare alla prospettiva Adaptive. Viene visualizzata di nuovo la schermata di Spoon.
  5. Fare clic su
    Publish Agent Changes
    . In questo modo viene eseguito il push dello script
    Adaptive Planning
     server, dove è archiviato nel repository di script.
Sono supportate le seguenti modalità di importazione dei dati. Le impostazioni possono variare a seconda della tabella.
  • Tutti i record vengono sostituiti a ogni importazione dei dati.
  • L'agente remoto scansiona tutti i record di origine e trasmette i record modificati ogni volta che è necessario sincronizzare i dati.
  • Vengono trasmessi tutti i record che rientrano in un determinato intervallo di tempo.

Aggiungere tabelle e colonne a un'origine dati con script

Una volta impostato lo script, è possibile aggiungere tabelle e colonne all'origine dati nell'integrazione.
È essenziale che le colonne definite nell'origine dati corrispondano esattamente alle colonne definite nello script ETL, altrimenti il caricamento dei dati avrà esito negativo.
Per aggiungere tabelle a un'origine dati con script, attenersi alla seguente procedura:
  1. Espandere la voce Tabella personalizzata nel menu Componenti dati.
  2. Trascinare l'elemento
    Tabella con script
     nell'area Tabelle da importare. Quando si rilascia questo elemento, viene visualizzata la finestra di dialogo Tabella con script.
  3. Immettere le impostazioni della tabella:
    • Nome:
       immettere il nome della tabella.
    • Modalità di importazione dati:
       selezionare una delle modalità di importazione:
      • Tutti i record sostituiti ogni volta che viene eseguita un'importazione dati:
         questa è l'impostazione predefinita. Ogni volta che si importano dati, tutti i record nell'area di gestione temporanea vengono sostituiti.
      • Cache remota utilizzata per identificare e inviare i record modificati al momento dell'importazione:
         l'integrazione esamina l'area di gestione temporanea, la confronta con i record nel foglio di calcolo o nel database e importa solo i record modificati.
      • Tutti i record che rientrano in un intervallo di tempo trasmesso:
         quando si seleziona questa modalità, viene richiesto di immettere un intervallo di tempo e una colonna alla quale l'integrazione applica l'intervallo. Tutti i record che soddisfano questo criterio di selezione vengono importati.
    • Filtro importazione dati:
       consente di immettere un'espressione SQL per filtrare o formattare le informazioni da importare. Il filtro SQL viene applicato prima che i dati vengano estratti dal database, per ridurre la quantità di dati da importare e garantire un ulteriore livello di controllo sui dati da inserire nell'area di gestione temporanea. Fare clic sul campo per visualizzare la finestra di dialogo Modifica filtro SQL, descritta in precedenza. Il filtro immesso qui viene applicato ai dati effettivi nel database, anziché ai dati di anteprima nell'area di gestione temporanea.
  4. Fare clic su
    Applica
     per applicare le impostazioni.
Per aggiungere colonne a un'origine dati con script, attenersi alla seguente procedura:
  1. Espandere la voce Colonna personalizzata nel menu Componenti dati.
  2. Trascinare uno dei tipi di colonna nell'area Tabelle da importare. Quando si rilascia questo elemento, viene visualizzata la finestra di dialogo Colonna personalizzata.
  3. Immettere le impostazioni delle colonne:
    • Nome:
       immettere il nome della colonna. I nomi delle colonne devono corrispondere esattamente ai nomi delle colonne specificati nello script di Spoon, incluse le maiuscole e gli spazi incorporati.
    • Tipo di colonna:
       campo di sola visualizzazione che identifica il tipo di colonna.
    • Converti tipo di colonna:
       non è possibile modificare questo valore, salvo per le colonne SQL. Per le colonne SQL, è possibile selezionare un'opzione di conversione tra le sei disponibili.
  4. Fare clic su
    Applica
     per applicare le impostazioni.

Gestire le colonne

Se una tabella in uso ha un numero di colonne elevato, è possibile utilizzare Gestisci colonne per apportare modifiche rapide alle colonne da importare. La finestra di dialogo Gestisci colonne mostra le colonne presenti in una tabella, e consente di selezionare o deselezionare le colonne da importare.
Per gestire le colonne per l'importazione:
  1. Fare clic sulla freccia nella scheda a destra del nome della tabella. Viene visualizzato un menu mobile con diverse opzioni.
  2. Fare clic su
    Gestisci colonne
     nel menu mobile. Viene visualizzata la finestra di dialogo Gestisci colonne.
  3. Per importare una colonna, selezionare la casella accanto alla colonna. Quando si seleziona una colonna, dopo il salvataggio del contenuto del popup la colonna viene visualizzata anche nella finestra di anteprima. Se si deseleziona una colonna, questa viene rimossa dalla finestra di anteprima. Non è possibile modificare lo stato dell'importazione nei campi generati dal sistema, ad esempio
    isDeleted
    . È anche possibile modificare lo stato dell'importazione di singole colonne selezionando le proprietà della colonna e impostando la proprietà corrispondente, oppure trascinando e rilasciando le colonne nel designer.

Personalizzare le tabelle

Per ogni tabella, è possibile personalizzare la modalità di importazione dei dati.
Per personalizzare le impostazioni della tabella, attenersi alla seguente procedura:
  1. Fare clic sulla freccia nella scheda a destra del nome della tabella. Viene visualizzato un menu mobile con diverse opzioni.
  2. Fare clic su
    Impostazioni tabella
     nel menu mobile.
  3. Fare clic su
    Applica
     per applicare le impostazioni.
  4. Ripetere i passaggi da 1 a 3 per ciascuna tabella.
  5. Fare clic su
    Salva
     per salvare le impostazioni nell'origine dati.

Impostare le opzioni per le colonne

Quando si utilizza la sezione Tabelle da importare, è possibile visualizzare un'anteprima dei dati come sono nell'origine dati oppure come sono nell'area Gestione temporanea dopo l'importazione. È possibile modificare le opzioni per ogni colonna passando il puntatore del mouse sull'intestazione e facendo clic sull'elenco a discesa accanto al nome. Le opzioni sono:
  • Ordinamento crescente:
     consente di ordinare l'intera tabella in ordine crescente in base a questa colonna.
  • Ordinamento decrescente:
     consente di ordinare l'intera tabella in ordine decrescente in base a questa colonna.
  • Impostazioni colonna:
     questa finestra di dialogo consente di modificare le proprietà della colonna all'interno della tabella di gestione temporanea.
  • Nome:
     il nome della colonna, visualizzato nell'intestazione.
  • Tipo di colonna:
     il tipo di dati utilizzati nella colonna.
  • Converti tipo di colonna:
     selezionare il nuovo tipo da questo menu a discesa.
  • Escludi colonna dall'importazione:
     selezionare questa opzione per rimuovere la colonna dai dati da importare.
  • Elimina colonna:
     selezionare questa opzione per eliminare la colonna. L'opzione è disponibile solo per le colonne personalizzate.

Scaricare dati da una tabella di gestione temporanea

È possibile scaricare dati da una singola tabella di gestione temporanea.
Per scaricare i dati da una singola tabella di gestione temporanea:
  1. Fare clic sulla freccia giù nell'intestazione di una tabella presente nella sezione Tabelle da importare.
  2. Selezionare
    Scarica dati
    .
  3. All'elenco di valori
    Questa operazione invierà un'e-mail con un URL per scaricare i dati
    , fare clic su
    Invia
    .
    Adaptive Planning
     invia un'e-mail contenente un URL all'account e-mail associato al designer dati.
  4. Aprire l'e-mail e fare clic sull'URL. I dati vengono scaricati in formato CSV.

Utilizzare il filtro avanzato

Nel menu a discesa Origine è possibile fare clic su
Filtro avanzato
 per visualizzare le opzioni di filtro dei dati nell'area di anteprima
Tabelle da importare
. Il filtro avanzato include strumenti che consentono visualizzare ed esplorare un sottoinsieme di dati all'interno di una tabella di gestione temporanea o dallo script. Quando si seleziona Script dall'elenco a discesa Origine, la richiesta di anteprima viene inviata all'agente per l'elaborazione. Modificando le proprietà del filtro è possibile cambiare la visualizzazione dei dati mostrati nella finestra di anteprima, senza modificare i dati nell'area di gestione temporanea.
L'area di anteprima ha lo scopo specifico di visualizzare in anteprima una piccola parte dei dati nell'area di gestione temporanea. È possibile esplorare i dati presenti nel foglio di calcolo e verificare che si stanno ottenendo i dati previsti consultando l'area di gestione temporanea. I filtri impostati nella funzione di anteprima non influiscono sui dati effettivi presenti nell'area di gestione temporanea.
Le opzioni per il Filtro avanzato sono:
  • Righe distinte
    : selezionare questa casella per nascondere le righe duplicate.
  • Righe max
    : inserire un numero nella casella di testo per limitare il numero di righe visualizzate nell'area di anteprima.
  • Colonne:
     selezionare o deselezionare colonne in questo menu a discesa per mostrare o nascondere le colonne visualizzate.
La rimozione di una colonna da questo elenco non comporta la rimozione della colonna dall'elenco di importazione.
  • Filtro SQL
    : fare clic sulla casella di testo grande per visualizzare la finestra di dialogo Modifica filtro SQL (descritta in precedenza), nella quale è possibile specificare un filtro SQL per limitare le righe visualizzate in anteprima. Fare clic su
    Applica
     per verificare automaticamente la sintassi SQL del filtro. Se sono presenti errori, l'errore viene indicato nell'espressione. Per informazioni dettagliate sulla sintassi SQL, fare clic sulla guida online nella sezione Note.
Fare clic su
Rimuovi filtro
 (accanto al menu a discesa Origine) per cancellare tutte le impostazioni avanzate del filtro.
Nell'ambito del processo di personalizzazione delle tabelle, è anche possibile creare tabelle congiunte e colonne personalizzate utilizzando espressioni SQL.

Aggiungere e modificare i parametri

È possibile utilizzare parametri per passare informazioni allo script Kettle sottostante. Questi parametri possono essere impostati con un valore predefinito. Lo script può quindi utilizzare i parametri per controllare le trasformazioni e i filtri negli script ETL.
Per aggiungere un parametro:
  1. Fare clic sull'icona
    Modifica parametri
     a destra dell'intestazione Parametri. Viene visualizzata la finestra di dialogo Editor parametri.
  2. Nel riquadro a sinistra, fare clic sulla cartella alla quale si desidera aggiungere un parametro. Il nome della cartella viene visualizzato nel riquadro a destra.
  3. Fare clic su
    Aggiungi
     e selezionare una delle seguenti opzioni dal menu mobile:
    • Cartella
      : consente di creare una nuova cartella.
    • Booleano
      : consente di creare un parametro booleano (vero/falso).
    • Intero
      : consente di creare un parametro numero intero.
    • Testo
      : consente di creare un parametro di testo.
    • Password
      : consente di creare un parametro password.
    • Intervallo di tempo
      : consente di creare un parametro intervallo di tempo (data da/a).
    • Dimensione
      : consente di creare una dimensione.
    • Versione importi effettivi
      : consente di creare una versione importi effettivi.
    • Versione pianificata
      : consente di creare una versione pianificata.
  4. Nel riquadro a destra, immettere le informazioni relative all'opzione selezionata.
  5. Fare clic su
    Applica
    .
È possibile modificare i singoli parametri o le cartelle facendo doppio clic sull'elemento che si desidera modificare nel riquadro a sinistra e apportando modifiche alle informazioni nei campi, quindi facendo clic su Applica per salvare le modifiche.
È anche possibile creare cartelle per raggruppare i parametri, quindi trascinare i parametri nella cartella.

Importare dati tramite un'origine dati con script

Dopo aver impostato e salvato l'origine dati con script, è possibile importare dati.
Per importare dati tramite un'origine dati con script:
  1. Fare clic su
    Importa dati
     nel menu Azioni. I dati selezionati vengono filtrati in base agli script ETL e alle eventuali espressioni SQL e caricati nell'area di gestione temporanea. È possibile visualizzare in anteprima i dati nell'area di gestione temporanea.
I dati rimangono nell'area di gestione temporanea fino a quando non vengono cancellati o fino a quando un successivo caricamento di dati non ne determina la cancellazione, in base all'impostazione attiva di Modalità di importazione dati.
Per cancellare i dati dall'area di gestione temporanea:
  1. Fare clic su
    Cancella tabelle di gestione temporanea
     nel menu Azioni. Viene cancellata l'area di gestione temporanea di tutte le tabelle dell'origine dati.