Utiliser l’assistant Cortex Analyst Semantic View Generator

L’assistant Cortex Analyst Semantic View Generator fournit une interface utilisateur graphique (GUI) pour la création et la gestion de vues sémantiques. Cet assistant vous guide tout au long du processus de définition de votre sémantique métier, qu’il rend ainsi accessible aux utilisateurs qui ne sont peut-être pas familiarisés avec SQL.

Pour plus d’informations sur l’utilisation du générateur et la gestion des modèles sémantiques dans YAML, consultez les rubriques suivantes :

Créer une vue sémantique

Pour utiliser l’assistant Cortex Analyst Semantic View Generator afin de créer une nouvelle vue sémantique :

  1. Dans Snowsight, sélectionnez AI & ML.

  2. Trouvez la vignette Cortex Analyst et sélectionnez Try. La fenêtre Select a semantic model s’ouvre.

  3. Sous Role and warehouse :

    1. Sélectionnez le rôle qui doit être propriétaire de la vue sémantique.

    2. Sélectionnez l’entrepôt qui doit être utilisé pour les requêtes de cette vue sémantique.

  4. Sous Select from, sélectionnez Semantic Views.

  5. Dans le menu qui s’affiche à l’adresse No Database selected, sélectionnez la base de données et le schéma dans lesquels vous souhaitez créer la vue sémantique.

  6. Sélectionnez Create new. L’assistant Semantic View Generator s’ouvre.

  7. Dans l’étape Description de l’assistant :

    1. Pour Location to store, sélectionnez la base de données et le schéma dans lesquels le modèle doit être stocké, si vous n’avez pas encore choisi d’emplacement.

    2. Dans Name, entrez un nom pour votre modèle sémantique.

      Vous devez spécifier un nom qui commence par une lettre ou un trait de soulignement et qui ne contient que des lettres, des chiffres, des traits de soulignement ou des signes dollar.

    3. (Facultatif) Dans Description, décrivez les données que votre modèle sémantique met à disposition et les types de questions que les utilisateurs peuvent poser.

    4. Sélectionnez Next: Select tables.

  8. Dans l’étape Select tables de l’assistant :

    1. Dans l’onglet Find tables and views, sélectionnez les tables ou les vues qui contiennent les données que vous souhaitez utiliser dans votre vue sémantique.

      Vous devez sélectionner au moins une table ou une vue.

      Pour de meilleures performances, ne sélectionnez pas plus de dix tables.

      Si vous souhaitez voir la liste des tables et des vues que vous avez sélectionnées, sélectionnez l’onglet Selected.

    2. Sélectionnez Next: Select columns.

  9. Dans l’étape Select columns de l’assistant :

    1. Sélectionnez les colonnes à inclure dans le modèle.

      Pour sélectionner toutes les colonnes d’une table ou d’une vue, sélectionnez cette table ou cette vue.

      Pour de meilleures performances, ne sélectionnez pas plus de 50 colonnes.

    2. Sélectionnez Create and Save.

      La fenêtre Cortex Analyst s’ouvre et affiche les détails du modèle sémantique que vous avez créé.

  10. Sous Logical tables :

    1. Examinez les faits, les dimensions et les métriques définis pour chaque table ou vue.

    2. Fournissez des noms et des descriptions métier conviviaux.

    3. Ajoutez les faits, les dimensions et les métriques supplémentaires requis.

  11. Sous Relationships :

    1. Confirmez les relations définies par le générateur.

    2. Modifiez les propriétés des relations si nécessaire.

    3. Ajoutez les éventuelles relations supplémentaires requises.

  12. Si vous avez apporté des modifications à la vue sémantique, sélectionnez Save dans le coin supérieur droit de la fenêtre Cortex Analyst.

Modifier une vue sémantique

