Création de ressources de données à l'aide de requêtes SQL

Pour ajouter à votre projet une vue dynamique des données provenant d'une connexion, créez une requête SQL pour sélectionner des données spécifiques.

Pour ajouter une vue dynamique :

  1. Sur la page du projet, cliquez sur l'onglet Actifs, puis sur Nouvel actif > Créer une vue dynamique des données.

  2. Laissez la méthode de sélection des données Écrire une requête SQL sélectionnée.

  3. Saisissez un nom et éventuellement une description. Le nombre maximum de caractères autorisés pour le nom ou la description est de 100 chacun. Vous pouvez également ajouter des balises pour faciliter la recherche, si nécessaire.

  4. Sélectionnez un actif de connexion existant comme source de données. La connexion doit supporter les requêtes SQL.

  5. Créez votre requête SQL. Vous pouvez créer vous-même la requête SQL ou saisir une requête en texte brut et la convertir en SQL à l'aide de l'un des modèles disponibles.

    L'option permettant de travailler avec des requêtes en texte brut est une fonctionnalité en aperçu technique. La fonctionnalité d'aperçu technologique est disponible pour le développement et les tests, mais n'est pas destinée à être utilisée en production.

    Pour pouvoir utiliser les requêtes en langage naturel, les fonctionnalités d'IA générique en général et la fonctionnalité Text-to-SQL doivent être activées lors de l'installation ou de la mise à niveau. De plus, le projet doit être activé pour les détails de l' queries.For e en langage naturel. Voir les paramètres des outils d'intelligence des données.

    Pour obtenir des résultats SQL plus précis et adaptés au contexte, vous pouvez fournir des informations contextuelles supplémentaires aux modèles en téléchargeant des exemples de requêtes. Pour plus d'informations, consultez la section Fournir un contexte supplémentaire pour les conversions texte-SQL.

    N'oubliez pas : les requêtes générées ne sont pas garanties d'être identiques d'une exécution à l'autre, vous pouvez donc constater des variations.

    1. Dans la zone de texte libre de l 'onglet SQL, saisissez votre requête texte, sélectionnez l'un des modèles disponibles (Sélectionner l'icône du modèle) et générez l'instruction SQL.

      Conseil : Le meta-llama/llama-3-3-70b model est plus efficace pour suivre les instructions rapides de conversion de texte en SQL et peut donc fournir des résultats plus précis que les modèles Granite.

      Une requête textuelle peut ressembler à ces exemples : « Obtenir toutes les transactions avec le type de paiement » ou « Joindre les conditions et les patients, puis prendre les 100 premières lignes »

      Lorsque vous saisissez votre requête textuelle, vous pouvez fournir des informations supplémentaires qui serviront d'invite personnalisée au modèle. Faites précéder ces informations supplémentaires de la clause de non-responsabilité Note: . Par exemple :

      Show records in customer_spend where the spending score is less than 50 and age is between 30 and 50.
Note: include the relevant columns and do not include all the columns

      Les ressources du projet provenant de la connexion et de la base de données sélectionnées sont utilisées comme ressources de référence pour traduire votre requête texte en requête SQL. Par défaut, le modèle linguistique étendu sélectionne jusqu'à 40 ressources parmi les plus pertinentes parmi ces ressources de référence pour la traduction. Pour sélectionner manuellement les actifs de référence, cliquez sur Actifs de référence. Ne sélectionnez aucun fichier d' CSV s téléchargé localement. Ces fichiers ne sont pas pris en compte pour la génération de requêtes SQL.

    2. Copiez l'instruction SQL générée dans la zone SQL. Vous pouvez toujours mettre à jour la requête SQL selon vos besoins.

    Vous pouvez également saisir directement votre requête SQL pour sélectionner les données pour la vue dynamique.

    Exemple :

    SELECT name, address, client_id FROM BANK1.BANK_CLIENTS WHERE account_type='CHECKING' AND online_access='YES'

    Cette requête crée une vue avec les colonnes qui contiennent les noms, les adresses et les identifiants des clients qui ont un accès en ligne à leur compte courant. La source est la table de la base de données BANK_CLIENTS.

  6. Facultatif : si vous créez cette ressource pour générer un produit de données, vous pouvez sélectionner un ensemble de paramètres dans votre projet pour créer une requête personnalisable. Pour plus d'informations, voir Création de produits de données à partir d'une requête personnalisable.

    Si vous travaillez avec un jeu de paramètres, reliez chaque paramètre à une valeur de données. Tous les noms de paramètres de la requête doivent correspondre aux noms de l'ensemble de paramètres. Pour spécifier un paramètre, utilisez la syntaxe suivante : '#<nom_du_paramètre>#'.

    Exemple :

    SELECT * FROM PUBLIC.COURSES WHERE PUBLIC.COURSES.SEMESTER='#TERM#' AND PUBLIC.COURSES.COURSE_NAME='#COURSE#'

  7. Facultatif : testez votre requête pour valider le SQL. Sinon, votre requête est validée lorsque vous cliquez sur Créer. Vous devez corriger les éventuelles erreurs SQL avant de pouvoir créer le poste.

L'actif est ajouté à la page Actifs du projet. Pour différencier les vues dynamiques des autres ressources de données, ces dernières sont marquées par l'icône des données de référence (données de référence actif). Si les dossiers sont activés dans le projet, une vue dynamique est toujours créée dans le dossier racine, mais vous pouvez la déplacer vers n'importe quel sous-répertoire afin d'organiser vos vues dynamiques.

Etapes suivantes