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.
Cette fonction n’est actuellement disponible que pour les modèles sémantiques stockés dans une zone de préparation (spécifiés dans le corps de la requête par le champ semantic_model_file
) et les vues sémantiques (spécifiées dans le champ semantic_view
).
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¶
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>'
)
);
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 vous utilisez un rôle qui a reçu le rôle d’application SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN, vous pouvez effectuer une requête sur la vue SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V. Cette vue comprend toutes les requêtes adressées à Cortex Analyst dans l’ensemble des modèles et des 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.