Mode de routage pour Cortex Analyst

Le mode de routage est une stratégie de génération de requêtes qui privilégie le SQL sémantique et ne revient au SQL standard qu’en cas de besoin. Il agit comme une version simplifiée de SQL, avec des garde-fous provenant de vos vues sémantiques. Le mode de routage utilise vos vues sémantiques pour améliorer la précision et la cohérence. En conséquence, les métriques, les jointures et les filtres suivent les définitions gouvernées par la vue sémantique.

Cortex Analyst utilise automatiquement le mode de routage lors de la génération basée sur une vue sémantique. Aucune modification n’est apportée à votre flux de travail, à l’exception d’une meilleure qualité des conversions texte-SQL.

Note

Le mode de routage ne modifie pas les autorisations. Les vues sémantiques sont des objets Snowflake dotés de privilèges standard. Leur accès est contrôlé de la même manière que pour les tables ou les vues.

Avantages du mode de routage

Le mode de routage offre les avantages suivants :

  • Métriques cohérentes : les requêtes utilisent des définitions à partir de vues sémantiques, et non de SQL.

  • Paramètres par défaut plus sûrs : les dimensions, les métriques et les jointures proviennent de métadonnées gouvernées.

  • Adapté aux LLM : un SQL plus court est plus facile à produire correctement pour un LLM.

Le mode de routage peut être bénéfique dans les situations suivantes :

  • Vous disposez d’une ou plusieurs vues sémantiques qui définissent les entités et les métriques commerciales principales.

  • Vous souhaitez obtenir des réponses cohérentes aux questions courantes, avec une certaine flexibilité pour les cas particuliers.

Par exemple, considérez les scénarios suivants et la manière dont le mode de routage les traite :

  • Demande d’une métrique gouvernée par une dimension commerciale

    • Intention de l’utilisateur : « Valeur moyenne des commandes par segment de clientèle. »

    • Comportement du routage : essaie d’abord le SQL sémantique, de sorte que les jointures et les calculs de métriques proviennent de la vue.

      SELECT *
FROM SEMANTIC_VIEW(
  tpch_analysis
  DIMENSIONS customer.customer_market_segment
  METRICS orders.order_average_value
)
ORDER BY customer_market_segment;
      Copy

    • Avantage : pas de jointures manuelles ni de formules métriques. Les résultats s’alignent sur vos définitions BI.

  • Plusieurs métriques gouvernées avec une seule dimension

    • Intention de l’utilisateur : « Afficher le chiffre d’affaires total et le nombre de commandes par année. »

      SELECT *
FROM SEMANTIC_VIEW(
  tpch_analysis
  DIMENSIONS orders.order_year
  METRICS orders.total_revenue, orders.order_count
)
ORDER BY order_year;
      Copy

    • Avantage : les deux métriques utilisent les mêmes définitions et les mêmes filtres que dans la vue sémantique.

  • Recours pour les demandes non traitées

    • Intention de l’utilisateur : « Afficher une colonne brute ou une transformation non modélisée dans la vue. »

    • Comportement du routage : si la vue sémantique ne peut pas satisfaire la requête, Cortex Analyst route automatiquement vers le SQL standard sur les tables de base.

    • Avantage : flexibilité sans bloquer l’utilisateur.

Fonctionnement

La procédure suivante décrit les étapes que Cortex Analyst suit lors de l’utilisation du mode de routage.

  1. Cortex Analyst utilise le mode de routage dans le playground, l’API, et toutes les surface de produits.

  2. Cortex Analyst tente de produire du SQL sémantique.

    SELECT … FROM SEMANTIC_VIEW(...).
    Copy

  3. Si Cortex Analyst n’est pas en mesure de produire une requête SQL sémantique valide qui répond à la question dans le délai imparti, Cortex Analyst route vers du SQL standard sur les tables physiques.

Note

Le mode de routage ne produit du SQL sémantique que pour environ 10 % des requêtes au total. Ce nombre varie en fonction du niveau de couverture des métriques définies dans la vue sémantique.

Considérations

  • Si la vue sémantique ne répond pas à une question, Cortex Analyst revient au SQL standard. Vous devez étendre la vue sémantique pour réduire le nombre de recours au fil du temps.

Langage: Français