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.

    Notare che il Gateway di Data Movement non è disponibile con la sottoscrizione a Avvio Qlik Talend Cloud.

  • 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 sqlserver

    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 sqlserver.

    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 sqlserver

    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 sqlserver.

    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 sqlserver

    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.

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

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

  1. Arrestare il servizio Data Movement gateway:

    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. Cambiare la directory di lavoro in <product_dir>/bin.

  5. Copiare la posizione del driver nel file site_arep_login.sh come descritto di seguito:

    echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql<version>/lib64/" >> site_arep_login.sh

    Questa operazione aggiungerà il driver a "LD_LIBRARY_PATH" e aggiornerà la posizione del driver nel file 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 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

  9. Data Movement gateway richiede la seguente libreria ODBC: libmsodbcsql-17.6.so.1.1

    Per verificare quale versione della libreria è attualmente installata, emettere il seguente comando:

    ls /opt/microsoft/msodbcsql<version>/lib64/

    Se la libreria esistente ha un altro numero di versione (ad esempio, libmsodbcsql-18.0.so.1.1), è necessario creare un collegamento simbolico tra la libreria esistente e quella richiesta.

    Per fare ciò, emettere i seguenti comandi:

    cd /opt/microsoft/msodbcsql<version>/lib64/
    ln -s existing_library_name msodbcsql-18.1.so.1.1

    in cui existing_library_name è il nome della libreria attualmente installata (ad es. libmsodbcsql-18.0.so.1.1).

Nota di avvisoSe si utilizza una destinazione Microsoft Fabric, la disinstallazione di Microsoft ODBC Driver per il driver SQL Server sospenderà anche la connettività a Microsoft Fabric, poiché utilizzano lo stesso driver.

Selezione del database

Per poter selezionare un database (facendo clic su Carica database nella finestra di dialogo del connettore), l'utente specificato nelle impostazioni del connettore deve essere creato nel database principale.

Porta

Per impostazione predefinita, la porta 1434 deve essere aperta per le comunicazioni in uscita sul server gateway di Data Movement. È possibile cambiarla nelle impostazioni del connettore.

Preparazione del database per CDC.

La sezione seguente spiega come configurare il database per CDC.

Per configurare il database per CDC:

  1. Configurare il database per MS-CDC eseguendo quanto segue:

    exec source_db_name.dbo.sp_cdc_enable_db

    dove source_db_name è il nome del database di origine.

  2. L'attività landing abilita automaticamente MS-CDC per tutte le tabelle di origine. Tuttavia, se si preferisce abilitare MS-CDC manualmente, eseguire lo script seguente (per ciascuna delle tabelle di origine previste):

    exec sys.sp_cdc_enable_table

    @source_schema = N'schema_name',

    @source_name = N'table_name',

    @role_name = NULL

    dove schema_name e table_namesono rispettivamente i nomi dello schema sorgente e della tabella di origine.

    Nota informatica
    • I nomi delle tabelle CT devono utilizzare il formato di denominazione predefinito:<SchemaName>_<TableName>_CT

    • La tabella CT deve includere le seguenti colonne: [__$start_lsn], [__$end_lsn], [__$seqval], [__$operation], [__$update_mask], <tutte le colonne di dati>, [__$command_id]

  3. Assicurarsi che i processi di acquisizione e pulizia di MS-CDC siano in esecuzione.

    Nota informatica
    • È possibile controllare i lavori usando sys.sp_cdc_change_job. Per ulteriori informazioni, vedere la Guida di Microsoft.
    • Per ridurre la latenza, sarebbe utile impostare il parametro @pollinginterval su un valore piccolo.

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