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
- Using the AI-assisted generator to create a semantic view
- Chargement d’une spécification YAML pour créer une vue sémantique
Modifier une vue sémantique
Accord du privilège d’utilisation d’une vue sémantique à un autre rôle

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.

Chargement d’une spécification YAML 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.

Using the AI-assisted generator to create a semantic view¶

Use the AI-assisted generator to create a semantic view that combines semantic information from multiple sources. Instead of creating a semantic view manually with your own YAML specification, you can use the model generator within Snowsight to save time. The process of creating a semantic view requires the following information:

A description with basic information about the view
Context, such as example SQL queries
The data source (at least one table or view) that you’re using
The columns that you’re using

The AI-assisted generator handles inputs in the following ways:

Example SQL queries
- Validate the list of queries and throw out invalid queries.
- Extract all tables and columns from the queries and present them for review before adding to the semantic view.
- Extract relationships from the queries.
- Add valid queries to the semantic view as verified queries.
Table metadata
- Extract all table and column descriptions.
- Add primary and unique keys to the semantic view by analyzing metadata or counting distinct values to determine cardinality and relationship types.
Query history
- Surface historical SQL queries as suggestions to the semantic view. The AI-assisted generator identifies the most common types of queries that fit within the bounds of the selected tables and columns.
- Find valid relationships and column types for the semantic view.
- Cortex Analyst uses the query history accessible by the role used to create the semantic model to generate both relationships and verified query suggestions.

Connectez-vous à Snowsight.
Dans le menu de navigation, sélectionnez AI & ML » Cortex Analyst.
At the top of the navigation menu, select Create new » Create new Semantic View.
Select a location to store the semantic view after creation.
Enter a name for the semantic view.
For Description, specify information about the semantic view.
Sélectionnez Next.
To provide context, add the following information:
- For SQL Queries, provide example questions and their respective SQL queries that you want to use as part of the view.
For Select tables, provide the data source that you’re using to create the semantic view.

You must provide at least one table or view. There’s no limit on the tables or views that you can specify, but Snowflake recommends not using more than 10.
Sélectionnez Next.
For Select columns, select the columns that you’re using to create the semantic view.

You can select all the columns or specific columns. For performance reasons, Snowflake recommends not using more than 50 columns.
Select whether you want to add sample values from each column to the semantic view. Sample values help improve the accuracy of Cortex Analyst’s results.
Select whether you want to add AI-generated descriptions for tables and columns to the semantic view. The AI-generated descriptions are based on the column names and sample values.
Select Create and save. You can view the progress of the view generation, including details about the steps that the view generator is taking, on the semantic view page. The process can take a few minutes.
Optional: To make additional modifications, edit the view either by using Snowsight or by editing the YAML file directly.

Cortex Analyst automatically generates suggestions to improve the semantic view after creation. After the suggestions appear, which might take several minutes, you can review them and apply them to the view as needed.

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
  1. Connectez-vous à Snowsight.
  2. Dans le menu de navigation, sélectionnez Catalog » Database Explorer.
  3. Sélectionnez la base de données et le schéma dans lesquels vous souhaitez créer la vue sémantique.
  4. Sélectionnez Create » Semantic View » Upload YAML file.
  5. Sélectionnez le fichierYAML à charger.
  6. 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.
  7. Si vous voulez que le fichier YAML soit chargé vers un chemin spécifique de la zone de préparation, spécifiez ce chemin.
  8. Sélectionnez Upload.
- Cortex Analyst :
  1. Connectez-vous à Snowsight.
  2. Dans le menu de navigation, sélectionnez AI & ML » Cortex Analyst.
  3. Sélectionnez Create new » Upload YAML file.
  4. Sélectionnez le fichierYAML à charger.
  5. 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
  1. Connectez-vous à Snowsight.
  2. Dans le menu de navigation, sélectionnez Catalog » Database Explorer.
  3. Sélectionnez la base de données et le schéma contenant la vue sémantique.
  4. Sélectionnez Semantic views.
  5. Sélectionnez la vue sémantique.
  6. Sélectionnez l’onglet Semantic information.
- Cortex Analyst :
  1. Connectez-vous à Snowsight.
  2. Dans le menu de navigation, sélectionnez AI & ML » Cortex Analyst.
  3. Sélectionnez l’onglet Semantic views.
  4. 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.
  5. 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 :
  1. Sélectionnez Edit à côté du nom de la vue sémantique.
  2. Apportez des modifications au nom ou à la description.
  3. Sélectionnez Apply.
- Pour ajouter une nouvelle table logique à la vue sémantique :
  1. Sélectionnez + Logical Table dans l’explorateur d’objets de la base de données ou + dans Cortex Analyst.
  2. À l’étape Select a table de l’assistant :
    1. Sélectionnez la table ou la vue qui contient les données que vous souhaitez utiliser dans votre vue sémantique.
    2. Sélectionnez Next.
  3. Dans l’étape Select columns de l’assistant :
    1. 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.
    2. 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 :
  1. 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.
  2. 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.
  3. Sélectionnez Save.
- Pour ajouter un fait, une dimension ou une métrique :
  1. Ouvrez le formulaire d’ajout du nouvel élément :
    - Dans l’explorateur d’objets de la base de données, sélectionnez. , puis sélectionnez Fact, Dimension ou Metric.
    - Dans Cortex Analyst, sélectionnez + à côté de Facts, Dimensions ou Metrics.
  2. 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 :
  1. Sélectionnez Facts, Dimensions ou Metrics pour afficher la liste des faits, des dimensions ou des métriques.
  2. Pour le fait, la dimension ou la métrique que vous souhaitez modifier :
    - Sélectionnez Edit pour modifier l’élément.
    - Sélectionnez » Remove fact, Remove dimension ou Remove metric pour supprimer l’élément.
- Pour ajouter une relation :
  1. 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.
  2. Saisissez un nom pour la relation, sélectionnez les tables de la relation et sélectionnez les colonnes à utiliser pour joindre les tables.
  3. 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
  1. Connectez-vous à Snowsight.
  2. Dans le menu de navigation, sélectionnez Catalog » Database Explorer.
  3. Sélectionnez la base de données et le schéma contenant la vue sémantique.
  4. Sélectionnez Semantic views.
  5. Sélectionnez la vue sémantique.
  6. Sélectionnez » Share.
- Cortex Analyst :
  1. Connectez-vous à Snowsight.
  2. Dans le menu de navigation, sélectionnez AI & ML » Cortex Analyst.
  3. Sélectionnez l’onglet Semantic views.
  4. Sélectionnez la vue sémantique.
  5. 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.