Cortex Analyst Administrator-Überwachung

Um die Qualität der von Cortex Analyst gelieferten Antworten zu verbessern, müssen Sie das semantische Modell weiter verfeinern. Damit Sie das Modell verfeinern können, 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 gespeichert sind (Übergabe über den Parameter semantic_model_file des Anfrage-Body).

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

Verwenden Sie snowflake.local.cortex_analyst_requests UDTF, um Protokolle für ein bestimmtes semantisches Modell abzurufen. Diese Funktion führt Zugriffssteuerungs-Prüfungen durch, um sicherzustellen, dass der aufrufende Benutzer über die erforderlichen Berechtigungen verfügt.

Im Folgenden finden Sie ein Beispiel für die Verwendung von 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

Parameter:

  • semantic_model_type: Derzeit können Sie nur FILE_ON_STAGE verwenden.

  • semantic_model_name: Die vollständig qualifizierte Stagingdatei URL. Beispiel: @my_db.my_schema.my_stage/path/to/file.yaml.

Gibt zurück: Eine Tabelle mit allen API-Anfragen für das angegebene semantische Modell.

Wenn Sie die Anwendungsrolle snowflake.cortex_analyst_requests_admin haben, 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 hinweg.

Wenn Sie die Anwendungsrolle snowflake.cortex_analyst_requests_admin haben, können Sie auch rohe Ereignisse aus der Ereignistabelle snowflake.local.cortex_analyst_requests_raw abfragen. Die Antworten sind im offenen Telemetrieformat. Die Ansicht snowflake.local.cortex_analyst_requests_v enthält die gleichen Daten wie die Ereignistabelle snowflake.local.cortex_analyst_requests_raw, jedoch in einem besser lesbaren Format.

Sprache: Deutsch