Passa al contenuto principale
Documentazione
Documentazione
Adaptive Planning
Ultimo aggiornamento: 2024-09-20
Procedura: Configurare origini dati database JDBC

Procedura: Configurare origini dati database JDBC

È possibile utilizzare
Adaptive Planning
 Integrazione per estrarre informazioni da database compatibili con JDBC. La maggior parte dei database utilizzati per le applicazioni contabili e finanziarie è compatibile con JDBC (Java Database Connectivity). JDBC è uno standard che utilizza il linguaggio di programmazione Java per fornire connettività a una vasta gamma di database.
Un'origine dati del database compatibile con JDBC richiede un driver. La tabella seguente fornisce informazioni sui driver JDBC comuni.
Gli agenti dati di Adaptive Planning si connettono solo ai database locali. La connessione ai database cloud con un agente non è supportata.
Origine JDBC
Panoramica
Jar del provider
Classe driver
Esempio JDBC/URL
Informazioni URL JDBC
Oracle
ojdbc6-11.2.0.3.jar
È possibile ottenere questo file dal sito Web di Oracle o tramite il repository Maven di Oracle.
oracle.jdbc.OracleDriver
jdbc:oracle:thin:@example-win-db:1521:ANACONDA
SQL Server
jtds-1.3.1.jar distribuito nella cartella Plugin agente dati.
net.sourceforge.jtds.jdbc.Driver
jdbc:jtds:sqlserver://127.0.0.1:1433/AGENT_TEST; domain=ADAPTIVE;instance=SQLEXPRESS
SQL Server
sqljdbc41.jar distribuito nella cartella Data Agent Plugins.
com.microsoft.sqlserver.jdbc.SQLServerDriver
jdbc:sqlserver://localhost:1433;databaseName=AdventureWorks;user=MyUserName;password=*****;
MySql
com.mysql.jdbc.Driver
jdbc:mysql://localhost:3306/AGENT_TEST
h2
Cercare h2*.jar nella distribuzione Workday Adaptive Planning Data Agent Service Manager. Per le versioni dell'agente dati 7.1.44 e precedenti, cercare h2.jar nella distribuzione del gestore servizi agente dati di Adaptive.
org.h2.Driver
jdbc:h2:/data/test
I file jar risiedono in
C:/Program Files/Workday Adaptive Planning Data Agent/Plugins.
Per le versioni dell'agente dati 7.1.44 e precedenti, utilizzare
C:/Program Files/Adaptive Data Agent/Plugins
directory sul computer che ospita il servizio agente dati.
Dopo aver aggiunto un file jar, è necessario accedere ai servizi locali e riavviare il servizio Agente dati.
Prima di poter configurare un'origine dati da un database locale, è necessario creare un agente dati che lo indichi
Adaptive Planning
 Integrazione come comunicare con il database. Per informazioni su come creare agenti dati, consultare Creare agenti dati.
Per configurare un'origine dati del database JDBC, attenersi alla seguente procedura:
  1. Accedere a Designer dati selezionando
    Integrazione > Designer dati
    .
  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 come tipo di origine dati il database JDBC, immettere il nome del database e selezionare l'agente che si desidera utilizzare 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 dati di Adaptive Planning a cui connettersi. Questo elenco contiene tutti gli agenti dati trovati in
      Agenti dati
      libreria componenti
      .
    • Classe driver:
       immettere la classe del driver per il database. Queste informazioni possono essere richieste al fornitore del database.
    • URL:
       immettere l'URL del database.
    • Nome utente:
       immettere il nome utente utilizzato per accedere al database.
    • Password:
       immettere la password associata al nome utente.
    • Filtro schema:
       immettere il nome del o degli schemi da cui si desidera importare i dati. Se si immettono i nomi di più schemi, separarli con un punto e virgola. Utilizzare questo campo per limitare il numero di tabelle in cui è necessario aggiornare
      Adaptive Planning
       Integrazione Questo campo è facoltativo.
    • 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.
  6. Fare clic su
    Salva
     nel menu Azioni.
È possibile testare le informazioni di connessione nella nuova origine dati facendo clic su
Test di connessione
 nel menu
