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 sémantique. Pour vous aider à affiner le modèle, Cortex Analyst connecte les requêtes à une table d’événements dans la base de données Snowflake. Cette fonction n’est actuellement disponible que pour les modèles sémantiques stockés dans une zone de préparation (transmis par le paramètre du corps de la requête semantic_model_file).

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

Accès aux journaux

Vous pouvez voir ces journaux dans l’onglet Monitoring du modèle sémantique dans Snowsight. Les utilisateurs doivent disposer du privilège WRITE sur la zone de préparation et du privilège SELECT sur les tables référencées pour pouvoir voir les journaux.

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

Utilisez le site snowflake.local.cortex_analyst_requests UDTF pour récupérer les journaux pour un modèle sémantique spécifique. Cette fonction effectue des contrôles d’accès pour s’assurer que l’utilisateur appelant dispose des privilèges nécessaires.

Voici un exemple d’utilisation de l’UDTF :

SELECT * FROM table(SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
  semantic_model_type = 'FILE_ON_STAGE',
  semantic_model_name = '@my_db.my_schema.my_stage/path/to/file.yaml'
));
Copy

Paramètres :

  • semantic_model_type : Actuellement, vous ne pouvez utiliser que FILE_ON_STAGE.

  • semantic_model_name : L’URL du fichier de zone de préparation pleinement qualifié. Par exemple, @my_db.my_schema.my_stage/path/to/file.yaml.

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

Si vous avez le rôle d’application snowflake.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 sémantiques.

Si vous avez le rôle d’application snowflake.cortex_analyst_requests_admin, vous pouvez également effectuer des requêtes sur des événements bruts à partir de la table d’événements snowflake.local.cortex_analyst_requests_raw. Les réponses sont au format télémétrique ouvert. La vue snowflake.local.cortex_analyst_requests_v contient les mêmes données que la table des événements snowflake.local.cortex_analyst_requests_raw, mais dans un format plus lisible.

Langage: Français