> For the complete documentation index, see [llms.txt](https://docs.tibero.com/sysmasterdb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tibero.com/sysmasterdb/8.4_manual/ai-chatbot/data-query.md).

# Data Query

자연어로 질문을 입력하면 챗봇이 관제 대상 인스턴스의 모니터링 데이터를 조회하여 표와 요약 설명으로 답변한다. 조회 대상은 화면에서 선택한 인스턴스로 한정된다.

## 질문 예시

* "오늘 세션 수가 가장 많았던 인스턴스 보여줘"
* "최근 3시간 동안 실행 시간이 긴 SQL 상위 10개"
* "어제 인스턴스별 메모리 사용량 알려줘"

## 시간 표현 처리

"오늘", "어제", "최근 3시간"과 같은 시간 표현은 사용자의 시간대를 기준으로 해석된다. 예를 들어 사용자의 시간대가 Asia/Seoul인 경우 "어제"는 한국 시간 기준 어제 00:00부터 23:59까지의 범위로 조회된다.

## 제약 사항

* 데이터 조회(SELECT)만 수행한다. 챗봇을 통해 데이터가 변경되거나 삭제되지 않는다.
* 조회 결과 건수를 지정하지 않으면 기본 20건을 조회하며, 최대 400건까지 조회할 수 있다.
* 인스턴스를 하나도 선택하지 않고 질문하면 답변 대신 오류 메시지가 표시된다. 인스턴스를 선택한 뒤 Retry를 클릭하면 다시 질문할 수 있다.
* 수집하지 않는 데이터 등 답변할 수 없는 질문에는 조회가 불가능한 사유를 안내한다.

## 링크 기능

<figure><img src="https://264733866-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fgw24XwSa6QXLFywb7Txd%2Fuploads%2FFshEu7s3dC1jIVxMtuxx%2Fimage.png?alt=media&amp;token=147c8b7e-ee86-4cc2-a412-15db7baf02b8" alt=""><figcaption></figcaption></figure>

답변 표에서 인스턴스 ID 칼럼 값이 링크로 표시되며(SQL Detail로 이동하는 경우에는 SQL ID 칼럼 값도), 클릭하면 관련 메뉴가 새 창으로 열린다. 이동할 메뉴는 표에 포함된 칼럼으로 정해지며, 여러 칼럼이 함께 있으면 아래 표의 위쪽 항목이 우선한다. 행에 인스턴스 ID와 조회 시작·종료 시각 값이 있어야 링크가 표시된다.

| 관련 칼럼         | 이동 메뉴                                                                                                             |
| ------------- | ----------------------------------------------------------------------------------------------------------------- |
| SQL ID        | [SQL Detail](/sysmasterdb/8.4_manual/detail/sql-detail.md)                                                        |
| Session Count | [All Session Flow](/sysmasterdb/8.4_manual/analysis/history-analysis/all-session-flow.md)                         |
| Disk          | [Filesystem Usage](/sysmasterdb/8.4_manual/analysis/usage-analysis/filesystem-usage.md)                           |
| CPU           | Performance Trend ([OverAll](/sysmasterdb/8.4_manual/analysis/performance-analysis/performance-trend/overall.md)) |
| Process       | Performance Trend ([OverAll](/sysmasterdb/8.4_manual/analysis/performance-analysis/performance-trend/overall.md)) |
| Memory        | Performance Trend ([OverAll](/sysmasterdb/8.4_manual/analysis/performance-analysis/performance-trend/overall.md)) |
