사용 전 확인

Sample Data는 실제 데이터베이스에 연결된 ERD 테이블을 대상으로 동작합니다.

• 사용 가능한 AI Provider Key가 등록되어 있어야 합니다.
• 프로젝트 ERD가 활성 상태인 실제 DB Connection과 Database·Schema에 연결되어 있어야 합니다.
• 대상은 실제 DB에 존재하는 일반 테이블이어야 합니다. View, 시스템 테이블, 삭제 예정 테이블 또는 아직 DB에 반영하지 않은 가상 테이블은 사용할 수 없습니다.

사용 방법

ERD의 테이블 컨텍스트 메뉴에서 Sample Data 생성을 시작합니다.

대상과 세션 컨텍스트

Sample Data 요청에는 대상 테이블과 행 수가 전용 첨부 항목으로 고정됩니다.

• 대상에는 Connection의 Database·Schema와 우클릭한 테이블의 전체 이름이 표시되며 직접 편집할 수 없습니다.
• 행 수 기본값은 20이며 1 이상의 정수로 변경할 수 있습니다.
• 현재 AI 세션의 DB 컨텍스트가 같으면 기존 세션과 그 세션에 고정된 Provider Key를 그대로 사용합니다.
• 컨텍스트가 다르면 대상 Connection과 Database·Schema로 새 세션을 만듭니다. 사용할 수 있는 기본 Provider Key가 우선 선택됩니다.
• 첨부 항목을 제거하면 Sample Data 전용 요청이 취소되고 일반 AI Chat으로 돌아갑니다.

실제 DB 값 조회와 데이터 보호

유효한 FK 값과 중복되지 않는 후보 값을 만들기 위해 선택한 Provider로 제한된 실제 DB 값이 전달될 수 있습니다.

• 대상 테이블과 관계된 테이블의 컬럼, 키, UNIQUE, FK 등 필요한 메타데이터를 사용합니다.
• FK 부모 값이나 명시적 PK·UNIQUE 후보 확인에 필요한 읽기 전용 조회 결과만 사용합니다.
• 내부 SELECT 도구가 승인 필요로 설정되어 있으면 Chat에 승인 카드가 표시되고, 항상 허용이면 조회가 자동으로 계속됩니다.
• 각 내부 조회는 최대 10행, 30초 제한을 적용하며 설정된 정책에 따라 민감정보 마스킹과 응답 크기 제한을 거칩니다. LOB·Binary 컬럼 값 조회는 허용하지 않습니다.

생성 결과와 실행 정책

AI는 지정한 테이블 한 곳을 대상으로 요청한 행 수의 INSERT SQL을 생성하도록 지시받습니다. 최종 SQL을 클라이언트가 별도로 검증하지 않으므로 실행 전에 직접 확인해야 합니다.

• AI 요청에는 우클릭한 테이블 하나만 INSERT 대상으로 전달되며 관계된 부모 테이블의 INSERT는 요청하지 않습니다.
• FK가 있으면 참조 가능한 부모 키를 찾기 위해 실제 DB 값을 제한적으로 조회할 수 있습니다.
• 명시적 PK 또는 UNIQUE 후보 값이 현재 데이터와 충돌하는지 확인할 수 있지만 동시 실행까지 포함한 유일성을 보장하지는 않습니다.
• 생성된 SQL의 컬럼, 값, 건수와 제약조건 충족 여부를 확인한 뒤 실행하세요.

문제 해결

메뉴가 보이지 않거나 요청을 전송할 수 없다면 다음 항목을 확인합니다.

• 메뉴가 없으면 대상이 일반 물리 테이블인지, 실제 Connection과 Database·Schema가 유효한지 확인하세요. View, 시스템 테이블과 삭제 예정 테이블은 대상이 아닙니다.
• 가상 테이블에서 메뉴를 선택했다면 먼저 ERD 변경사항을 실제 DB에 적용한 뒤 다시 시도하세요.
• 전송 버튼이 비활성화되어 있으면 행 수가 1 이상의 정수인지, 활성 Provider Key가 있는지, Key 로딩 또는 다른 AI 작업이 진행 중인지 확인하세요.
• 새 세션 전환을 취소하면 Sample Data 요청도 시작되지 않습니다. 현재 대화는 유지되므로 필요한 경우 다시 테이블에서 시작하세요.