Generazione di una trasformazione SQL da un prompt di testo

È possibile utilizzare l'Assistente SQL per generare una trasformazione SQL da un prompt di testo in cui si descrive la trasformazione che si desidera ottenere. È possibile ad esempio selezionare colonne, tabelle di unione o filtrare record.

La query viene generata utilizzando l'IA generativa basata sul prompt di testo e sulle informazioni del set di dati, oltre a utilizzare la sintassi della piattaforma dati di destinazione.

Il prompt di testo e le informazioni relative al set di dati verranno inviati a un modello di IA generativa di terze parti (GenAI) per generare il codice SQL. Le informazioni vengono trattate come dati del cliente e non verranno utilizzate per addestrare Qlik Cloud o il modello GenAI su AWS Bedrock. Per ulteriori informazioni, vedere Informazioni condivise.

Disponibilità

Il modello GenAI è ospitato su AWS Bedrock Anthropic nella stessa regione del tenant Qlik Cloud. L'Assistente SQL è disponibile sui tenant nelle seguenti regioni Qlik:

• Stati Uniti orientali (Virginia del Nord)

• Asia-Pacifico (Sydney)

• Europa (Francoforte)

• Europa (Irlanda)

L'Assistente SQL deve essere attivato a livello tenant da un amministratore di tenant nella Amministrazione.

• Attivare l'Assistente SQL basato sull'IA generativa attivato in Impostazioni > Controllo funzionalità.

Generazione di una query SQL con l'Assistente SQL

L'Assistente SQL è disponibile nelle trasformazioni SQL nelle attività dati Trasforma. È necessario aggiungere almeno un set di dati alla trasformazione SQL.

Per maggiori informazioni sulle trasformazioni SQL, vedere Aggiunta di trasformazioni SQL.

1. Fare clic su Assistente SQL.

   L'Assistente SQL si apre con un prompt di testo.

2. Inserire la descrizione della trasformazione che si desidera ottenere in Prompt.

   Esempio: creazione di un elenco di tutti i clienti con vendite per un importo superiore ai 5 milioni. Includere le vendite totali e le opportunità complete per ogni cliente.

   Nota di suggerimentoQuando si fa riferimento alle colonne nel prompt, assicurarsi che queste siano presenti nei set di dati selezionati.

3. Fare clic su Genera.

4. Verificare la query SQL generata che viene visualizzata in SQL.

   È possibile valutare i risultati facendo clic su o su . Ciò aiuta Qlik a migliorare l'esperienza dell'Assistente SQL.

   Se la trasformazione generata non sembra accurata, oppure se si desidera cambiare qualcosa, fare clic su Modifica prompt, apportare le modifiche al prompt e generare una nuova query.

5. Quando si è soddisfatti con la query SQL risultante, fare clic su Applica per copiarla nella trasformazione SQL.

6. Fare clic su Estrai parametri.

7. Fare clic su Descrivi tabella.

8. Verificare il set di dati risultante in Risultati. È possibile anche fare clic su Visualizza dati per visualizzare un campione dati dei risultati.

9. Se si è soddisfatti dei risultati, fare clic su OK per salvare e applicare la trasformazione SQL.

Informazioni condivise

Le seguenti informazioni sono condivise con il modello di IA generativa per generare una query.

• Prompt di testo

• Ulteriori istruzioni relative alla generazione per adattare la query alla piattaforma dati di destinazione.
  Esempio: generare una query SQL con una sintassi compatibile con Snowflake

• Nomi e descrizioni dei set di dati.

• Nomi di colonne, tipi di dati e dimensioni.

• Colonne della chiave primaria (identificatori univoci).

• Relazioni tra set di dati

  Esempio: "order_detail" è allegato a "order" utilizzando la chiave "order_id".

Limitazioni di utilizzo

Le seguenti limitazioni di utilizzo si applicano per l'Assistente SQL.

• Chiamata singola: 18.000 token.

  Se il limite viene superato, rimuovere i set di dati che non sono necessari o fornire una descrizione meno complessa nel prompt.

• Giornalmente (per tenant): 1.000.000 token

• Mensilmente (per tenant): 10.000.000 token

Quando si calcola l'utilizzo, un token rappresenta 6 caratteri. La chiamata al modello GenAI è costituito dai seguenti elementi:

• Istruzioni generali per generare una query SQL. Le dimensioni per questa parte sono fisse.

• Il prompt di testo.

• Una rappresentazione dello schema dei metadati nei set di dati. Le dimensioni di questa parte possono essere grandi se si seleziona un numero elevato di set di dati.

Limiti

• La generazione SQL incrementale non è supportata. Per ulteriori informazioni, vedere Aggiunta di trasformazioni SQL.

• È possibile solo trasformare i dati nelle tabelle correnti. Le tabelle anteriori, le tabelle di modifica e le visualizzazioni live non sono supportate. Per ulteriori informazioni su tabelle e visualizzazioni, vedere Architettura del set di dati in un cloud data warehouse.

• Le funzioni indipendenti dalla piattaforma non sono utilizzati, come per esempio $CONCAT).

Procedure consigliate

• Verificare che il modello dati nei set di dati di origine includa tutte le relazioni richieste quando le colonne correlate hanno nomi differenti. In generale, il modello GenAI correlerà le colonne con lo stesso nome senza una relazione definita.

  Esempio: quando la colonna ShipVia in Orders deve correlarsi alla colonna shipper_id in Shippers, è necessario creare una relazione nel modello dati prima di generare una trasformazione SQL.

• Selezionare solo i set di dati di origine richiesti per la trasformazione. I dati di origine obsoleti possono causare risultati incorretti o irrilevanti, oltre ad aumentare l'utilizzo di token.

• È possibile aggiungere descrizioni nel prompt per identificare colonne o set di dati con un nome che non è ovvio.

  Esempio: cus_ct contiene il set di dati Customers.