Azure Synapse Analytics

È possibile utilizzare Azure Synapse Analytics come piattaforma dati per trasferire e archiviare i set di dati.

Le seguenti proprietà di connessione vengono impostate quando si crea una connessione dati in Integrazione dati Qlik Cloud e non possono essere modificate:

• Allow non-Select queries è abilitato.

• Enable Bulk Reader è disabilitato.

Per ulteriori informazioni sulla connessione a Azure Synapse Analytics, vedere Creazione di una connessione Azure Synapse Analytics (solo in lingua inglese).

L'area di gestione temporanea del cloud è il luogo in cui i dati e le modifiche vengono organizzati prima di essere applicati e archiviati. Per ulteriori informazioni, vedere Connessione a Azure Data Lake Storage come area di gestione temporanea cloud.

Autorizzazioni necessarie per il trasferimento dei dati

Autorizzazioni di archiviazione

All'utente specificato nel connettore Azure Synapse Analytics devono essere concesse le autorizzazioni di archiviazione seguenti.

• Nel contenitore di archiviazione ADLS Gen2: LIST
• Nella cartella di archiviazione ADLS Gen2: READ, WRITE e DELETE
• Nelle impostazioni di controllo degli accessi (IAM) per il file system ADLS Gen2, assegnare il ruolo "Collaboratore dati BLOB di archiviazione" a Data Movement gateway (ID app AD). Potrebbero essere necessari alcuni minuti prima che il ruolo abbia effetto.

Autorizzazioni del database

All'utente specificato nel connettore Azure Synapse Analytics devono essere concesse le autorizzazioni seguenti.

• Autorizzazioni generali

  • db_owner ROLE

• Autorizzazioni tabella:

  • SELECT, INSERT, UPDATE e DELETE
  • Caricamento bulk
  • CREATE, ALTER, DROP (se richiesto dalla definizione dell'attività)

Connessione a Azure Data Lake Storage come area di gestione temporanea cloud

È necessario connettersi all'area di gestione temporanea del cloud di Azure Data Lake Storage durante la creazione del progetto dati. Sono necessarie le seguenti impostazioni:

• Account di archiviazione

  Nome dell'account di archiviazione.

• Nome del contenitore

  Nome del contenitore da utilizzare come area di gestione temporanea del cloud.

• ID tenant di Azure Active Directory

  ID tenant della sottoscrizione in Azure Active Directory.

• ID client di registrazione dell'applicazione Azure

  ID client dell'applicazione in Azure Active Directory.

• ID client di registrazione dell'applicazione Azure

  Segreto dell'applicazione in Azure Active Directory

• Chiave di accesso

  Chiave di accesso all'account di archiviazione.

È possibile anche scegliere di creare automaticamente le credenziali di SQL Server.

Prerequisiti Qlik Data Gateway - Movimento dati

è necessario soddisfare i seguenti prerequisiti sul computer gateway di Data Movement.

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 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 Movimento dati. 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.

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 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 Movimento dati. 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 rivedere l'EULA dall'inizio.

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

1. Scaricare uno dei seguenti driver dalla pagina dei pacchetti di Microsoft, in base alla propria versione di Data Movement gateway:

   • Data Movement gateway 2022.11.70: Scaricare il driver Microsoft ODBC per SQL Server 17.x

     Esempio di nome file: msodbcsql17-17.10.1.1-1.x86_64.rpm

   • Data Movement gateway 2022.11.74 o versione successiva: Scaricare il driver Microsoft ODBC per SQL Server 18.x

     Esempio di nome file: msodbcsql18-18.3.1.1-1.x86_64.rpm

2. Arresta il servizio di Data Movement gateway:

   sudo service repagent stop

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

4. Installare il driver sulla macchina Data Movement gateway.

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<parent-version>/lib64/" >> site_arep_login.sh

   dove <parent-version> è 17 o 18 a seconda della versione del driver installata.

   Esempio che presuppone l'avvenuta installazione del driver ODBC Microsoft per SQL Server 18.x:

   echo "export LD_LIBRARY_PATH=\$LD_LIBRARY_PATH:/opt/microsoft/msodbcsql18/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 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

Porte

• Quando Data Movement gateway viene eseguito su un computer esterno ad Azure - Aprire la porta 1433 per le comunicazioni in uscita.
• Quando Data Movement gateway viene eseguito su una macchina virtuale di Azure - Aprire le porte seguenti per le comunicazioni in uscita:
  • 1433
  • 11000-11999
  • 14000-14999

Tipi di dati

La tabella seguente mostra i tipi di dati Azure Synapse Analytics supportati al momento di utilizzare Qlik Cloud e il mapping predefinito dai tipi di dati Qlik Cloud.