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.

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

Es gibt eine kleine Verzögerung von 1 bis 2 Minuten, bis die Anfrage in der Ansicht angezeigt wird.

Zugriff auf Protokolle

Sie können diese Protokolle auf der Registerkarte Monitoring des semantischen Modells in Snowsight anzeigen. Um die Protokolle anzeigen zu können, müssen Benutzer über die SELECT-Berechtigung für referenzierte Tabellen verfügen, zusätzlich zu:

  • MONITOR or OWNERSHIP on the semantic view (when using semantic views)

  • WRITE-Berechtigung für den Stagingbereich (für semantische Modelle, die in einer Datei in einem Stagingbereich gespeichert sind)

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>'
  )
);
Copy

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 eine Abfrage mit Inline-YAML (anstelle einer semantischen Ansicht oder einer Datei im Stagingbereich) erfolgt, ist die Anfrage nicht über die Tabellenfunktion zugänglich, wird aber in der unten beschriebenen Ansicht und Ereignistabelle angezeigt.

If you are using a role that has been granted the SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN or SNOWFLAKE.CORTEX_ANALYST_REQUESTS_VIEWER application role, you can query the SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V view. This view includes all requests to Cortex Analyst across all semantic models and views.

You can also query the raw event data in the SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_RAW event table. The responses are in the OpenTelemetry format. The SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V view contains the same data, formatted and processed for human readability.

Sprache: Deutsch