Cortex Analyst 管理员监控

为了提高 Cortex Analyst 提供的答案的质量，您必须不断完善语义模型。为帮助您完善模型，Cortex Analyst 会将请求记录到 Snowflake 数据库中的事件表中。此功能目前仅适用于存储在暂存区（通过 semantic_model_file 请求正文参数传递）中的语义模型。

日志包括以下内容：

  • 提出问题的用户

  • 提出的问题

  • 生成的 SQL

  • 错误和/或警告

  • 请求和响应正文

  • 其他元数据

访问日志

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

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

使用 SQL 查询日志

使用 snowflake.local.cortex_analyst_requests UDTF 检索特定语义模型的日志。此功能执行访问控制检查，以确保调用用户拥有必要的权限。

以下是如何使用 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

参数：

  • semantic_model_type：目前，您只能使用 FILE_ON_STAGE。

  • semantic_model_name：完全限定的暂存区文件 URL。例如 @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.cortex_analyst_requests_admin 应用程序角色，还可以从 snowflake.local.cortex_analyst_requests_raw 事件表中查询原始事件。响应采用开放式遥测格式。snowflake.local.cortex_analyst_requests_v 视图的数据与 snowflake.local.cortex_analyst_requests_raw 事件表相同，但格式可读性更好。

语言: 中文