Cortex Analyst 관리자 모니터링

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

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

  • 질문한 사용자

  • 질문한 질문

  • 생성된 SQL

  • 오류 및/또는 경고

  • 요청 및 응답 본문

  • 기타 메타데이터

요청이 이루어진 후 뷰에 표시되기까지 약 1~2분 정도 약간의 지연이 발생합니다.

로그에 액세스하기

이러한 로그는 Snowsight 내 의미 체계 모델의 Monitoring 탭에서 볼 수 있습니다. 로그를 보려면 사용자는 참조된 테이블에 대해 SELECT 권한을 보유해야 하며, 여기에 더해 다음 권한도 필요합니다.

  • 의미 체계 뷰에서 OWNERSHIP(의미 체계 뷰를 사용하는 경우)

  • 스테이지에서 WRITE 권한(스테이지의 파일에 저장된 의미 체계 모델의 경우)

또는 권한에 따라 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 요청이 포함된 테이블입니다.

인라인 YAML을 사용하여 쿼리가 실행된 경우(의미 체계 뷰 또는 스테이지의 파일 대신), 해당 요청은 테이블 함수를 통해 액세스할 수 없지만 아래에 설명된 뷰 및 이벤트 테이블에서 확인할 수 있습니다.

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 뷰에는 동일한 데이터가 더 읽기 쉬운 형식으로 포함되어 있습니다.

언어: 한국어