스키마:: ACCOUNT_USAGE

CORTEX_AISQL_USAGE_HISTORY 뷰¶

CORTEX_AISQL_USAGE_HISTORY 뷰는 :doc:`Cortex AI 함수 </user-guide/snowflake-cortex/aisql>`의 사용 기록을 쿼리하는 데 사용할 수 있습니다.

뷰의 정보에는 AI 함수를 호출할 때마다 소비된 크레딧 수가 포함되어 있으며, 각 쿼리가 완료된 시간을 기준으로 1시간 단위로 집계됩니다. 뷰에는 사용자 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	QUERY_ID, MODEL_NAME, WAREHOUSE_ID 조합에 지정된 함수와 모델에 대해 처리된 토큰 수를 기준으로 Cortex AI 함수 사용에 대해 청구된 크레딧 수입니다. 웨어하우스 사용 크레딧은 포함되지 않습니다.
TOKENS	NUMBER	QUERY_ID, MODEL_NAME, WAREHOUSE_ID의 조합에 지정된 함수 및 모델에 대해 처리된 토큰 수입니다.
TOKEN_CREDITS_GRANULAR	OBJECT	QUERY_ID, MODEL_NAME, WAREHOUSE_ID의 조합에 지정된 함수 및 모델에 대해 토큰 유형(입력 또는 출력)별로 청구된 크레딧 분석을 제공하는 SQL 오브젝트입니다.
TOKENS_GRANULAR	OBJECT	QUERY_ID, MODEL_NAME, WAREHOUSE_ID의 조합에 지정된 함수 및 모델에 대해 토큰 유형(입력 또는 출력)별로 처리된 토큰 분석을 제공하는 SQL 오브젝트입니다.
QUERY_ID	TEXT	함수가 호출된 쿼리의 ID입니다.
QUERY_TAG	TEXT	함수가 호출된 쿼리와 연결된 태그(있는 경우)입니다.
USER_ID	TEXT	함수를 호출한 사용자의 내부 ID입니다. 인증에 대한 자세한 내용은 서버에 인증하기 섹션을 참조하십시오.
WAREHOUSE_ID	TEXT	함수가 호출된 쿼리를 처리한 가상 웨어하우스의 ID입니다.

사용법 노트¶

이 뷰에는 2025년 11월 17일 또는 그 이후에 발생한 사용량만 포함됩니다.
청구는 쿼리가 완료된 후에만 보고되며, 타임스탬프는 쿼리가 완료된 시간입니다.
크레딧 사용량은 `Snowflake Service Consumption Table`_에 설명된 대로 처리된 토큰 수를 기준으로 합니다.