Vai al contenuto principale Passa a contenuto complementare
Risorse Qlik
Annunci
Caricamento ricerca di SearchUnify Per assistenza con il prodotto, contattare il Supporto Qlik.
Portale cliente Qlik
Caricamento ricerca di SearchUnify Per assistenza con il prodotto, contattare il Supporto Qlik.
Portale cliente Qlik

Aggiunta di trasformazioni SQL

È possibile includere tabelle basate su SQL nelle attività di trasformazione. Una trasformazione SQL consente di inserire query SQL SELECT in una pipeline per definire trasformazioni semplici o complesse. È possibile anche fare in modo che l'Assistente SQL generi una query utilizzando l'IA generativa. È possibile anche usare macro per adattare la query da eseguire se viene effettuato un caricamento iniziale o un caricamento incrementale.

Per maggiori informazioni sulla creazione di un'attività di trasformazione, vedere Trasformazione di dati.

Aggiunta di una trasformazione SQL

Per aggiungere una trasformazione SQL in un'attività dati Trasforma:

  1. In Trasforma, selezionare i set di dati da includere nella query e fare clic su Aggiungi trasformazione SQL.

    Impostare il nome della trasformazione in Name. Per ulteriori informazioni sulle altre impostazioni, vedere Impostazioni.

    Quando si è pronti per creare la trasformazione SQL, fare clic su Aggiungi.

    Viene visualizzata l'opzione Modifica trasformazione SQL.

  2. Scrivere la query per restituire la tabella basata su SQL nel riquadro della query.

    Per ulteriori informazioni, vedere Modifica della query SQL.

  3. Fare clic su Run query.

    Verranno recuperati i metadati e un'anteprima dei dati.

  4. Rivedere i parametri in Parameters.

    Per ulteriori informazioni, vedere Parametri.

  5. Impostare una chiave primaria in Metadata.

    Per ulteriori informazioni, vedere Metadati.

  6. Quando si è soddisfatti dei risultati della query, fare clic su Salva e chiudi. Il set di dati ora è aggiunto all'elenco delle destinazioni ed è possibile visualizzarne l'anteprima.

Modifica della query SQL

Digitare la query per restituire la tabella basata su SQL nel riquadro della query. La query può solo leggere dai set di dati di origine selezionati, ma è possibile aggiungere più set di dati di origine utilizzando l'opzione Aggiungi.

  • È possibile creare un'istruzione per caricare un set di dati da Oggetti. Fare clic su altro e quindi su Genera istruzione selezionata nell'editor.

  • È possibile copiare il nome di un set di dati negli Appunti facendo clic su altro e quindi su Copia.

  • Fare clic su > per spostare un set di dati o un nome di colonna nell'editor.

  • Fare clic su Cerca per cercare e sostituire il testo nell'editor.

Nota informaticaÈ possibile utilizzare l'Assistente SQL per generare una query utilizzando l'IA generativa. Per ulteriori informazioni, vedere Generazione di una trasformazione SQL da un prompt di testo. L'Assistente SQL non è disponibile in Qlik Cloud Government.

Se si utilizza il caricamento incrementale, è possibile usare Macro per adattare la query da eseguire se viene effettuato un caricamento iniziale o un caricamento incrementale.

Per ulteriori informazioni, vedere Utilizzo di macro per adattare la query al tipo di caricamento.

Combinazioni di tasti di scelta rapida

Nota informaticaLe combinazioni di tasti di scelta rapida sono state riportate presupponendo che si stia utilizzando Windows. Per macOS è necessario utilizzare Command anziché CTRL.

  • Ctrl+F Trova e sostituisci

  • Ctrl+/ Commenta/rimuovi commento dalla riga corrente

  • Ctrl+Invio Esegui la query

  • Ctrl+Z Annulla

  • Ctrl+Y Ripeti

Anteprima dei risultati

È possibile visualizzare un'anteprima dei risultati utilizzando un campione dei dati in Risultati.

Nota informaticaÈ necessario abilitare l'anteprima dei dati a livello tenant in Amministrazione. È possibile trovare l'opzione Visualizzazione dei dati data in Integrazione dati nelle Impostazioni, nella sezione Controllo funzione.

Per poter visualizzare un'anteprima dei dati, è necessario disporre dei seguenti ruoli:

  • Può visualizzare i dati nello spazio in cui risiede la connessione.

  • Può visualizzare nello spazio in cui risiede il progetto dati.

