Query Tuning

SQL Editor의 쿼리를 AI Assistant로 보내 필요한 경우 조회한 추정 실행 계획과 스키마 메타데이터를 참고한 재작성 또는 인덱스 제안을 받습니다.

튜닝 대상 선택

일반 SQL Editor에서 읽기 전용 SELECT 한 문장(SELECT로 끝나는 WITH CTE 포함)을 대상으로 사용합니다.

  • 선택 영역이 있으면 선택한 SQL을 우선 사용합니다.
  • 선택 영역이 없으면 커서가 놓인 SQL 문장을 사용합니다.
  • AI Chat으로 전달하기 전에 SQL 주석은 제거됩니다.
Tip

진입 메뉴가 선택 내용을 모두 사전 검증하지는 않습니다. 여러 문장, 쓰기 SQL, 잠금 SELECT를 보내면 추정 실행 계획 조회가 실패하거나 조언이 부정확할 수 있으므로 대상 한 문장만 정확히 선택하세요.

DB 컨텍스트 확인

Query Tuning은 현재 AI Chat 세션에 선택된 Connection과 Database·Schema를 사용합니다.

주의:

우클릭한 SQL Editor의 Connection이 AI Chat으로 자동 전환되지는 않습니다. AI Chat 상단의 DB가 튜닝 대상 SQL Editor와 같은지 반드시 확인하세요.

참고: 다른 DB가 선택되어 있거나 기존 세션의 DB 선택이 잠겨 있다면 새 세션을 만들고 올바른 Connection과 Schema를 선택한 다음 SQL Editor에서 ‘AI: 쿼리 튜닝’을 다시 실행하세요.

사용 방법

SQL Editor의 컨텍스트 메뉴에서 Query Tuning을 시작합니다.

1

SQL 선택 또는 커서 배치

튜닝할 SQL을 선택합니다. 선택하지 않았다면 대상 SQL 문장 안에 커서를 놓습니다.

2

AI: 쿼리 튜닝 선택

에디터를 우클릭하고 ‘AI: 쿼리 튜닝’을 선택합니다. AI Chat이 열리고 튜닝 대상 SQL과 기본 지침이 입력됩니다.

3

대상과 지침 확인

Query Tuning 대상 SQL 블록은 읽기 전용입니다. 아래의 기본 튜닝 지침은 목적에 맞게 편집할 수 있습니다.

4

전송 후 제안 검토

전송을 누르면 AI 분석이 시작되고, 필요하면 추정 실행 계획과 메타데이터를 조회합니다. 응답의 재작성 SQL, 인덱스 제안, 가정과 주의사항을 함께 검토합니다.

SQL Editor에서 AI 쿼리 튜닝을 시작하는 컨텍스트 메뉴

결과 검토

Query Tuning은 원본 SQL Editor를 자동으로 변경하지 않고 검토할 수 있는 튜닝 근거와 후보를 제공합니다. 응답의 실행 가능한 SQL은 실행 정책에 따라 처리됩니다.

  • 필요할 때 조회하는 추정 실행 계획은 MySQL, MariaDB, SQL Server, PostgreSQL, Oracle, H2에서 지원하며 SQLite에서는 제공하지 않습니다.
  • AI는 조회된 추정 실행 계획과 필요한 컬럼·키·인덱스·관계 정보를 참고해 재작성 또는 인덱스 후보를 제안합니다.
  • 제안된 SQL이나 인덱스는 원본 SQL Editor에 자동 반영되지 않습니다. 다만 응답의 실행 가능한 SQL 블록은 대상 Connection·Database·Schema의 실행 정책에 따라 자동 실행되거나 실행 전 확인이 필요할 수 있습니다.
  • 한 번 전송하면 Query Tuning 대상 블록이 제거됩니다. 같은 SQL을 다시 분석하려면 SQL Editor에서 다시 시작합니다.

주의: 응답에 실행 가능한 SQL 블록이 포함되면 대상 Connection·Database·Schema의 실행 정책이 동일하게 적용됩니다. 모든 재작성 SQL을 직접 검토하려면 프로젝트 Owner가 해당 스키마의 SELECT·DML·DDL 정책을 ‘실행 전 확인’으로 설정해야 합니다.

미검증 조언

추정 실행 계획은 실제 운영 데이터 분포와 실행 시간을 보장하지 않습니다. 적용 전 SQL 의미가 같은지 확인하고 테스트 환경에서 실제 실행 계획과 성능을 비교하세요.