架构：: ACCOUNT_USAGE

CORTEX_AISQL_USAGE_HISTORY 视图¶

CORTEX_AISQL_USAGE_HISTORY 视图可用于查询 Cortex AI 函数的使用历史记录。

视图中的信息包括每次调用 AI 函数时使用的 Credit 数，根据每个查询完成的时间以一小时为增量汇总。该视图还包括相关元数据，例如用户 ID、查询 ID、函数和模型。视图中的每一行表示函数、模型、查询和仓库的特定组合的使用情况。有关 Cortex 计费的更多信息，请参阅成本注意事项。

重要

此视图将会替换 CORTEX_FUNCTIONS_USAGE_HISTORY 和 CORTEX_FUNCTIONS_QUERY_USAGE_HISTORY 视图。

列¶

列名称	数据类型	描述
USAGE_TIME	TIMESTAMP_LTZ	此使用记录计费的日期及计费时段开始时间（以当地时区为准）。使用情况在查询完成前不会被记录，因此此时间戳代表查询完成的具体小时。例如，如果查询从 05:30 开始并在 08:30 完成，则记录将在 08:00-09:00 之间进行汇总。
MODEL_NAME	TEXT	查询中使用的模型名称。一个查询可以使用多个模型；在这种情况下，使用情况历史记录包括每个模型的一行。
FUNCTION_NAME	TEXT	调用的 Cortex AI 函数的名称。一个查询可以使用多个函数；在这种情况下，使用情况历史记录包括每个函数的一行。
TOKEN_CREDITS	NUMBER	Cortex AI 函数计费的 Credit 数基于处理的令牌数量，该数量取决于指定功能与模型组合（即 QUERY_ID、MODEL_NAME 和 WAREHOUSE_ID）的运行情况。不包括仓库使用 Credit。
TOKENS	NUMBER	指定函数和模型组合下处理的令牌数量，该组合包含 QUERY_ID、MODEL_NAME 和 WAREHOUSE_ID。
TOKEN_CREDITS_GRANULAR	OBJECT	SQL 对象，该对象提供按令牌类型（输入或输出）计费的 Credit 的明细，用于指定 QUERY_ID、MODEL_NAME 和 WAREHOUSE_ID 的函数和模型组合。
TOKENS_GRANULAR	OBJECT	SQL 对象，该对象提供按令牌类型（输入或输出）处理的令牌的明细，用于指定 QUERY_ID、MODEL_NAME 和 WAREHOUSE_ID 的函数和模型组合。
QUERY_ID	TEXT	调用该函数的查询的 ID。
QUERY_TAG	TEXT	与调用函数的查询关联的标签（如有）。
USER_ID	TEXT	调用该函数的用户的内部 ID。有关身份验证的更多信息，请参阅对服务器进行身份验证。
WAREHOUSE_ID	TEXT	处理调用该函数的查询的虚拟仓库的 ID。

使用说明¶

此视图仅包括 2025 年 11 月 17 日当天或之后发生的使用情况。
计费仅在查询完成后报告，且时间戳为查询完成的具体小时。
Credit 使用基于 Snowflake 服务使用表中列出的已处理令牌数量。