Pour modifier une vue sémantique :

  1. Dans Snowsight, sélectionnez AI & ML.

  2. Trouvez la vignette Cortex Analyst et sélectionnez Try. La fenêtre Select a semantic model s’ouvre.

  3. Sous Role and warehouse :

    1. Sélectionnez le rôle qui possède la vue sémantique.

    2. Sélectionnez l’entrepôt utilisé pour les requêtes de la vue sémantique.

  4. Sous Select from, sélectionnez Semantic Views.

  5. Dans le menu de la base de données, sélectionnez la base de données et le schéma contenant la vue sémantique que vous souhaitez modifier.

  6. Sélectionnez la vue sémantique que vous souhaitez modifier, puis sélectionnez Open.

  7. Apportez des modifications à la vue sémantique. Vous pouvez :

    • Modifier les descriptions et les informations de base.

    • Ajouter ou supprimer des sources de données.

    • Modifier les sélections de colonnes.

    • Mettre à jour les relations.

    • Ajouter, modifier ou supprimer des faits, des dimensions et des métriques.

  8. Si vous prévoyez d’utiliser Cortex Analyst avec cette vue, tenez compte des points suivants :

    • Ajoutez des échantillons de requêtes à la section Verified Queries.

      • Il s’agit d’exemples de requêtes qui aident Cortex Analyst à comprendre comment utiliser la vue sémantique.

      • Ajoutez des requêtes qui représentent des cas d’utilisation courants de vos données.

    • Ajoutez des synonymes pour vos tables, faits, dimensions ou métriques.

      • Il s’agit de termes alternatifs que les utilisateurs peuvent utiliser dans leurs requêtes.

      • Les synonymes aident Cortex Analyst à interpréter correctement les questions des utilisateurs.

    • Ajoutez des instructions personnalisées.

      • Celles-ci fournissent un contexte supplémentaire sur la manière dont les données doivent être interprétées.

      • Indiquez les règles ou contraintes métier à prendre en compte.

  9. Sélectionnez Save dans le coin supérieur droit de la fenêtre Cortex Analyst.

Bonnes pratiques pour l’utilisation de l’assistant Cortex Analyst Semantic View Generator

  • Fournissez des descriptions claires :

    • Utilisez la terminologie métier dans tous les noms et descriptions.

    • Rédigez des descriptions suffisamment détaillées pour être compréhensibles par les utilisateurs non techniques.

  • Incluez des questions utilisateur représentatives :

    • Ajoutez des questions qui peuvent aider le générateur de modèle à mieux comprendre votre intention.

    • Incluez des variantes de la façon dont les questions peuvent être posées.

  • Examinez attentivement les suggestions générées :

    • Assurez-vous que les questions sont pertinentes pour le cas d’utilisation.

    • Assurez-vous que les relations proposées correspondent à votre compréhension du métier.

  • Testez avec des questions réelles :

    • Après avoir créé votre vue sémantique, testez-la avec des questions métier réelles.

    • Affinez votre vue sémantique en fonction de la manière dont le modèle répond à ces questions.

  • Développez la vue sémantique de manière itérative :

    • Commencez par un schéma en étoile simple.

    • Commencez par les tables et les métriques de base, puis élargissez. Nous suggérons de commencer avec trois tables pour simplifier les choses.

    • Obtenez un retour d’information de la part des utilisateurs métier et affinez votre vue sémantique.

Résolution des problèmes

  • Si votre vue sémantique n’apparaît pas dans la liste des vues de l’assistant Cortex Analyst Semantic View Generator, actualisez la liste des modèles (et non la page elle-même).

  • Si des erreurs surviennent au niveau des relations dans la vue sémantique, assurez-vous que ces relations correspondent à la structure réelle des données.

  • Si les requêtes sont lentes, réduisez le nombre de tables ou de colonnes.

  • Si Cortex Analyst produit des résultats inattendus lors de l’utilisation de votre vue sémantique, revoyez les faits, les dimensions et les métriques de la vue sémantique.