Cortex Analyst 管理员监控

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

日志包括以下内容：

  • 提出问题的用户

  • 提出的问题

  • 生成的 SQL

  • 错误和/或警告

  • 请求和响应正文

  • 其他元数据

从提出请求到在视图中显示请求之间会存在短暂延迟，大约 1-2 分钟。

访问日志

You can view these logs in the Monitoring tab of the Semantic Model within Snowsight. In order to view the logs, users must have the SELECT privilege on referenced tables, in addition to:

  • 语义视图的 OWNERSHIP 权限（使用语义视图时）

  • 暂存区的 WRITE 权限（适用于存储在暂存区文件中的语义模型）

或者，您可以根据自己的权限，使用 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 请求的表。

如果使用行内 YAML（而不是语义视图或暂存区上的文件）进行查询，则无法通过表函数访问该请求，但可以在下文详述的视图和事件表中查看。

如果您使用的角色已被授予 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 视图以更具可读性的格式包含相同的数据。

语言: 中文