데이터베이스 연결

**관리 → 데이터베이스 연결(DB 연결)**은 직접 운영하는 PostgreSQL·MySQL을 Ian On으로 가져옵니다. 지식 베이스로 동기화하거나, AI가 실시간으로 쿼리하게 하거나입니다.

연결 추가하기

접속 문자열을 붙여넣고 연결 테스트 & 스키마 분석을 누르세요. Ian On이 연결을 확인하고 스키마를 읽어, 무엇이 담겨 있는지 평이한 설명 초안을 만듭니다. 이름과 설명을 확인하고 추가를 누릅니다. 접속 문자열은 저장 시 암호화됩니다(AES-256-GCM). PostgreSQL인지 MySQL인지는 주소에서 자동 판별됩니다.

각 연결에는 범위가 있습니다 — 전체 공개, 또는 특정 팀(선택적으로 하위 팀에 상속) — 에이전트와 같습니다.

데이터를 쓰는 세 가지 방식

• 임베딩(Embedding) — 행을 주기적으로 검색 가능한 텍스트로 바꿔 지식 베이스에 합칩니다. 검색이 가장 빠르지만 실시간은 아닙니다.
• 쿼리(Query) — AI가 필요할 때 SQL을 작성합니다. 실시간 데이터에 가장 좋습니다.
• 임베딩 + 쿼리 — 둘 다. 자주 쓰는 행은 임베딩으로, 실시간 쿼리로 최신 값을 가져옵니다.

임베딩이나 둘 다인 경우, 동기화 주기(cron), 포함할 테이블, 행을 문장으로 바꾸는 텍스트 템플릿({{컬럼}} 자리표시자 사용), 증분 동기화용 변경 추적 컬럼(updated_at 등), 배치 크기를 설정합니다.

스키마 설명하기 (주석)

AI가 테이블을 이해하도록, 테이블과 컬럼마다 짧은 설명을 달 수 있습니다. 배지가 출처를 보여 줍니다 — 수동, DB(데이터베이스 주석), 또는 AI(추론). 손으로 편집하거나, 한 컬럼만 AI 추론을 시키거나, AI 일괄로 비어 있는 모든 컬럼을 한 번에 설명하게 할 수 있습니다(멈출 수 있는 진행 바와 함께). 좋은 설명은, AI가 알 수 없는 컬럼 이름을 추측하느냐 제대로 맞히느냐를 가릅니다.

접근 통제하기 (권한 부여)

권한(grants) 창이 어떤 에이전트와 팀이 연결을 쓸 수 있는지 정합니다. **권한 강제(엄격 모드)**를 켜면 명시적 권한 부여를 요구합니다 — 강제가 켜진 연결에는 방패 배지가 붙습니다. 엄격 모드는 꺼져 있지만 권한이 존재하면, 규칙은 있으나 아직 강제되지 않는다는 호박색 방패가 알려 줍니다.

AI에게 쓰기 허용하기

기본적으로 AI는 읽기만 합니다. AI 쓰기(allow_ai_write) 토글을 켜면 INSERT / UPDATE / DELETE를 실행할 수 있고, 켤 때 경고 배너가 나타납니다. 스키마를 바꾸는 명령(DROP / ALTER / TRUNCATE)은 쓰기를 켜도 항상 차단됩니다. 쓰기를 허용한다면, 강력한 admin 계정이 아니라 그 용도 전용 데이터베이스 사용자를 가리키게 하세요.

모니터링

연결마다 테스트(지금 연결을 열어 지연을 봄), 동기화(일회성 동기화를 돌려 옮긴 행 수와 오류를 봄), 상태(테이블별 마지막 동기화 시각, 동기화된 행 수, 최근 오류)를 할 수 있습니다. 스키마 캐시가 화면을 받쳐 주며, 새로고침으로 실시간 스키마를 다시 읽고, 캐시가 하루를 넘기면 경고가 나타납니다.