Suivi de l’administrateur Cortex Analyst

Pour améliorer la qualité des réponses fournies par Cortex Analyst, vous devez continuer à affiner le modèle ou la vue sémantique. Pour vous aider à affiner le modèle ou la vue, Cortex Analyst connecte les requêtes à une table d’événements dans la base de données Snowflake.

Les journaux comprennent les éléments suivants :

  • L’utilisateur qui a posé la question

  • La question posée

  • SQL généré

  • Erreurs et/ou avertissements

  • Corps de la requête et de la réponse

  • Autres métadonnées

Il y a un petit délai, de l’ordre de 1 à 2 minutes, entre le moment où une requête est effectuée et le moment où elle est visible dans la vue.

Accès aux journaux

Vous pouvez voir ces journaux dans l’onglet Monitoring du modèle sémantique dans Snowsight. Pour voir les journaux, les utilisateurs doivent disposer du privilège SELECT sur les tables référencées, en plus de :

  • OWNERSHIP sur la vue sémantique (lors de l’utilisation de vues sémantiques)

  • Les privilèges WRITE sur la zone de préparation (pour les modèles sémantiques stockés dans un fichier sur une zone de préparation)

Vous pouvez également interroger directement les journaux de la base de données Snowflake à l’aide de SQL, en fonction de vos privilèges.

Interroger les journaux avec SQL

Appelez la fonction de table SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS pour récupérer les journaux d’un modèle ou d’une vue sémantique spécifique. Cette fonction de table effectue des contrôles d’accès pour s’assurer que l’appelant dispose des privilèges requis pour accéder aux données de la requête.

Voici un exemple d’appel de la fonction :

SELECT * FROM TABLE(
  SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
    '<semantic_model_or_view_type>',
    '<semantic_model_or_view_name>'
  )
);
Copy

Lorsque vous appelez cette fonction, transmettez les arguments suivants :

  • semantic_model_or_view_type: Précisez le type de modèle ou de vue sémantique utilisé dans les requêtes :

    • Pour un modèle sémantique défini dans un fichier sur une zone de préparation, spécifiez 'FILE_ON_STAGE'.

    • Pour une vue sémantique, spécifiez 'SEMANTIC_VIEW'.

  • semantic_model_or_view_name : Spécifiez l’emplacement où le modèle ou la vue sémantique est défini :

    • Pour un modèle sémantique défini dans un fichier sur une zone de préparation, indiquez le chemin complet du fichier de spécification du modèle sémantique (par exemple, @my_db.my_schema.my_stage/path/to/file.yaml).

    • Pour une vue sémantique, indiquez le nom complet de la vue sémantique.

Retourne : Une table contenant toutes les requêtes API pour le modèle ou la vue sémantique spécifié.

si une requête a été effectuée à l’aide de YAML en ligne (au lieu d’une vue sémantique ou d’un fichier en zone de préparation), elle ne sera pas accessible via la fonction de la table, mais sera visible dans la vue et le tableau des événements détaillés ci-dessous.

si vous utilisez un rôle qui s’est vu attribuer le rôle d’applicationSNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN, vous pouvez interroger la vue SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V. Cette vue comprend toutes les requêtes adressées à Cortex Analyst pour tous les modèles et toutes les vues sémantiques.

Vous pouvez également effectuer une requête sur les données brutes des événements dans la table des événements SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_RAW. Les réponses sont au format télémétrique ouvert. Notez que la vue SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V contient les mêmes données dans un format plus lisible.

Langage: Français