Vengono visualizzati i risultati che utilizzano un campione dei dati. È possibile impostare il numero di righe che si desidera includere nel campione nell'opzione Numero di righe.

  • Fare clic su Ultima query eseguita per visualizzare l'ora di esecuzione e la durata dell'ultima query eseguita.

Filtro dei risultati

È possibile filtrare i risultati in base a una o più colonne.

  • Fai clic su altro sulla prima colonna per filtrare e quindi su Filtra.

    Seleziona quale operatore utilizzare e quale valore usare per il filtro.

    È possibile aggiungere altri filtri colonna facendo clic su Aggiungi filtro.

Il filtro interesserà solo i dati campione esistenti.

Ordinamento dei risultati

È possibile ordinare il campione di dati in base a una colonna specifica.

  • Fare clic su altro sulla colonna in base a cui ordinare e quindi su Ordina in ordine crescente o Ordina in ordine decrescente.

Questa operazione interesserà solo i dati campione esistenti. Se si è utilizzato un filtro per includere solo gli ordini realizzati nel 2024 e si inverte l'ordinamento, i dati campione conterranno comunque solo gli ordini del 2024.

Gestione delle colonne visualizzate

È possibile selezionare le colonne da visualizzare nei risultati. La selezione non viene salvata quando si salva la trasformazione.

  • Nascondere una colonna facendo clic su altro sulla colonna e quindi su Nascondi colonna.

  • Gestire la visualizzazione di tutte le colonne facendo clic su altro su una qualsiasi colonna e quindi su Colonne visualizzate.

Parametri

Fare clic su Parametri per modificare i parametri nella query SELECT. I parametri dovrebbero essere mappati agli oggetti di origine e destinazione.

I parametri vengono mappati automaticamente quando si:

  • Usa Genera istruzione selezionata nell'editor in Oggetti.

  • Fai clic su > per spostare un set di dati o un nome di colonna nell'editor.

  • Un nome di parametro corrisponde a un nome di tabella dalle tabelle in Oggetti.

Nota informaticaSe usi nomi di parametro arbitrari, devi mappare i parametri manualmente. Solo i nomi dei parametri che corrispondono ai nomi dei set di dati verranno mappati automaticamente.

È possibile mappare a

  • Strutture di tipo 2 della cronologia (_history)

  • Strutture attuali

  • Oggetti di destinazione

    Quando un parametro è definito all'interno di una macro incrementale, è possibile mappare unicamente gli oggetti di destinazione.

Nota di suggerimentoÈ possibile sostituire un parametro con un riferimento per avere una query più facile da leggere. Modificare il valore in Parametroe anche il riferimento in SELECT query cambierà.

Metadati

È possibile modificare le impostazioni dei metadati in Metadata.

  • Impostare le chiavi primarie nella colonna Chiave.

  • Impostare se la colonna è Nullable, ossia se ammette valori null.

  • Selezionare una colonna e fare clic su Modifica per impostare il nome, la chiave, il tipo di dati e se ammette valori null.

Esecuzione della query

È possibile eseguire la query in qualsiasi momento durante lo sviluppo facendo clic su Run query. La prima volta che si esegue una query, i metadati verranno recuperati. Quando la query viene eseguita, è possibile andare a Metadata e impostare una chiave primaria, necessaria affinché la trasformazione sia completa.

Nota informaticaSe l'editor contiene più di una query, è possibile eseguire una singola query selezionando la query e facendo clic su Esegui query.

Utilizzo di macro per adattare la query al tipo di caricamento

Se si utilizza il caricamento incrementale, è possibile usare Macro per adattare la query da eseguire se viene effettuato un caricamento iniziale o un caricamento incrementale.

Selezionare la macro e aggiungere la query nella rispettiva clausola.

  • Q_RUN_INCREMENTAL aggiunge una clausola in cui è possibile posizionare una query che verrà eseguita solo quando viene effettuato un caricamento incrementale.

  • Q_RUN_INITIAL_LOAD aggiunge una clausola in cui è possibile posizionare una query che verrà eseguita solo quando viene effettuato un caricamento iniziale.

Non è necessario specificare la query completa con ogni macro. È possibile regolare o aggiungere un codice in base al proprio caso di utilizzo.

Caso di utilizzo: filtro incrementale che usa un intervallo di date.

In questo caso di utilizzo, un set di dati di ordini deve essere trasformato tramite SQL personalizzato. Dato che si tratta di un set di dati di grandi dimensioni, è consigliabile includere il filtro incrementale per fare in modo che il caricamento incrementale consideri solo gli ordini delle ultime 12 ore.

Questa è la query di base:

