CORTEX_AI_FUNCTIONS_USAGE_HISTORY 视图¶

此 Account Usage 视图可用于查询 Cortex AI 函数的使用情况历史记录。

此视图包括每次调用 Cortex 函数时使用的词元和 credit 数，根据函数和模型以一小时为增量汇总。该视图还包括相关元数据，例如仓库 ID、函数执行的开始和结束时间，以及函数和模型的名称（如果指定）。每行代表单个函数调用的使用情况。

列¶


列名称	数据类型	描述
START_TIME	TIMESTAMP_LTZ	使用情况汇总窗口的开始时间。窗口分辨率为 1 小时。例如，如果查询于 05:30 开始并于 08:30 完成，则使用情况视图中会显示四条记录，分别对应 5:00、6:00、7:00 和 8:00 聚合窗口。
END_TIME	TIMESTAMP_LTZ	使用情况汇总窗口结束。
FUNCTION_NAME	VARCHAR	调用的 Cortex AI 函数的名称。使用历史记录包含查询中调用的每个函数的一行。
MODEL_NAME	VARCHAR	模型名称。未将模型指定为参数的 Cortex AI 函数为空。使用历史记录包含查询中使用的每个模型的一行。
QUERY_ID	VARCHAR	调用该函数的查询的 ID。
WAREHOUSE_ID	NUMBER	系统生成的标识符，用于调用 Cortex AI 函数的查询所用的仓库。
ROLE_NAMES	ARRAY	与查询关联的角色。主要角色是数组的第一个元素。
QUERY_TAG	VARCHAR	与调用函数的查询关联的标签（如有）。
USER_ID	VARCHAR	系统为调用 Cortex AI 函数的查询执行用户生成的标识符。
METRICS	ARRAY	针对特定功能与模型，在 QUERY_ID、MODEL_NAME 和 WAREHOUSE_ID 组合下的使用量指标细分。请参阅下方`指标列`_了解详细信息。
CREDITS	NUMBER	Cortex AI 函数计费的 Credit 数基于指标数，该数量取决于指定功能与模型组合（即 QUERY_ID、MODEL_NAME 和 WAREHOUSE_ID）的运行情况。不包括仓库使用 Credit。
IS_COMPLETED	BOOLEAN	查询是否在此聚合窗口中完成。

指标列包含特定功能与模型在 QUERY_ID、MODEL_NAME 和 WAREHOUSE_ID 组合下的使用量细分。每个元素包含一个 key 对象（带有 metric 类型和 unit 字段）和 value。结构因计量方法而异，如下所示：

**基于词元的计量**（大多数 AI 函数）：按词元计数计费，可以作为单独的输入和输出词元计数，也可以作为总词元计数，具体取决于函数。

示例：[{"key":{"metric":"input","unit":"tokens"},"value":17},{"key":{"metric":"output","unit":"tokens"},"value":65}]`<br>`[{"key":{"metric":"total","unit":"tokens"},"value":527}]
基于页面的计量 (AI_PARSE_DOCUMENT)：按页面计费。

示例：[{"key":{"metric":"total","unit":"pages"},"value":3}]