Utiliser Snowsight pour créer et gérer des vues sémantiques¶
Dans Snowsight, vous pouvez créer et gérer des vues sémantiques :
Créer une vue sémantique¶
Dans Snowsight, vous pouvez créer une vue sémantique en utilisant un assistant ou en chargeant une spécification de modèle sémantique.
Utilisation de l’assistant pour créer une vue sémantique¶
Note
Pour créer une vue sémantique, vous devez utiliser un rôle avec les privilèges décrits dans Privilèges requis pour créer une vue sémantique.
Accédez à l’assistant de création de vues sémantiques de l’une des façons suivantes :
Navigateur d’objets de base de données
Dans Snowsight, sélectionnez Data » Databases.
Sélectionnez la base de données et le schéma dans lesquels vous souhaitez créer la vue sémantique.
Sélectionnez Create » Semantic View » Create with guided setup.
Cortex Analyst :
Dans Snowsight, sélectionnez AI & ML » Cortex Analyst.
Sélectionnez Create new » Create new Semantic View.
À l’étape Getting started de l’assistant :
Dans Location to store, sélectionnez la base de données et le schéma où le modèle doit être stocké.
Dans Name, saisissez un nom pour votre vue 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.
(Facultatif) Dans Description, décrivez les données que votre vue sémantique met à disposition.
Sélectionnez Next.
Dans l’étape Select tables de l’assistant :
Dans l’onglet All, sélectionnez les tables ou les vues qui contiennent les données que vous souhaitez utiliser dans votre vue sémantique. Veuillez noter ce qui suit :
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.
Sélectionnez Next.
Dans l’étape Select columns de l’assistant :
Sélectionnez les colonnes à inclure dans la vue.
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.
Sélectionnez Create and Save.
Sous Logical tables :
Examinez les faits, les dimensions et les métriques définis pour chaque table ou vue.
Fournissez des noms et des descriptions métier conviviaux.
Ajoutez les faits, les dimensions et les métriques supplémentaires requis.
Sous Relationships :
Confirmez les relations définies par le générateur.
Modifiez les propriétés des relations si nécessaire.
Ajoutez les éventuelles relations supplémentaires requises.
Si vous avez apporté des modifications à la vue sémantique, sélectionnez Save.
Chargement d’une spécification YAML pour créer une vue sémantique¶
Si vous prévoyez de créer la vue sémantique à partir de Cortex Analyst, créez une zone de préparation pour le fichier YAML.
Chargez le fichier YAML de l’une des manières suivantes :
Navigateur d’objets de base de données
Dans Snowsight, sélectionnez Data » Databases.
Sélectionnez la base de données et le schéma dans lesquels vous souhaitez créer la vue sémantique.
Sélectionnez Create » Semantic View » Upload YAML file.
Sélectionnez le fichierYAML à charger.
Sous Select database, schema and stage, sélectionnez la base de données, le schéma et la zone de préparation dans lesquels vous souhaitez charger le fichier YAML.
Si vous voulez que le fichier YAML soit chargé vers un chemin spécifique de la zone de préparation, spécifiez ce chemin.
Sélectionnez Upload.
Cortex Analyst :
Dans Snowsight, sélectionnez AI & ML » Cortex Analyst.
Sélectionnez Create new » Upload YAML file.
Sélectionnez le fichierYAML à charger.
Sélectionnez Convert and save.
Modifier une vue sémantique¶
Pour modifier une vue sémantique :
Accédez à la vue sémantique de l’une des manières suivantes :
Navigateur d’objets de base de données
Dans Snowsight, sélectionnez Data » Databases.
Sélectionnez la base de données et le schéma contenant la vue sémantique.
Sélectionnez Semantic views.
Sélectionnez la vue sémantique.
Sélectionnez l’onglet Semantic information.
Cortex Analyst :
Dans Snowsight, sélectionnez AI & ML » Cortex Analyst.
Sélectionnez l’onglet Semantic views.
Sous Select database to see semantic views, sélectionnez la base de données et le schéma contenant la vue sémantique que vous souhaitez modifier.
Sélectionnez la vue sémantique que vous souhaitez modifier.
Apportez des modifications à la vue sémantique. Vous pouvez apporter les types de modifications suivants :
Pour modifier le nom ou la description de la vue sémantique :
Sélectionnez Edit à côté du nom de la vue sémantique.
Apportez des modifications au nom ou à la description.
Sélectionnez Apply.
Pour ajouter une nouvelle table logique à la vue sémantique :
Sélectionnez + Logical Table dans l’explorateur d’objets de la base de données ou + dans Cortex Analyst.
À l’étape Select a table de l’assistant :
Sélectionnez la table ou la vue qui contient les données que vous souhaitez utiliser dans votre vue sémantique.
Sélectionnez Next.
Dans l’étape Select columns de l’assistant :
Sélectionnez les colonnes à inclure dans la vue.
Pour sélectionner toutes les colonnes d’une table ou d’une vue, sélectionnez cette table ou cette vue.
Sélectionnez Generate logical table.
Pour modifier le nom, la description, les synonymes ou la clé primaire d’une table logique dans la vue sémantique :
Sélectionnez
» Edit Logical Table à côté du nom de la table logique dans l’explorateur d’objets de base de données ou Edit à côté du nom de la table logique dans Cortex Analyst.
Apportez vos modifications au nom, à la description, aux synonymes et à la clé primaire.
Si vous n’avez pas spécifié la description ou les synonymes, vous pouvez sélectionner Generate fields pour remplir ces champs automatiquement.
Sélectionnez Save.
Pour ajouter un fait, une dimension ou une métrique :
Ouvrez le formulaire d’ajout du nouvel élément :
Saisissez des informations sur le nouveau fait, la nouvelle dimension ou la nouvelle métrique, puis sélectionnez Add.
Pour modifier ou supprimer un fait, une dimension ou une métrique :
Sélectionnez Facts, Dimensions ou Metrics pour afficher la liste des faits, des dimensions ou des métriques.
Pour le fait, la dimension ou la métrique que vous souhaitez modifier :
Pour ajouter une relation :
Ouvrez le formulaire d’ajout du nouvel élément :
Dans l’explorateur d’objets de base de données, sélectionnez + Relationship.
Dans Cortex Analyst, sélectionnez + à côté de Relationships.
Saisissez un nom pour la relation, sélectionnez les tables de la relation et sélectionnez les colonnes à utiliser pour joindre les tables.
Sélectionnez Add.
Si vous prévoyez d’utiliser Cortex Analyst avec cette vue, considérez ce qui suit :
Ajoutez des exemples de requêtes à la section Verified Queries. Notez que cette section n’est disponible que dans Cortex Analyst.
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.
Sélectionnez Save.
Accord du privilège d’utilisation d’une vue sémantique à un autre rôle¶
Pour accorder à un autre rôle les privilèges nécessaires pour afficher et interroger une vue sémantique :
Accédez à la vue sémantique de l’une des manières suivantes :
Navigateur d’objets de base de données
Dans Snowsight, sélectionnez Data » Databases.
Sélectionnez la base de données et le schéma contenant la vue sémantique.
Sélectionnez Semantic views.
Sélectionnez la vue sémantique.
Cortex Analyst :
Dans Snowsight, sélectionnez AI & ML » Cortex Analyst.
Sélectionnez l’onglet Semantic views.
Sélectionnez la vue sémantique.
Sélectionnez Share.
Sélectionnez le rôle auquel doivent être accordés les privilèges pour afficher et interroger la vue sémantique.
Sélectionnez Done.
Ceci accorde les privilèges SELECT et REFERENCES sur la vue sémantique au rôle sélectionné.
Interrogation d’une vue sémantique¶
Si vous affichez une vue sémantique dans l’explorateur d’objets de la base de données, vous pouvez ouvrir une feuille de calcul pour créer une requête pour cette vue en sélectionnant » Query with SQL.
Pour plus d’informations sur la manière de créer la requête, voir Interrogation des vues sémantiques.
Bonnes pratiques pour la création d’une vue sémantique¶
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’est pas répertoriée dans la liste des vues, 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.