SELECT O.ORDER_ID, O.CUSTOMER_ID, OD.PRODUCT_ID, OD.QUANTITY, O.AMOUNT , OD.LAST_UPDATE_DTM FROM “mydb”.”myStorageTask”.”ORDER” O JOIN “mydb”.”myStorageTask”.”ORDER_DETAIL” OD ON O.ORDER_ID = OD.ORDER_ID

Questo è il filtro da applicare durante l'esecuzione incrementale, dove si considerano solo gli ordini aggiunti nelle ultime 12 ore:

WHERE OD.UPDATE_DTM > DATEADD(hour, -12, CURRENT_TIMESTAMP())
Nota di suggerimentoQuando si implementa una tabella basata su SQL, è consigliabile sostituire i nomi della tabella con la notazione ${TABLE}. Ciò impedisce la codifica fissa di nomi di database o schemi che potrebbero cambiare da un ambiente all'altro, ad esempio, durante lo spostamento da sviluppo a produzione.

Questa è la query completa, con la macro del filtro e i nomi della tabella sostituiti con la notazione ${TABLE}:

SELECT O.ORDER_ID, O.CUSTOMER_ID, OD.PRODUCT_ID, OD.QUANTITY, O.AMOUNT , OD.LAST_UPDATE_DTM FROM ${ORDER} O JOIN ${ORDER_DETAIL} OD ON O.ORDER_ID = OD.ORDER_ID {{#QLIK_FUNC_IF Q_RUN_INCREMENTAL}} WHERE OD.UPDATE_DTM > DATEADD(hour, -12, CURRENT_TIMESTAMP() ) {{/QLIK_FUNC_IF}}

Ciò ha come risultato una query di caricamento iniziale:

SELECT O.ORDER_ID, O.CUSTOMER_ID, OD.PRODUCT_ID, OD.QUANTITY, O.AMOUNT , OD.LAST_UPDATE_DTM FROM ${ORDER} O JOIN ${ORDER_DETAIL} OD ON O.ORDER_ID = OD.ORDER_ID

E una query di caricamento incrementale:

SELECT O.ORDER_ID, O.CUSTOMER_ID, OD.PRODUCT_ID, OD.QUANTITY, O.AMOUNT , OD.LAST_UPDATE_DTM FROM ${ORDER} O JOIN ${ORDER_DETAIL} OD ON O.ORDER_ID = OD.ORDER_ID WHERE OD.UPDATE_DTM > DATEADD(hour, -12, CURRENT_TIMESTAMP() )

Caso di utilizzo: filtro incrementale che usa i dati nella destinazione.

In questo caso di utilizzo, un set di dati di ordini deve essere trasformato tramite SQL personalizzato. Dato che gli ordini sono un set di dati di grandi dimensioni, è consigliabile includere il filtro incrementale per fare in modo che il caricamento incrementale consideri solo record di dettagli degli ordini più recenti dei dati nella tabella di destinazione. È inoltre consigliabile contrassegnare se una riga è stata elaborata dal caricamento iniziale o da un caricamento incrementale.

Nota informaticaCome si può vedere in questo esempio, le macro possono essere utilizzate per regolare qualsiasi parte della query per il caricamento iniziale o il caricamento incrementale.

Questa è la query di base:

SELECT O.ORDER_ID, O.CUSTOMER_ID, OD.PRODUCT_ID, OD.QUANTITY, O.AMOUNT , OD.LAST_UPDATE_DTM FROM “mydb”.”myStorageTask”.”ORDER” O JOIN “mydb”.”myStorageTask”.”ORDER_DETAIL” OD ON O.ORDER_ID = OD.ORDER_ID

Questo è il filtro da applicare durante l'esecuzione incrementale. “ORDERS_DERIVED” è il nome del set di dati di destinazione.

WHERE OD.UPDATE_DTM > = (SELECT MAX(LAST_UPDATE_DTM) FROM “mydb”.”myTrasformTask”.”ORDERS_DERIVED” )
Nota di suggerimentoIl caricamento incrementale può anche mappare una notazione ${TABLE} agli oggetti di destinazione creati dall'attività di trasformazione.

Questa è la query completa, con la macro del filtro e i nomi della tabella sostituiti con la notazione ${TABLE}. LOADED_BY è impostato su INIT se il caricamento è iniziale e INCR se il caricamento è incrementale:

SELECT O.ORDER_ID, O.CUSTOMER_ID, OD.PRODUCT_ID, OD.QUANTITY, O.AMOUNT, OD.LAST_UPDATE_DTM, {{#QLIK_FUNC_IF Q_RUN_INITIAL_LOAD}} ‘INIT’ as LOADED_BY {{/QLIK_FUNC_IF}} {{#QLIK_FUNC_IF Q_RUN_INCREMENTAL}} ‘INCR’ as LOADED_BY {{/QLIK_FUNC_IF}} FROM ${ORDER} O JOIN ${ORDER_DETAIL} OD ON O.ORDER_ID = OD.ORDER_ID {{#QLIK_FUNC_IF Q_RUN_INCREMENTAL}} WHERE OD.UPDATE_DTM >= (SELECT MAX(LAST_UPDATE_DTM) FROM ${TARGET_TABLE} ) {{/QLIK_FUNC_IF}}

Ciò ha come risultato una query di caricamento iniziale:

SELECT O.ORDER_ID, O.CUSTOMER_ID, OD.PRODUCT_ID, OD.QUANTITY, O.AMOUNT, OD.LAST_UPDATE_DTM, ‘INIT’ as LOADED_BY FROM ${ORDER} O JOIN ${ORDER_DETAIL} OD ON O.ORDER_ID = OD.ORDER_ID

E una query di caricamento incrementale:

SELECT O.ORDER_ID, O.CUSTOMER_ID, OD.PRODUCT_ID, OD.QUANTITY, O.AMOUNT, OD.LAST_UPDATE_DTM, ‘INCR’ as LOADED_BY FROM ${ORDER} O JOIN ${ORDER_DETAIL} OD ON O.ORDER_ID = OD.ORDER_ID WHERE OD.UPDATE_DTM >= (SELECT MAX(LAST_UPDATE_DTM) FROM ${TARGET_TABLE} )

Impostazioni

Fai clic su Impostazioni per modificare le impostazioni della trasformazione SQL.

  • Immettere un nome per il set di dati di destinazione in Nome.

    È anche possibile aggiungere una descrizione più lunga in Descrizione.

  • In Materializzazione, selezionare se l'output trasformato dovrebbe essere materializzato o meno. È possibile scegliere di ereditare l'impostazione dalle impostazioni delle attività dati.

    • L'opzione Attivo creerà le tabelle e gestirà l'elaborazione ELT associato.

    • L'opzione Disattivato creerà visualizzazioni che eseguono trasformazioni al volo.

  • In Archivio dati cronologico (Tipo 2), selezionare se si desidera conservare i dati cronologici. È possibile scegliere di ereditare l'impostazione dalle impostazioni delle attività dati. Questa impostazione richiede che la Materializzazione sia attiva.

  • Caricamento incrementale consente di regolare la query per un caricamento di dati incrementali applicando filtri o altre condizioni per ridurre il set di dati elaborato tramite macro. Caricamento incrementale è disponibile solo se i dati sono materializzati come tabelle.

    • Quando Caricamento incrementale è Attivato

      La prima esecuzione dell'attività eseguirà un caricamento iniziale, inserendo tutti i risultati della query nella propria tabella di destinazione. Le esecuzioni successive eseguiranno caricamenti incrementali sfruttando filtri o condizioni specifiche che l'utente ha definito per l'elaborazione incrementale. Durante il caricamento incrementale, l'attività elaborerà dati solo sotto forma di aggiornamento o inserimento, le eliminazioni non sono gestite.

    • Quando Caricamento incrementale è Disattivato

      La prima esecuzione dell'attività eseguirà un caricamento iniziale, inserendo tutti i risultati della query nella propria tabella di destinazione. Le esecuzioni successive elaboreranno tutti i risultati della query tramite la comparazione con la tabella di destinazione e l'elaborazione di record nuovi, modificati o eliminati.

    Nota informaticaSe la query selezionerà tutti i record che devono essere presenti nella destinazione, impostare il Caricamento incrementale su Disattivato. I record che non sono selezionati saranno eliminati nella destinazione.

    • Procedure consigliate

    • Quando si aggiunge una trasformazione SQL, non viene definita automaticamente una chiave primaria. Aggiungere una chiave al serie di dati nella scheda Serie di dati.

    • Evitare di creare manualmente intestazioni delle colonne nell'output trasformato.

    • Evitare di utilizzare SELECT con *, poiché può restituire colonne differenti ogni volta che viene eseguita la query. Se viene apportata una modifica nello schema, cambiare la query di conseguenza ed eseguire nuovamente Descrivi tabella. Quindi, è possibile modificare le colonne e regolare le tabelle.

    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 – ti pregiamo di farcelo sapere!

    Lascia qui il tuo feedback