Snowflake
È possibile utilizzare Snowflake come piattaforma dati di destinazione in una pipeline di dati. In una pipeline di dati, è possibile eseguire diverse operazioni nella piattaforma di destinazione, tra cui trasferire i dati, archiviarli, trasformarli, creare data mart e registrare i dati. Questa sezione spiega come configurare la connettività a una destinazione Snowflake utilizzando il connettore Destinazione Snowflake. Prima di potersi connettere a un Snowflake di destinazione, è necessario configurare Autorizzazioni richieste nel database. Se ci si connette a Snowflake tramite Gateway di Data Movement, è necessario anche installare il driver richiesto come descritto in Configurazione del driver.
Per informazioni sulle limitazioni e per considerazioni sull'utilizzo del connettore Snowflake Target, vedere Limiti e considerazioni.
Impostazione delle proprietà di connessione
Questa sezione descrive le proprietà di connessione disponibili. Tutte le proprietà sono obbligatorie se non diversamente indicato.
gateway di Data Movement
Gateway dati: È richiesto un Gateway di Data Movement solo se non è possibile accedere al database di destinazione da Qlik Cloud ed è possibile accedervi solo utilizzando un Private Link (ad esempio, se è posizionato o in un Virtual Private Cloud). In questo caso, selezionare il Gateway di Data Movement che si desidera utilizzare per accedere al database di destinazione.
A seconda del caso di utilizzo, questo sarà lo stesso Gateway di Data Movement distribuito per trasferire i dati da una sorgente dati, oppure uno differente. Per informazioni sulle differenti possibilità di distribuzione del Gateway di Data Movement vedere Casi di utilizzo comuni.
Se il database di destinazione è accessibile direttamente da Qlik Cloud, selezionare Nessuno.
Proprietà di connessione
-
Server: l'URL per accedere a Snowflake. Ad esempio, myaccount.snowflakecomputing.com.
-
Porta: l porta che si desidera utilizzare per accedere al database Snowflake. La porta predefinita è la 443.
Proprietà dell'account
Nome utente e Password: il nome utente e la password di un utente autorizzato ad accedere al database Snowflake.
Proprietà del database
- Data warehouse predefinito: il nome del warehouse Snowflake. È possibile sostituirlo nelle impostazioni del progetto.
-
Nome database: per specificare un database, è possibile utilizzare i due metodi descritti di seguito.
- Metodo 1 - Selezione da un elenco: Fare clic su Carica database, quindi selezionare un database.
- Metodo 2 - Manualmente: selezionare Inserisci nome database manualmente, quindi inserire il nome del database.
Proprietà interne
Le proprietà interne servono per casi d'uso speciali e pertanto non vengono visualizzate nella finestra di dialogo. Gli utenti devono utilizzarle solo se indicato dal Supporto di Qlik.
Usare i pulsanti e a destra del campo per aggiungere o rimuovere proprietà in base alle esigenze.
Nome
Il nome visualizzato per la connessione.
Prerequisiti
Autorizzazioni richieste
Sono necessarie le seguenti autorizzazioni:
Autorizzazioni richieste se si vuole che gli schemi che non esistono vengano creati automaticamente
- UTILIZZO SU DATABASE
- CREA SCHEMA SU DATABASE
Autorizzazioni richieste se lo schema esiste già
- UTILIZZO SU DATABASE
- UTILIZZO SU SCHEMA
- CREA FORMATO FILE SU SCHEMA
- CREA FASE SU SCHEMA
- CREA TABELLA SU SCHEMA
Configurazione del driver
Un driver è necessario solo se si accede al database tramite Gateway di Data Movement.
È 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. Per questo processo è necessario scaricare il driver, copiarlo nella cartella richiesta (vedere sotto) ed eseguire uno script che lo installerà e configurerà automaticamente. È 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 Spostamento dati.
Python è preinstallato nella maggior parte delle distribuzioni Linux. È possibile verificare quale versione di Python è installata sul sistema, eseguendo il seguente comando:
python3 --version
-
Scaricare il drivere ODBC Snowflake "snowflake-odbc-<version>.x86_64.rpm". È possibile trovare un collegamento di download diretto alla versione supportata in binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/snowflake.yaml. Una volta completato il download, copiare il file in:
/opt/qlik/gateway/movement/drivers/snowflake
Installazione di driver
installare driver:
-
Arrestare il servizio gateway di Data Movement:
sudo systemctl stop repagent
-
Facoltativamente, confermare che il servizio è stato interrotto:
sudo systemctl status repagent
Lo stato dovrebbe essere il seguente:
Active: inactive (dead) since <timestamp> ago
-
Sul computer gateway Spostamento dati, cambiare la directory di lavoro in:
opt/qlik/gateway/movement/drivers/bin
-
Eseguire il comando seguente:
Sintassi:
./install snowflake
Altrimenti, verrà visualizzato l'EULA del driver.
-
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.
-
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.
-
Attendere il completamento dell'installazione (indicato dal messaggio "Operazione completata"), quindi avviare il servizio gateway di Data Movement:
sudo systemctl start repagent
-
Facoltativamente, conferma che il servizio si è avviato:
sudo systemctl status repagent
Lo stato dovrebbe essere il seguente:
Active: active (running) since <timestamp> ago
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 e aggiornare driver:
-
Arrestare il servizio gateway di Data Movement:
sudo systemctl stop repagent
-
Facoltativamente, confermare che il servizio è stato interrotto:
sudo systemctl status repagent
Lo stato dovrebbe essere il seguente:
Active: inactive (dead) since <timestamp> ago
-
Sul computer gateway Spostamento dati, cambiare la directory di lavoro in:
opt/qlik/gateway/movement/drivers/bin
-
Eseguire il comando seguente:
Sintassi:
./update snowflake
Altrimenti, verrà visualizzato l'EULA del driver.
-
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.
-
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.
-
Attendere il completamento dell'installazione (indicato dal messaggio "Operazione completata"), quindi avviare il servizio gateway di Data Movement:
sudo systemctl start repagent
-
Facoltativamente, conferma che il servizio si è avviato:
sudo systemctl status repagent
Lo stato dovrebbe essere il seguente:
Active: active (running) since <timestamp> ago
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:
-
interrompere tutte le attività configurate per utilizzare il connettore.
-
Sul computer gateway Spostamento dati, cambiare la directory di lavoro in:
opt/qlik/gateway/movement/drivers/bin
-
Eseguire il comando seguente:
Sintassi:
./uninstall snowflake
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.
È necessario installare un ODBC e un driver JDBC.
Installazione del driver ODBC
- Una volta installato Gateway di Data Movement, scaricare il file del driver snowflake-odbc-<version>x86_64.rpm elencato in binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/snowflake.yaml, quindi copiarlo nel computer di Gateway di Data Movement.
- Installare il driver sul computer Gateway di Data Movement.
Installazione del driver JDBC
-
Scaricare il file snowflake-jdbc-<version>.jar elencato in binary-artifacts in /opt/qlik/gateway/movement/drivers/manifests/snowflake.yaml, quindi copiarlo nel computer di Gateway di Data Movement.
/opt/qlik/gateway/movement/qcs_agents/qdi-db-commands/lib
-
Riavviare il servizio Gateway di Data Movement e verificare che sia stato avviato eseguendo i comandi descritti nella sezione Comandi di servizio del Gateway di Data Movement
Porta
La porta 443 del firewall deve essere aperta per la comunicazione in uscita.
Ottimizzazione delle prestazioni e dell'utilizzo dei servizi cloud
Per informazioni sugli addebiti sostenuti durante l'utilizzo di Snowflake Cloud Services, vedere Snowflake: Impatto aggiuntivo sulla fatturazione (livello dei servizi cloud)
Limiti e considerazioni
Quando si spostano i dati su una destinazione Snowflake, si applicano le seguenti limitazioni:
- La replica delle tabelle che contengono barre rovesciate nel nome (ad es. SPECIAL\\TABLE\N) non è supportata.
Tipi di dati
La tabella seguente mostra i tipi di dati Snowflake supportati al momento di utilizzare Qlik Cloud e il mapping predefinito dai tipi di dati Qlik Cloud.
La informazioni relative tipo di dati nativo vengono mantenute e vengono visualizzate nella colonna Tipo di dati nativo nelle visualizzazioni del set di dati. Se la colonna non è visibile, è necessario aprire lo strumento di selezione delle colonne della visualizzazione del set di dati e selezionare la colonna Tipo di dati nativo.
Tipi di dati Qlik Cloud | Tipi di dati Snowflake |
---|---|
BOOLEAN |
BOOLEAN |
BYTES |
BINARY (lunghezza in Byte) |
DATE |
DATE |
TIME |
TIME (precisione) |
DATETIME |
TIMESTAMP_NTZ (precisione) |
INT1 |
BYTEINT |
INT2 |
SMALLINT |
INT4 |
INTEGER |
INT8 |
BIGINT |
NUMERIC |
NUMBER (precisione, scala) |
REAL4 |
FLOAT4 |
REAL8 |
FLOAT8 |
UINT1 |
BYTEINT |
UINT2 |
INTEGER |
UINT4 |
INTEGER |
UINT8 |
BIGINT |
STRING |
VARCHAR (lunghezza in Byte) |
WSTRING |
NVARCHAR (lunghezza in Byte) |
BLOB |
BINARY (8388608) |
NCLOB |
NVARCHAR (8388608) |
CLOB |
VARCHAR (8388608) |