Éditeur de vues sémantiques

L’éditeur de vues sémantiques vous permet d’affiner votre vue sémantique ou d’en créer une à partir de zéro. Vous pouvez utiliser cette interface pour modifier les vues créées par le pilote automatique ou pour télécharger et modifier des spécifications YAML existantes.

Accéder à l’éditeur

Vous pouvez accéder à l’éditeur en utilisant soit un catalogue, soit Cortex Analyst.

Pour accéder à l’éditeur via un catalogue, procédez comme suit :

  1. Connectez-vous à Snowsight.

  2. Sélectionnez catalog.

  3. Sélectionnez votre base de données et votre schéma.

  4. Sélectionnez Semantic views, puis sélectionnez votre vue.

  5. Sélectionnez l’onglet Semantic information.

Procédez comme suit pour accéder à l’éditeur via 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. Ouvrez votre vue.

Modifier des métadonnées

Après avoir accédé à l’éditeur, vous pouvez modifier les métadonnées de la vue sémantique.

Pour modifier le nom ou la description, procédez comme suit :

  1. Sélectionnez Edit à côté du nom de la vue sémantique.

  2. Mettez à jour les champs Name ou Description.

  3. Sélectionnez Save.

Astuce

Incluez des descriptions détaillées indiquant pour quel type d’analyse cette vue est utile.

Gérer des tables logiques

Une table logique est une vue sur une table de base de données physique.

Pour ajouter une table, procédez comme suit :

  1. Sélectionnez + Logical Table.

  2. Sélectionnez la table ou la vue physique.

  3. Sélectionnez Next.

  4. Sélectionnez les colonnes à inclure.

  5. Sélectionnez Generate logical table.

Pour modifier une table, procédez comme suit :

  1. Sélectionnez Edit (ou More options » Edit Logical Table) à côté du nom de la table.

  2. Modifiez les champs Name, Description, Synonyms ou Primary Key.

  3. Sélectionnez Save.

Astuce

Utilisez le bouton Generate fields pour remplir automatiquement les descriptions ou les synonymes à l’aide de l’AI.

Gérer du contenu (faits, dimensions, métriques)

Pour ajouter un élément, procédez comme suit :

  1. Sélectionnez + à côté de Facts, Dimensions ou Metrics.

  2. Saisissez les détails :

    • Name

    • Expression

    • Data Type

  3. Sélectionnez Add.

Pour modifier ou supprimer un élément, procédez comme suit :

  1. Sélectionnez un élément existant pour le modifier, ou sélectionnez More options pour le supprimer.

Types de contenu :

  • Dimensions : Données catégoriques, telles que la région du produit.

  • Faits : Données quantitatives, telles que le revenu net.

  • Métriques : Agrégations, par exemple SUM(revenue).

Note

Les métriques dérivées (combinant d’autres métriques) et les modificateurs d’accès privé sont des fonctionnalités spécifiques prises en charge dans les vues sémantiques.

Gérer des relations

Les relations définissent la manière dont les tables sont jointes.

Pour ajouter une relation, procédez comme suit :

  1. Sélectionnez + à côté de Relations.

  2. Saisissez un Name pour la relation.

  3. Sélectionnez la Left Table et la Right Table.

  4. Spécifiez les Join Columns pour chaque table.

  5. (Facultatif) Si nécessaire, spécifiez un type de jointure pour la compatibilité héritée.

  6. Sélectionnez Add.

La relation apparaît dans la liste des relations et active les jointures entre les tables spécifiées.

Note

En général, il n’est pas nécessaire de spécifier le type de jointure pour une vue sémantique. Cortex Analyst détermine celui-ci au moment de la requête, bien que vous puissiez le spécifier si nécessaire pour les YAMLs hérités.

Fonctionnalités avancées

Pour améliorer la précision de Cortex Analyst, vous pouvez ajouter ce qui suit comme contexte :

Requêtes vérifiées

Les requêtes vérifiées montrent au modèle comment répondre à des questions complexes.

  1. Sélectionnez + à côté de Verified Queries.

  2. Saisissez une Question en langage naturel.

  3. Saisissez la SQL Query correspondante.

  4. Sélectionnez Add.

La requête vérifiée est enregistrée et sera utilisée pour guider Cortex Analyst en répondant à des questions similaires.

Synonymes

Les synonymes aident les utilisateurs à trouver des données en utilisant une autre terminologie, telle que « consommateur » pour « client ».

  1. Accédez à la table ou à la colonne pour laquelle vous souhaitez ajouter des synonymes.

  2. Sélectionnez Edit.

  3. Dans le champ Synonyms, saisissez des termes alternatifs séparés par des virgules.

  4. Sélectionnez Save.

Instructions personnalisées

Les instructions personnalisées fournissent des règles métier spécifiques pour guider la génération de requêtes.

  1. Sélectionnez la section Custom Instructions.

  2. Saisissez des règles métier spécifiques, telles que « Toujours filtrer par utilisateurs actifs, sauf indication contraire ».

  3. Sélectionnez Save.

Les instructions personnalisées seront appliquées lorsque Cortex Analyst générera des requêtes en utilisant cette vue sémantique.

Charger un fichier YAML

Si vous disposez d’un modèle sémantique YAML existant :

  1. Dans le menu de navigation, sélectionnez AI & ML » Cortex Analyst.

  2. Sélectionnez Create new » Upload YAML file.

  3. Sélectionnez votre fichier.

  4. Sélectionnez Convert and save pour créer une vue sémantique native à partir de celui-ci.

Partage et privilèges

Pour permettre à d’autres personnes d’utiliser la vue, procédez comme suit :

  1. Sélectionnez Share (ou More options » Share).

  2. Sélectionnez le rôle auquel accorder l’accès.

Cela accorde les privilèges SELECT et REFERENCES sur la vue sémantique.