Vai al contenuto principale Passa a contenuto complementare
Risorse Qlik

Prerequisiti

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

  • Installare il driver richiesto sul server del Gateway di Data Movement

    Nota informatica

    Questo è richiesto solo se si è scelto di utilizzare il Gateway di Data Movement. Per informazioni sui vantaggi del Gateway di Data Movement e quando è richiesto, vedere Qlik Data Gateway - Spostamento 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 Data Movement.

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

    python3 --version

Installazione di driver

Per scaricare e installare driver:

  1. Sul computer gateway Data Movement, 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 Data Movement. 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 Data Movement, 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 Data Movement. Una volta completata l'operazione, eseguire nuovamente il comando update 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. interrompere tutte le attività configurate per utilizzare il connettore.

  2. Sul computer gateway Data Movement, 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.

Una volta installato Gateway di Data Movement, scaricare il driver oracle-instantclient-basiclite-<version>.x86_64.rpm. È possibile trovare un collegamento di download diretto alla versione supportata in binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/oracle.yaml. Una volta completato il download, copiare il file RPM nel computer Gateway di Data Movement.

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

  1. Arrestare il servizio gateway di Data Movement:

    sudo systemctl stop repagent

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

    sudo systemctl status repagent

    3. Lo stato dovrebbe essere il seguente:

    Active: inactive (dead) since <timestamp> ago

  3. Installare il driver (RPM).

  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:

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

  5. Cambiare la directory di lavoro a <gateway di Data Movement-Install-Dir>/bin e aggiungere la variabile di ambiente LD_LIBRARY_PATH alla directory client istantanea di Oracle e alla directory gateway di Data Movement 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, conferma che la posizione del driver è stata copiata:

    cat site_arep_login.sh

  7. Avviare il servizio gateway di Data Movement:

    sudo systemctl start repagent

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

    sudo systemctl status repagent

    Lo stato dovrebbe essere il seguente:

    Active: active (running) since <timestamp> ago

Fornire l'accesso all'account Oracle

È necessario fornire all'utente gateway di Data Movement 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 gateway di Data Movement, 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

spostamento 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