Vai al contenuto principale Passa a contenuto complementare
Risorse Qlik

Prerequisiti

Prima di trasferire i dati, assicurarsi di aver completato i seguenti prerequisiti:

  • Installare il driver richiesto sul server del gateway Movimento dati

  • Concedere le autorizzazioni necessarie alla sorgente dati

  • Configurare il connettore della sorgente dati

Configurazione del driver

È possibile installare driver utilizzando l'utilità di installazione dei driver (procedura consigliata) oppure manualmente. Si consiglia di utilizzate l'installazione manuale nel caso improbabile che si riscontrasse un problema con l'utilità di installazione dei driver.

Utilizzo dell'utilità di installazione dei driver per installare il driver

Questa sezione descrive come installare il driver richiesto. Il processo prevede l'esecuzione di uno script che scarica, installa e configura automaticamente il driver richiesto. È inoltre possibile eseguire script per aggiornare e disinstallare il driver secondo le necessità.

Preparazione dell'installazione

  • Assicurarsi che Python 3.6.x o versione successiva sia installato sul server del gateway di Movimento dati.

    Python è preinstallato nella maggior parte delle distribuzioni Linux. È possibile verificare quale versione di Python è installata sul sistema, eseguendo il seguente comando:

    python --version

Installazione di driver

Per scaricare e installare driver:

  1. Sul computer gateway Movimento dati, cambiare la directory di lavoro in:

    opt/qlik/gateway/movement/drivers/bin

  2. Eseguire il comando seguente:

    Sintassi:

    ./install oracle

    Se non è possibile scaricare driver (a causa di restrizioni di accesso o problemi tecnici), verrà visualizzato un messaggio con le istruzioni su dove scaricare il driver e copiarlo sul computer gateway Movimento dati. Una volta completata l'operazione, eseguire nuovamente il comando install oracle.

    Altrimenti, verrà visualizzato l'EULA del driver.

  3. Effettuare una delle seguenti operazioni:

    • Premere ripetutamente [Invio] per scorrere lentamente l'EULA.
    • Premere ripetutamente la barra spaziatrice per scorrere rapidamente l'EULA.
    • Premere q per uscire dal testo della licenza e visualizzare le opzioni di accettazione dell'EULA.

  4. Effettuare una delle seguenti operazioni:

    • Digitare "y" e premere [Invio] per accettare l'EULA e avviare l'installazione.
    • Digitare "n" e premere [Invio] per rifiutare l'EULA e uscire dall'installazione.

    • Digitare "v" e premere [Invio] per visualizzare nuovamente l'EULA.

    5. Il driver verrà installato.

Aggiornamento del driver

Eseguire il comando aggiorna se si desidera disinstallare le versioni precedenti del driver prima di installare il driver fornito.

Per scaricare e aggiornare driver:

  1. Sul computer gateway Movimento dati, cambiare la directory di lavoro in:

    opt/qlik/gateway/movement/drivers/bin

  2. Eseguire il comando seguente:

    Sintassi:

    ./update oracle

    Se non si riesce a scaricare il driver (a causa di restrizioni di accesso o problemi tecnici), verrà visualizzato un messaggio con le istruzioni su dove scaricare il driver e copiarlo sul computer gateway Movimento dati. Una volta completata l'operazione, eseguire nuovamente il comando install oracle.

    Altrimenti, verrà visualizzato l'EULA del driver.

  3. Effettuare una delle seguenti operazioni:

    • Premere ripetutamente [Invio] per scorrere lentamente l'EULA.
    • Premere ripetutamente la barra spaziatrice per scorrere rapidamente l'EULA.
    • Premere q per uscire dal testo della licenza e visualizzare le opzioni di accettazione dell'EULA.

  4. Effettuare una delle seguenti operazioni:

    • Digitare "y" e premere [Invio] per accettare l'EULA e avviare l'installazione.
    • Digitare "n" e premere [Invio] per rifiutare l'EULA e uscire dall'installazione.
    • Digitare "v" e premere [Invio] per rivedere l'EULA dall'inizio.

    5. Il vecchio driver verrà disinstallato e il nuovo driver verrà installato.

Disinstallazione del driver

Eseguire il comando di disinstallazione se si desidera disinstallare il driver.

Per disinstallare il driver:

  1. Se il gateway Movimento dati viene utilizzato per trasferire dati, interrompere tutte le attività di trasferimento. Se un gateway Movimento dati differente viene utilizzato per eseguire processi ELT sulla destinazione, interrompere tutte le relative attività (trasformazioni, archiviazione, registrazione di dati e data mart). Se un singolo gateway Movimento dati viene utilizzato per trasferire dati ed eseguire attività ELT sulla destinazione, interrompere tutte le suddette attività.

  2. Sul computer gateway Movimento dati, cambiare la directory di lavoro in:

    opt/qlik/gateway/movement/drivers/bin

  3. Eseguire il comando seguente:

    Sintassi:

    ./uninstall oracle

    Il driver verrà disinstallato.

Installazione manuale del driver

Si consiglia di tentare l'installazione manuale di driver nel caso in cui l'installazione automatizzata non venissa completata.

Scaricare la versione 12.0 di Oracle Instant Client per Linux (x86-64) da https://www.oracle.com/database/technologies/instant-client/linux-x86-64-downloads.html.

Esempio di nome file: oracle-instantclient12.2-basic-12.2.0.1.0-1.x86_64.rpm

