SQL 편집기와 ERD 에는 지금 보고 있는 SQL 이나 테이블을 AI 에게 바로 맡기는 메뉴가 있습니다. 클릭하면 오른쪽의 AI Assistant 패널이 열리고, 맡긴 대상이 첨부된 채로 요청이 만들어집니다. 답과 SQL 카드는 일반 대화와 같은 패널에서 받습니다.
사용할 수 있는 곳웹데스크톱로그인 없이로그인로컬 프로젝트계정 프로젝트
화면 구성
| 번호 | 이름 | 설명 |
|---|---|---|
| 1 | 첨부 | 맡긴 대상입니다. 쿼리 튜닝은 Query Tuning 대상 SQL, 샘플 데이터는 Sample Data 생성 대상 테이블, SQL 오류 질문은 진단할 SQL 오류 이름으로 붙습니다. 첨부가 곧 요청이라 따로 글을 적지 않습니다. |
| 2 | 도구 활동 | AI 가 대상의 테이블 정보와 실행 계획을 확인한 기록입니다. |
| 3 | 설명 | 진단과 근거입니다. 쿼리 튜닝은 진단 요약, 개선 SQL, 인덱스 권장, 기타 최적화와 가정 순서로 답합니다. |
| 4 | 개선 SQL 카드 | 수정해 작성한 SELECT 입니다. SELECT 는 응답이 끝나면 바로 실행되어 결과가 붙습니다. |
| 5 | 인덱스 카드 | CREATE INDEX 제안입니다. 스키마 변경이라 스키마 변경 항목이 비활성화되어 있으면(기본) 실행하지 않고 기다립니다. |
맡길 수 있는 일은 세 가지입니다.
| 일 | 여는 곳 | 보내는 시점 | AI 가 사용하는 도구 |
|---|---|---|---|
| 쿼리 튜닝 | SQL 편집기 우클릭의 AI: 쿼리 튜닝 항목 | 클릭하면 바로 | 테이블 정보, 실행 계획, 필요하면 실제 데이터 조회 |
| SQL 오류 질문 | SQL 오류 옆의 AI 버튼, 오류 우클릭의 AI: SQL 오류 질문 항목 | 클릭하면 바로 | 테이블 정보만 |
| 샘플 데이터 | ERD 테이블 우클릭의 항목 | 행 수를 정하고 전송 버튼을 클릭할 때 | 테이블 정보, 실제 데이터 조회 |
- 대상의 커넥션은 프로젝트 AI 설정 에서 사용 항목이 활성화되어 있어야 하고, 사용할 수 있는 API 키가 있어야 합니다. 없으면 메뉴를 클릭했을 때 사용할 수 없는 이유가 알림으로 표시됩니다.
- 다른 AI 응답을 받는 중에는 메뉴를 클릭할 수 없습니다.
- 맡긴 일은 지금 열린 대화에 이어집니다. 쿼리 튜닝과 샘플 데이터는 대상의 스키마가 컨텍스트에 더해지고, SQL 오류 질문은 컨텍스트가 오류 대상으로 변경됩니다. 대상의 스키마에는 자물쇠 표시가 붙어 제외할 수 없습니다.
쿼리 튜닝
- SQL 탭에서 튜닝할 문장에 커서를 두거나 문장 일부를 선택합니다.
- 편집기를 우클릭하고 AI: 쿼리 튜닝 항목을 클릭합니다.
- 패널이 열리고 문장이 첨부(1)되어 바로 보내집니다. AI 는 테이블 정보와 추정 실행 계획(2)을 확인한 뒤 답합니다.
- 개선 SQL 카드(4)의 결과를 원래 쿼리와 비교합니다. 인덱스 카드(5)는 검토한 뒤 실행 버튼으로 실행하거나, SQL 편집기 열기 버튼으로 편집기에 옮겨 수정합니다.
- 보내는 것은 문장에서 주석을 제외한 SQL 과 탭의 커넥션, 데이터베이스, 스키마입니다. 원래 SQL 탭의 내용은 변경되지 않습니다.
- NeoSQL 은 AI 에게 원래 쿼리와 수정한 쿼리를 실행하지 말고
EXPLAIN의 추정 계획으로만 판단하라고 지시합니다. 실제 실행 시간이나 개선 폭을 말하지 말고, 모든 제안을 검증하지 않은 것으로 표시하라고도 지시합니다. - SQLite 는 AI 가 실행 계획을 볼 수 없어 테이블 정보만으로 진단합니다. DBMS 마다 계획을 가져오는 방법은 실행 계획 에서 설명합니다.
- 통계 갱신, 파티션, 설정 변경 같은 제안은 설명으로만 하고, 실행할 SQL 카드는 수정한 쿼리와
CREATE INDEX로만 주라고 지시합니다.
SQL 오류 질문
SQL 을 실행하다 오류가 나면 오류 문구 오른쪽에 AI 버튼이 보입니다. SQL 탭의 결과 영역과 실행 계획, 테이블, 객체 탭의 데이터 영역, 스크립트 실행 기능의 오류 창, SQL 이력의 자세히 보기 창에도 같은 버튼이 있습니다.
- 오류 문구 오른쪽의 AI 버튼(1)을 클릭합니다. 오류를 우클릭하고 AI: SQL 오류 질문 항목(2)을 클릭해도 됩니다.
- 패널이 열리고 SQL, SQLSTATE, 오류 메시지 항목이 첨부되어 바로 보내집니다.
- AI 가 원인과 수정하는 방법을 설명하고, 근거가 있으면 수정한 SQL 을 카드로 줍니다.
- AI 가 사용할 수 있는 도구는 테이블 정보뿐입니다. 실제 데이터 조회와 실행 계획 도구는 주지 않으므로 데이터 값은 AI 제공자로 가지 않습니다.
- 컨텍스트는 오류가 난 커넥션의 AI 를 허용한 스키마로 변경됩니다. 오류가 특정 스키마에서 났으면 스키마만 사용합니다.
- 비밀번호나
IDENTIFIED BY처럼 자격증명이 들어 있는 SQL 의 오류는 AI 에 보내지 않습니다. AI 버튼을 클릭할 수 없습니다. - 같은 우클릭 메뉴의 오류 메시지 복사, SQL 복사, 전체 복사 항목은 AI 없이 클립보드로 복사합니다.
샘플 데이터 만들기
ERD 의 테이블에 넣을 그럴듯한 데이터를 AI 가 INSERT 문으로 만들어 줍니다.
- ERD 에서 테이블을 우클릭하고 항목을 클릭합니다.
- 패널의 입력란에 대상 테이블(1)이 첨부되고 행 수 칸(2)이 보입니다. 처음 값은 20행입니다.
- 행 수를 정하고 전송 버튼(3)을 클릭합니다.
- AI 가 컬럼, 키, 제약을 확인하고, 외래 키에 넣을 부모 테이블의 실제 키 값과 기본 키, 고유 키의 중복을 조회한 뒤
INSERT카드를 줍니다. - 카드를 검토하고 실행 버튼을 클릭합니다. 데이터 변경이므로 실행 확인 창이 표시됩니다.
- 우클릭한 테이블 하나만 대상입니다. 여러 테이블을 선택해 우클릭해도 우클릭한 테이블만 들어갑니다.
- 실제 DB 에 있는 일반 테이블에서만 만듭니다. ERD 에만 있는 새 테이블은 메뉴를 클릭하면 먼저 DB 에 반영하라는 알림이 표시됩니다. 뷰, 삭제한 테이블, 커넥션이 없는 테이블에는 메뉴가 나오지 않습니다.
- NeoSQL 은 AI 에게 자동 증가 컬럼과 생성 컬럼을
INSERT에서 제외하고, 제약을 만족하지 못하면 SQL 대신 이유를 설명하라고 지시합니다. 그래도 결과는 실행하기 전에 확인하세요. - 부모 키와 중복을 확인하는 조회는 실제 데이터를 AI 제공자로 보냅니다. 커넥션의 데이터 전송 허용 항목이 비활성화되어 있으면 조회마다 승인 카드가 표시됩니다.
- 중복 확인은 조회한 시점의 것입니다. 실행하기 전에 다른 사람이 같은 키를 넣으면 실행이 실패할 수 있습니다.
- 행 수가 많으면 응답이 키의 Max output tokens 에 걸려 잘릴 수 있습니다. 많이 필요하면 여러 번 나눠 만드세요.
주의할 점
- 쿼리 튜닝과 SQL 오류 질문은 메뉴를 클릭하는 즉시 SQL 이 AI 제공자로 갑니다. SQL 의 리터럴에 개인정보가 있으면 삭제하고 맡기세요.
- 쿼리 튜닝의 개선 SQL 은 SELECT 라서 응답이 끝나면 DB 에서 바로 실행됩니다. 무거운 쿼리를 튜닝할 때는 운영 DB 가 아닌 커넥션에서 하세요.
- AI 의 튜닝 제안은 추정 계획에 근거한 것입니다. 인덱스를 만들기 전에 실제 데이터와 부하에서 확인하세요.
- 샘플 데이터의
INSERT는 실행하면 바로 커밋됩니다. 운영 DB 에서는 실행하지 마세요. - 실행된 SQL 은 SQL 이력과 저장된 SQL 에 AI 가 실행한 것으로 남습니다.
관련 화면
- AI Assistant: 맡긴 일의 답과 SQL 카드를 받는 패널입니다.
- 프로젝트 AI 설정: 자동 실행과 데이터 전송 승인을 커넥션마다 정합니다.
- SQL 편집기: 쿼리 튜닝 메뉴가 있는 편집기입니다.
- 실행 계획: AI 가 튜닝에 사용하는 추정 실행 계획을 직접 봅니다.
- ERD 캔버스: 샘플 데이터 메뉴가 있는 테이블 우클릭 메뉴입니다.
- DB 반영: ERD 에만 있는 테이블을 DB 에 만든 뒤 샘플 데이터를 넣습니다.