Azioni
. Il sistema tenta di connettersi al database utilizzando le informazioni presenti nei campi dell'origine dati. Se il sistema è in grado di connettersi al database, fare clic su
OK
. In caso di problemi di connessione, correggere gli errori e riprovare.
Quando la connessione al database riesce, è possibile importare la struttura di dati. Vengono visualizzate le tabelle e le colonne del database.
Vengono visualizzate solo le colonne corrispondenti ai tipi supportati. Supported Column Types, elenca i tipi di colonna supportati per i vari tipi di database.
Per importare la struttura del database JDBC, procedere come segue:
  1. Fare clic su
    Importa struttura
     nel menu
    Azioni
    . Le tabelle e le colonne vengono visualizzate nel menu
    Componenti dati
    .
    Le modalità di importazione dei dati influiscono sulla modalità di sincronizzazione dei dati. La modalità di importazione predefinita (tutti i record sostituiti) per un'origine dati JDBC è la seguente:
  2. I dati JDBC vengono importati.
  3. I dati provenienti dall'origine dati JDBC popolano la tabella di gestione temporanea.
  4. Se è presente un filtro SQL personalizzato, viene applicato ai dati importati dal server del database, per definire il sottoinsieme di dati da importare.
È anche possibile scegliere di aggiungere le informazioni importate (in tal caso i dati importati vengono aggiunti alla tabella di gestione temporanea esistente) o di unire le informazioni importate (in tal caso le righe esistenti nei dati JDBC vengono unite alle righe nell'area di gestione temporanea).

Aggiungere tabelle a un'origine dati JDBC

Dopo aver importato la struttura del database, è possibile specificare le informazioni che si desidera importare dal database. La sezione
Tabelle da importare
 consente di configurare i dati importati dal database.
Per specificare le tabelle da importare dal database, attenersi alla seguente procedura:
  1. Espandere la voce corrispondente all'origine dati nel menu
    Componenti dati
    .
    Ogni tabella del database viene visualizzata come elemento separato.
  2. Trascinare e rilasciare le tabelle che si desidera importare nella sezione
    Tabelle da importare
    , al centro dello schermo.
    Quando si trascina una tabella nella sezione Tabelle da importare, viene visualizzata una scheda per la tabella e le informazioni del database appaiono nella sezione Tabelle da importare, consentendo di visualizzare il tipo di informazioni aggiunte. La scheda di ogni tabella include anche un menu a discesa, al quale si accede facendo clic sulla freccia accanto al nome.

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, attenersi alla seguente procedura:
  1. Fare clic sulla freccia nella scheda a destra del nome della tabella.
  2. Fare clic su
    Gestisci colonne
     nel menu mobile.
  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.
È anche possibile modificare lo stato dell'importazione di singole colonne:
  • Selezionando le proprietà della colonna e impostando la proprietà
  • Trascinando nel designer le colonne selezionate
Non è possibile modificare lo stato dell'importazione nei campi generati dal sistema, ad esempio
isDeleted
.

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.
  2. Fare clic su
    Impostazioni tabella
     nel menu mobile.
  3. Immettere le impostazioni della tabella:
    • Modalità di importazione dati:
       selezionare un'opzione dall'elenco a discesa.
      • Tutti i record sostituiti ogni volta che viene eseguita un'importazione dati:
         questa è l'impostazione predefinita. I dati nella tabella di gestione temporanea vengono sostituiti dai dati importati dall'origine.
      • Cache remota utilizzata per identificare e inviare i record modificati al momento dell'importazione:
         vengono importati solo i record di database nuovi o modificati. I record modificati sovrascrivono i record esistenti nell'area di gestione temporanea. I record nuovi vengono aggiunti alla fine delle informazioni nell'area di gestione temporanea.
      • Tutti i record che rientrano in un intervallo di tempo trasmesso:
         vengono importati tutti i record inclusi nell'intervallo di tempo specificato. I record nella tabella di gestione temporanea corrispondenti ai periodi importati vengono eliminati prima dell'importazione dei dati più recenti dall'origine.
    • 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
      . Il filtro immesso qui viene applicato ai dati effettivi nel database, anziché ai dati di anteprima nell'area di gestione temporanea. Non tutte le origini dati supportano lo stesso livello di funzionalità di filtro SQL.
  4. Fare clic su
    Applica
     per applicare le impostazioni.
  5. Ripetere i passaggi da 1 a 3 per ciascuna tabella.
    Se per una tabella di database sono state definite delle chiavi, anche queste informazioni vengono inserite nella tabella di gestione temporanea. È possibile rivedere queste informazioni e modificarle in base alle esigenze.
  6. 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 nello stato in cui si trovano nell'origine dati o nell'area di gestione temporanea dopo l'importazione. È possibile modificare le opzioni per ogni colonna passando il puntatore del mouse sull'intestazione e facendo clic sul menu a discesa accanto al nome della colonna. 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
      : 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, attenersi alla seguente procedura:
  1. Fare clic sulla freccia giù nell'intestazione di una tabella presente nella sezione Tabelle da importare.
  2. Selezionare
    Scarica dati
    .
  3. Fare clic su
    Invia
     nell'elenco valori
    L'operazione invierà un'e-mail con un URL per scaricare i dati
    .
    Adaptive Planning
     L'integrazione 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 il menu a discesa
Origine
 è possibile fare clic su
Filtro avanzato
 per visualizzare le opzioni di filtro dati disponibili nell'area di anteprima
Tabelle da importare
.
Filtro avanzato
 offre strumenti per visualizzare e sfogliare un sottoinsieme di dati all'interno di una tabella di gestione temporanea o direttamente dall'origine remota (se si seleziona Database JDBC dal menu a discesa Origine). 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 apposito di visualizzare in anteprima una piccola parte dei dati nell'area di gestione temporanea (o nel database JDBC). Esaminando l'area di gestione temporanea, è possibile esplorare i dati disponibili nell'origine dati JDBC e verificare di ottenere i dati previsti. È anche possibile utilizzare questa opzione per perfezionare il filtro di importazione dati che si desidera utilizzare. I filtri impostati nella funzione di anteprima non influiscono sui dati effettivi presenti nell'area di gestione temporanea.
I
Filtri avanzati
 includono:
  • 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
    , 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. L'espressione immessa viene visualizzata nel campo
    Filtro avanzato
    . Per informazioni dettagliate sulla sintassi SQL, è possibile fare clic su Guida in linea 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.

Importare dati da un database JDBC

Dopo aver impostato e salvato l'origine dati JDBC, è possibile importare i dati.
Per importare dati da un database JDBC, procedere come segue:
  1. Fare clic su
    Importa dati
     nel menu
    Azioni
    .
    I dati selezionati vengono filtrati in base alle eventuali espressioni SQL e caricati nell'area di gestione temporanea. È possibile visualizzare in anteprima i dati nell'area di gestione temporanea.
Le informazioni rimangono nell'area di gestione temporanea fino a quando non vengono cancellate manualmente o dal successivo caricamento di dati, in base alla modalità di importazione.
Per cancellare i dati dall'area di gestione temporanea, procedere come segue:
  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.
Per rimuovere i caratteri specificati dai flussi di testo di input nelle origini dati JDBC:

Associare un'origine dati JDBC a un agente dati Adaptive Planning diverso

È possibile modificare l'agente dati di Adaptive Planning da associare all'origine dati JDBC.
  1. Verificare che l'agente dati a cui si desidera connettersi sia elencato in
    Agenti dati
    libreria componenti
    .
  2. Accedere all'origine dati JDBC in Design Integrations.
  3. Selezionare l'agente dati nel campo
    Agente associato
     nella sezione
    Impostazioni
     .

Schemi esclusi dall'origine dati JDBC

Le origini dati JDBC che si connettono a Oracle o MS SQL Server escludono in modo esplicito alcuni schemi che non sono correlati ai dati finanziari.

Schemi esclusi dall'origine dati JDBC in Oracle

CTXSYS, MDSYS, SYSTEM, SYS, XDB

Schemi esclusi dall'origine dati JDBC in MS SQL Server

INFORMATION_SCHEMA, SYS

Suggerimenti per la risoluzione dei problemi

Potrebbero verificarsi alcuni problemi relativi all'origine dati, che presentano soluzioni non sempre evidenti.
Quando si importa la struttura di un database e il database contiene più di 1000 tabelle, un messaggio di errore consiglia di filtrare l'elenco di tabelle. È possibile aggirare l'errore in uno dei seguenti modi:
  • Modificando l'origine dati JDBC e inserendo un filtro di schema.
  • Modificando le autorizzazioni associate all'accesso utilizzato per accedere al server, in modo da limitare il numero di tabelle raggiungibili con tale accesso.
Quando si importa la struttura di un database Oracle, gli schemi seguenti non vengono importati come parte della struttura:
CTXSYS, MDSYS, SYSTEM, SYS,
e
XDB
. Si tratta di schemi di sistema Oracle, che non sono necessari ai fini dell'integrazione dei dati.
Quando si importa la struttura di un database MS SQL, gli schemi seguenti non vengono importati come parte della struttura: INFORMATION_SCHEMA e SYS. Si tratta di schemi di sistema MS SQL, che non sono necessari ai fini dell'integrazione dei dati.