Cortex Analyst Administrator-Überwachung¶
Um die Qualität der von Cortex Analyst gelieferten Antworten zu verbessern, müssen Sie das semantische Modell oder die Ansicht weiter verfeinern. Um Ihnen die Verfeinerung des Modells oder der Ansicht zu erleichtern, protokolliert Cortex Analyst Anfragen in einer Ereignistabelle in der Snowflake-Datenbank.
Dieses Feature ist derzeit nur für semantische Modelle verfügbar, die in einem Stagingbereich (im Body der Anfrage durch das Feld semantic_model_file
angegeben) und semantischen Ansichten (im Feld semantic_view
angegeben) gespeichert sind.
Die Protokolle enthalten Folgendes:
Der Benutzer, der die Frage gestellt hat
Die Frage lautete
Generierte SQL
Fehler und/oder Warnungen
Anfrage- und Antwort-Bodys
Andere Metadaten
Zugriff auf Protokolle¶
Sie können diese Protokolle auf der Registerkarte Monitoring des semantischen Modells in Snowsight anzeigen. Benutzer müssen über die Berechtigung WRITE für den Stagingbereich und die Berechtigung SELECT für referenzierte Tabellen verfügen, um die Protokolle anzeigen zu können.
Alternativ können Sie die Protokolle auch direkt von der Snowflake-Datenbank aus abfragen, indem Sie SQL verwenden, je nach Ihren Berechtigungen.
Abfragen von Protokollen mit SQL¶
Rufen Sie die Tabellenfunktion SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS auf, um Protokolle für ein bestimmtes semantisches Modell oder eine Ansicht abzurufen. Diese Tabellenfunktion führt Prüfungen der Zugriffssteuerung durch, um sicherzustellen, dass der Aufrufer die erforderlichen Berechtigungen für den Zugriff auf die Anfragedaten besitzt.
Im Folgenden sehen Sie ein Beispiel für den Aufruf der Funktion:
SELECT * FROM TABLE(
SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
'<semantic_model_or_view_type>',
'<semantic_model_or_view_name>'
)
);
Wenn Sie diese Funktion aufrufen, geben Sie die folgenden Argumente an:
semantic_model_or_view_type
: Geben Sie die Art des semantischen Modells oder der Ansicht an, die in den Anfragen verwendet wird:Für ein semantisches Modell, das in einer Datei in einem Stagingbereich definiert ist, geben Sie
'FILE_ON_STAGE'
an.Für eine semantische Ansicht, geben Sie
'SEMANTIC_VIEW'
an.
semantic_model_or_view_name
: Geben Sie den Speicherort an, an dem das semantische Modell oder die Ansicht definiert ist:Für ein semantisches Modell, das in einer Datei in einem Stagingbereich definiert ist, geben Sie den vollständig qualifizierten Pfad zur Spezifikationsdatei des semantischen Modells an (z. B.
@my_db.my_schema.my_stage/path/to/file.yaml
).Für eine semantische Ansicht geben Sie den vollständig qualifizierten Namen der semantischen Ansicht an.
Gibt zurück: Eine Tabelle mit allen API-Anfragen für das angegebene semantische Modell oder die Ansicht.
Wenn Sie eine Rolle verwenden, der die Anwendungsrolle SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN zugewiesen wurde, können Sie die Ansicht SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V abfragen. Diese Ansicht enthält alle Anfragen an Cortex Analyst über alle semantischen Modelle und Ansichten hinweg.
Sie können auch die rohen Ereignisdaten in der Ereignistabelle SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_RAW abfragen. Die Antworten sind im offenen Telemetrieformat. Beachten Sie, dass die Ansicht SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V die gleichen Daten in einem besser lesbaren Format enthält.