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 이벤트 테이블과 동일한 데이터가 있지만 더 읽기 쉬운 형식으로 되어 있습니다.

언어: 한국어