Quindi, sul server Data Movement gateway, aprire un prompt della shell e procedere come segue:

  1. Arrestare il servizio Data Movement gateway:

    sudo service repagent stop

  2. Facoltativamente, confermare che il servizio è stato interrotto:

    sudo service repagent status

    L'output dovrebbe essere il seguente:

    not running: /opt/qlik/gateway/movement/bin/agentctl -d /opt/qlik/gateway/movement/data service host

  3. Installare la versione 12.0 di Oracle Instant Client per Linux (x86-64) o successiva.

  4. Inoltre, se non è già incluso nel tuo sistema, creare un collegamento simbolico nella directory $Oracle_Home\lib. Assegnare un nome al link libclntsh.so e collegarlo a una versione specifica di questo file.

    Esempio - client Oracle 12c:

    lrwxrwxrwx 1 oracle oracle 63 Oct 2 14:16 libclntsh.so -> /u01/app/oracle/home/lib/libclntsh.so.12.1

  5. Modificare la directory di lavoro in <Data Movement gateway-Install-Dir>/bin ed eseguire una delle seguenti operazioni in base alla versione del driver:

    Versioni 12-18 di Oracle Instant Client:

    Aggiungere la variabile di ambiente LD_LIBRARY_PATH alla directory Oracle lib copiando il percorso del driver nel file site_arep_login.sh:

    echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/u01/app/oracle/home/lib/" >> site_arep_login.sh

    Versione 19 di Oracle Instant Client o versione successiva :

    Aggiungere la variabile di ambiente LD_LIBRARY_PATH alla directory client istantanea di Oracle e alla directory Data Movement gateway lib copiando la posizione del driver nel file site_arep_login.sh:

    echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/oracle/instantclient_<version>:/opt/qlik/gateway/movement/lib/" >> site_arep_login.sh

  6. Facoltativamente, confermare che la posizione del driver è stata copiata:

    cat site_arep_login.sh

  7. Avviare il servizio Data Movement gateway:

    sudo service repagent start

  8. Facoltativamente, confermare che il servizio si è avviato:

    sudo service repagent status

    L'output dovrebbe essere il seguente:

    running: /opt/qlik/gateway/movement/bin/agentctl -d /opt/qlik/gateway/movement/data service host

Fornire l'accesso all'account Oracle

È necessario fornire all'utente Data Movement gateway l'accesso all'account Oracle. Questo utente deve avere privilegi di lettura/scrittura sul database Oracle. Per informazioni sulla configurazione dell'accesso all'account Oracle, vedere Autorizzazioni richieste.

Assicurarsi che la modalità ARCHIVELOG sia attiva

Oracle può essere eseguito in due diverse modalità: la modalità ARCHIVELOG e NOARCHIVELOG. Per utilizzare i log Oracle con Data Movement gateway, eseguire il database in modalità ARCHIVELOG. Se il log non è impostato in modalità ARCHIVELOG, eseguire la query seguente:

ALTER database ARCHIVELOG

Tenere presente che se l'istanza del database Oracle si trova su Amazon RDS, è necessario eseguire un comando diverso. Per ulteriori informazioni, vedere Abilitazione dei backup automatici e Configurazione dell'archiviazione

Configurare la registrazione supplementare

La registrazione supplementare deve essere abilitata per il database Oracle, sia a livello di database che a livello di tabella.

Nota informatica

landing Da un ambiente Oracle standby, la registrazione supplementare deve essere impostata nell'istanza Oracle primaria (come descritto di seguito), non nell'istanza standby.

Verifica e abilitazione della registrazione supplementare a livello di database

  1. Eseguire la seguente query:

    SELECT name, value, description FROM v$parameter WHERE name = 'compatible';

    Il risultato restituito dovrà essere da GE to n.n.n dove n.n.n si trova la versione del database Oracle (ad es. 10.0.0).

    Nota di avviso

    Il valore del parametro deve corrispondere alla versione reale del database.

  2. Eseguire la seguente query:

    SELECT supplemental_log_data_min FROM v$database;

    il risultato restituito dovrà essere YES o IMPLICIT.

    Abilita la registrazione supplementare eseguendo la query seguente:

    ALTER DATABASE ADD SUPPLEMENTAL LOG DATA

    Nota informatica

    Se l'istanza del database di Oracle si trova su Amazon RDS, è necessario eseguire un comando diverso. Per ulteriori informazioni, vedi Utilizzo di Amazon RDS per Oracle.

Verifica e abilitazione della registrazione supplementare a livello di tabella

  1. Per verificare se la registrazione supplementare è abilitata a livello di tabella, eseguire la query seguente:

    Sintassi:

    select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'OWNER' and TABLE_NAME='TABLE-NAME';

    Esempio:

    select count(*) from ALL_LOG_GROUPS where LOG_GROUP_TYPE='ALL COLUMN LOGGING' and OWNER= 'HR' and TABLE_NAME='EMPLOYEES';

  2. Per abilitare la registrazione supplementare a livello di tabella, eseguire la query seguente:

    Sintassi:

    ALTER TABLE TABLE-NAME ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

    Esempio:

    ALTER TABLE HR.EMPLOYEES ADD SUPPLEMENTAL LOG DATA (ALL) COLUMNS;

Vedere anche: Autorizzazioni richieste

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!

Lascia qui il tuo feedback