Cortex Analyst 管理员监控

为了提高 Cortex Analyst 提供的答案的质量，您必须不断完善语义模型或视图。为帮助您完善模型或视图，Cortex Analyst 会将请求记录到 Snowflake 数据库中的事件表中。

此功能目前仅适用于存储在暂存区中的语义模型（由 semantic_model_file 字段在请求正文中指定）和语义视图（在 semantic_view 字段中指定）。

日志包括以下内容：

  • 提出问题的用户

  • 提出的问题

  • 生成的 SQL

  • 错误和/或警告

  • 请求和响应正文

  • 其他元数据

访问日志

您可以在 Snowsight 中语义模型的 Monitoring 选项卡中查看这些日志。用户必须对暂存区具有 WRITE 权限，对引用的表具有 SELECT 权限才能查看日志。

或者，您可以根据自己的权限，使用 SQL 直接从 Snowflake 数据库中查询日志。

使用 SQL 查询日志

调用 SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS 表函数，检索特定语义模型或视图的日志。此表函数执行访问控制检查，以确保调用者具备访问请求数据所需的权限。

以下示例展示了如何调用此函数：

SELECT * FROM TABLE(
  SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
    '<semantic_model_or_view_type>',
    '<semantic_model_or_view_name>'
  )
);
Copy

调用此函数时，传入以下实参：

  • semantic_model_or_view_type：指定请求中所用语义模型或视图的类型：

    • 对于在暂存区中的文件中定义的语义模型，请指定 'FILE_ON_STAGE'。

    • 对于语义视图，请指定 'SEMANTIC_VIEW'。

  • semantic_model_or_view_name：指定定义语义模型或视图的位置：

    • 对于在暂存区中的文件内定义的语义模型，请指定语义模型规范文件的完全限定路径（例如，@my_db.my_schema.my_stage/path/to/file.yaml）。

    • 对于语义视图，请指定语义视图的完全限定名称。

返回：包含指定语义模型或视图的所有 API 请求的表。

如果您使用的角色已被授予 SNOWFLAKE.CORTEX_ANALYST_REQUESTS_ADMIN 应用程序角色，您可以查询 SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V 视图。此视图包括所有语义模型和视图中对 Cortex Analyst 的所有请求。

您也可以在 SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_RAW 事件表中查询原始事件数据。响应采用开放式遥测格式。请注意，SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V 视图以更具可读性的格式包含相同的数据。

语言: 中文