스키마:: ACCOUNT_USAGE

CORTEX_CODE_SNOWSIGHT_USAGE_HISTORY 뷰¶

CORTEX_CODE_SNOWSIGHT_USAGE_HISTORY 뷰는 Snowsight의 Cortex Code 사용 기록을 쿼리하는 데 사용할 수 있습니다.

뷰의 정보에는 사용자가 Snowsight에서 Cortex Agent와 상호 작용할 때마다 사용된 크레딧 수가 포함됩니다. 뷰의 각 행은 단일 요청을 나타내며 집계된 토큰 및 크레딧에 대한 세부 정보와 모델별로 세분화된 분석을 제공합니다. 뷰에는 사용자 ID, 요청 ID와 같은 관련 메타데이터도 포함됩니다.

참고

이 뷰에는 Cortex Code CLI에서 시작된 요청은 포함되지 않습니다. Cortex Code CLI에서 시작된 요청은 CORTEX_CODE_CLI_USAGE_HISTORY 뷰에 기록됩니다.

열¶


열 이름	데이터 타입	설명
USER_ID	NUMBER	요청한 사용자의 고유 식별자입니다.
USER_TAGS	ARRAY	사용자와 연결된 태그입니다. 배열의 각 오브젝트에는 다음 값 페어가 포함됩니다. `level`: 태그가 적용되는 수준(예: “ACCOUNT” 또는 “USER”)입니다. `tag_database`: 태그가 정의된 데이터베이스입니다. `tag_schema`: 태그가 정의된 스키마입니다. `tag_name`: 태그의 이름입니다. `tag_value`: 태그의 값입니다.
REQUEST_ID	VARCHAR	요청의 고유 식별자입니다.
PARENT_REQUEST_ID	VARCHAR	해당되는 경우 상위 요청의 식별자입니다.
USAGE_TIME	TIMESTAMP_TZ	사용량이 기록된 타임스탬프입니다.
TOKEN_CREDITS	NUMBER	요청에 사용된 토큰 크레딧 수입니다.
TOKENS	NUMBER	요청에 사용된 총 토큰 수입니다.
TOKENS_GRANULAR	OBJECT	모델별 토큰 사용량의 세분화된 분석입니다. 각 키는 모델 이름이고 각 값은 다음 필드를 포함하는 오브젝트입니다. `input`: 입력 토큰의 수입니다. `cache_read_input`: 캐시 읽기 입력 토큰의 수입니다. `cache_write_input`: 캐시 쓰기 입력 토큰의 수입니다. `output`: 출력 토큰의 수입니다.
CREDITS_GRANULAR	OBJECT	모델별 크레딧 사용량의 세분화된 분석입니다. 각 키는 모델 이름이고 각 값은 다음 필드를 포함하는 오브젝트입니다. `input`: 입력 토큰의 크레딧 값입니다. `cache_read_input`: 캐시 읽기 입력 토큰의 크레딧 값입니다. `cache_write_input`: 캐시 쓰기 입력 토큰의 크레딧 값입니다. `output`: 출력 토큰의 크레딧 값입니다.

사용법 노트¶

이 뷰는 지난 365일(1년) 동안 계정에 대한 최신 크레딧 사용량을 제공합니다.
크레딧 비율 사용량은 `Snowflake Service Consumption Table`_에 설명된 대로 처리된 토큰 수를 기준으로 합니다.

예¶

Snowsight 사용량 기록에서 Cortex Code를 검색합니다.

SELECT *
  FROM SNOWFLAKE.ACCOUNT_USAGE.CORTEX_CODE_SNOWSIGHT_USAGE_HISTORY;

지난 30일 동안 사용자당 사용한 총 크레딧을 검색합니다.

SELECT USER_ID,
       SUM(TOKEN_CREDITS) AS TOTAL_CREDITS
  FROM SNOWFLAKE.ACCOUNT_USAGE.CORTEX_CODE_SNOWSIGHT_USAGE_HISTORY
  WHERE USAGE_TIME >= DATEADD('day', -30, CURRENT_TIMESTAMP())
  GROUP BY USER_ID
  ORDER BY TOTAL_CREDITS DESC;