Cortex Analyst 관리자 모니터링

Cortex Analyst 에서 제공하는 답변의 품질을 개선하려면 의미 체계 모델 또는 뷰를 지속적으로 개선해야 합니다. 모델 또는 뷰를 구체화하는 데 도움이 되도록 Cortex Analyst 는 Snowflake 데이터베이스의 이벤트 테이블에 요청을 로그합니다.

이 기능은 현재 스테이지(요청 본문에 semantic_model_file 필드로 지정)에 저장된 의미 체계 모델과 의미 체계 뷰(semantic_view 필드에 지정)에만 사용할 수 있습니다.

로그에는 다음이 포함됩니다.

  • 질문한 사용자

  • 질문한 질문

  • 생성된 SQL

  • 오류 및/또는 경고

  • 요청 및 응답 본문

  • 기타 메타데이터

로그에 액세스하기

이러한 로그는 Snowsight 내 의미 체계 모델의 Monitoring 탭에서 볼 수 있습니다. 사용자는 스테이지에 대한 WRITE 권한이 있어야 하고 참조된 테이블에 대한 SELECT 권한이 있어야 로그를 볼 수 있습니다.

또는 권한에 따라 SQL 을 사용하여 Snowflake 데이터베이스에서 직접 로그를 쿼리할 수 있습니다.

SQL 을 사용하여 로그 쿼리하기

SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS 테이블 함수를 호출하여 특정 의미 체계 모델 또는 뷰에 대한 로그를 검색합니다. 이 테이블 함수는 액세스 제어 검사를 수행하여 호출자가 요청 데이터에 액세스할 수 있는 필수 권한을 가지고 있는지 확인합니다.

다음은 함수를 호출하는 방법의 예입니다.

SELECT * FROM TABLE(
  SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS(
    '<semantic_model_or_view_type>',
    '<semantic_model_or_view_name>'
  )
);
Copy

이 함수를 호출할 때 다음 인자를 전달합니다.

  • semantic_model_or_view_type: 요청에 사용되는 의미 체계 모델 또는 뷰의 유형을 지정합니다.

    • 스테이지의 파일에 정의된 의미 체계 모델의 경우 'FILE_ON_STAGE' 를 지정합니다.

    • 의미 체계 뷰의 경우 'SEMANTIC_VIEW' 를 지정합니다.

  • semantic_model_or_view_name: 의미 체계 모델 또는 뷰가 정의된 위치를 지정합니다.

    • 스테이지의 파일에 정의된 의미 체계 모델의 경우 의미 체계 모델 사양 파일에 대한 정규화된 경로(예: @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.LOCAL.CORTEX_ANALYST_REQUESTS_RAW 이벤트 테이블에서 원시 이벤트 데이터를 쿼리할 수도 있습니다. 응답은 개방형 원격 분석 형식으로 제공됩니다. SNOWFLAKE.LOCAL.CORTEX_ANALYST_REQUESTS_V 뷰에는 동일한 데이터가 더 읽기 쉬운 형식으로 포함되어 있습니다.

언어: 한국어