Génération d'une transformation SQL via une invite textuelle

Vous pouvez utiliser l'Assistant SQL pour générer une transformation SQL via une invite textuelle dans laquelle vous décrivez la transformation souhaitée. Vous pouvez, par exemple, sélectionner des colonnes, joindre des tables ou filtrer des enregistrements.

La requête est générée via l'IA générative en fonction de votre invite textuelle et des informations du jeu de données et à l'aide de la syntaxe de votre plateforme de données cible.

L'invite textuelle et les informations du jeu de données sont envoyées à un modèle d'IA générative tiers (GenAI) pour qu'il génère le code SQL. Les informations sont traitées comme des données client et ne seront pas utilisées pour former Qlik Cloud ou le modèle GenAI sur AWS Bedrock. Pour plus d'informations, consultez Informations partagées.

Availability

Le modèle GenAI est hébergé sur AWS Bedrock Anthropic dans la même région que celle du client Qlik Cloud. L'Assistant SQL est disponible sur les clients dans les régions Qlik suivantes :

• Est des États-Unis (Virginie du Nord)

• Asie-Pacifique (Sydney)

• Europe (Francfort)

• Europe (Irlande)

L'Assistant SQL doit être activé au niveau du client par un administrateur de clients dans Administration.

• Activez Assistant SQL basé sur l'IA générative dans Paramètres > Contrôle de fonction.

Génération d'une requête SQM à l'aide de l' Assistant SQL

L'Assistant SQL est disponible dans les transformations SQL dans les tâches de données Transformation. Vous devez ajouter au moins un jeu de données à la transformation SQL.

Pour plus d'informations sur les transformations SQL, consultez Ajout de transformations SQL.

1. Cliquez sur Assistant SQL.

   L'Assistant SQL s'ouvre avec une invite textuelle.

2. Saisissez la description de la transformation souhaitée dans Invite.

   Exemple : Établir une liste de tous les clients représentant plus de 5 millions de ventes. Inclure le total des ventes et des opportunités pour chaque client.

   Note ConseilLorsque vous référencez des colonnes dans l'invite, assurez-vous qu'elles existent dans les jeux de données sélectionnés.

3. Cliquez sur Générer.

4. Vérifiez la requête SQL générée affichée dans SQL.

   Vous pouvez évaluer les résultats en cliquant sur ou sur . Cela permettra à Qlik d'améliorer l'expérience de l'Assistant SQL.

   Si la transformation générée ne semble pas correcte ou si vous voulez modifier quelque chose, cliquez sur Modifier l'invite, apportez les modifications souhaitées à l'invite et générez une nouvelle requête.

5. Une fois que vous êtes satisfait de la requête SQL obtenue, cliquez sur Appliquer pour la copier dans la transformation SQL.

6. Cliquez sur Extraire les paramètres.

7. Cliquez sur Décrire la table.

8. Vérifiez le jeu de données obtenu dans Résultats. Vous pouvez également cliquer sur Afficher les données pour afficher un échantillon de données des résultats.

9. Si vous êtes satisfait des résultats, cliquez sur OK pour enregistrer et appliquer la transformation SQL.

Informations partagées

Les informations suivantes sont partagées avec le modèle d'IA générative pour générer une requête.

• Invite textuelle

• Instructions de génération supplémentaires permettant d'adapter la requête à votre plateforme de données cible.
  Exemple : Générer une requête SQL dans une syntaxe compatible avec Snowflake

• Noms et descriptions des jeux de données.

• Noms des colonnes, types de données et tailles.

• Colonnes de clés primaires (identificateurs uniques).

• Relations entre les jeux de données.

  Exemple : "order_detail" est associé à "order" via la clé "order_id".

Limitations d'utilisation

Les limitations d'utilisation suivantes s'appliquent à l'Assistant SQL.

• Un seul appel : 18 k de jetons.

  Si cette limite est dépassée, retirez les jeux de données inutiles ou fournissez une description moins complexe dans l'invite.

• Quotidien (par client) : 1 M de jetons

• Mensuel (par client) : 10 M de jetons

Lors du calcul de l'utilisation, un jeton représente 6 caractères. L'appel auprès du modèle GenAI se compose comme suit :

• Instructions générales pour générer une requête SQL. Cette partie est de taille fixe.

• Invite textuelle.

• Représentation sous forme de schéma des métadonnées des jeux de données. Cette partie peut être très volumineuse, si vous avez sélectionné un grand nombre de jeux de données.

Limitations

• La génération SQL incrémentielle n'est pas supportée. Pour plus d'informations, consultez Ajout de transformations SQL.

• Vous pouvez transformer des données uniquement dans les tables actives. Les tables précédentes, les tables de modifications et les vues en direct ne sont pas supportées. Pour plus d'informations sur les tables et les vues, voir Architecture du jeu de données dans un entrepôt de données cloud.

• Les fonctions indépendantes de la plateforme ne sont pas utilisées, par exemple, $CONCAT).

Bonnes pratiques

• Vérifiez que le modèle de données des jeux de données sources inclut toutes les relations nécessaires lorsque des colonnes associées portent des noms différents. En général, le modèle GenAI associera les colonnes portant le même nom sans relation définie.

  Exemple : lorsque la colonne ShipVia de Orders doit être associée à la colonne shipper_id de Shippers, vous devez créer une relation dans le modèle de données avant de générer une transformation SQL.

• Sélectionnez uniquement les jeux de données sources nécessaires pour la transformation. Les données sources obsolètes peuvent donner des résultats incorrects ou non pertinents et augmenter l'utisation de jetons.

• Vous pouvez ajouter des descriptions dans l'invite pour identifier les colonnes ou les jeux de données portant un nom qui n'est pas significatif.

  Exemple : cus_ct contient le jeu de données Customers.