사용 방법

프로젝트 화면에서 AI Chat을 열어 사용합니다. SQL이 포함된 응답이 완료되면 AI SQL Editor가 자동으로 활성화될 수 있습니다.

Connection 컨텍스트

AI는 선택한 DBMS와 Database·Schema를 기본 컨텍스트로 사용해 SQL을 작성합니다. 필요하면 메타데이터와 제한된 실제 DB 값을 조회할 수 있으며, 실제 접근 범위는 Connection의 DB 계정 권한에 따릅니다.

• Key: 요청에 사용할 Provider Key와 모델
• Connection: SQL을 작성하고 실행할 데이터베이스 연결
• Database·Schema: 테이블과 컬럼을 조회할 기본 범위
• 필요한 경우 테이블·뷰, 컬럼, 키, 인덱스, 관계와 제약조건을 자동으로 확인

답변 생성 중 DB 조회

AI는 정확한 답변을 만들기 위해 메타데이터 도구와 읽기 전용 SELECT 도구를 사용할 수 있습니다.

• 메타데이터 조회: 테이블·뷰, 컬럼, 키, 인덱스, 관계와 제약조건을 확인합니다.
• 내부 SELECT: 한 번에 최대 10행을 30초 안에 조회하며 DML·DDL은 실행하지 않습니다.
• 도구 승인 정책이 ‘항상 허용’이면 내부 SELECT를 바로 수행하고, ‘승인 필요’이면 Chat의 승인 카드에서 사용자가 허용할 때까지 요청을 대기합니다.
• 조회 결과는 프로젝트의 민감 컬럼 마스킹 정책에 따라 Provider 전달 전에 마스킹됩니다. 정책과 분류 결과에 따라 원본 값이 전달될 수 있습니다.

스키마별 실행 정책

프로젝트 Owner는 헤더의 AI 설정에서 Connection·Database·Schema별로 SELECT, DML, DDL의 실행 방식을 각각 정할 수 있습니다. 새 조합의 기본값은 SELECT 자동 실행, DML·DDL 실행 전 확인입니다.

AI SQL Editor

Chat은 설명과 SQL을 보여주고, 실행 상태와 결과는 AI SQL Editor가 관리합니다.

• AI가 반환한 SQL마다 생성된 SQL Query Block이 만들어집니다.
• 자동 실행과 수동 실행의 상태 및 실행 이력을 선택해 볼 수 있습니다.
• SELECT 반환 행, DML 영향 행, 오류와 결과 생략 여부를 확인할 수 있습니다.
• 동일한 Query Block을 다시 실행해 새로운 실행 이력을 남길 수 있습니다.
• Query Block은 읽기 전용입니다. SQL을 수정하려면 복사해 일반 SQL Editor에서 편집하세요.
• 실행 이력은 현재 앱 실행 중에만 유지되며 저장된 Chat을 다시 열어도 복원되지 않습니다.

질문 예시

목표, 기간, 필터와 원하는 출력 컬럼을 함께 적으면 더 정확한 SQL을 얻을 수 있습니다.