> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ones1ght.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 데이터베이스 커넥터

> PostgreSQL · MySQL · MS-SQL · Oracle · MongoDB에 연결해 조회 시점에 라이브로 읽습니다.

## 개요

데이터베이스 커넥터는 PostgreSQL · MySQL · MS-SQL · Oracle · MongoDB에 연결합니다.
데이터를 복사해 저장하지 않고 **조회 시점에 DB에서 라이브로 읽습니다.**
DB가 컬럼 정보를 제공하므로, 파일 커넥터와 달리 제목줄 선택 단계가 없습니다.

<Info>
  이 화면은 **관리자(Manager) 이상**(owner·manager)만 접근할 수 있습니다. 메뉴 가시성 `manage`.
</Info>

## 단계

<Steps>
  <Step title="연결 · 테이블">
    접속 정보를 입력하고 `연결 & 테이블 조회`로 연결한 뒤, 테이블 또는 컬렉션을 선택합니다.
  </Step>

  <Step title="데이터 뷰 · 필터링">
    미리보기를 확인하고 조건에 맞는 행만 사용하도록 필터를 설정합니다.
  </Step>

  <Step title="데이터 매핑">
    컬럼마다 의미(필수, 표준 필드명)와 상세(선택)를 지정합니다.
  </Step>

  <Step title="등록">
    이름을 입력하고 데이터소스를 등록합니다.
  </Step>
</Steps>

## 연결 정보 (SQL)

| 필드       | 설명                                                                                       |
| -------- | ---------------------------------------------------------------------------------------- |
| 호스트      | DB 서버 주소                                                                                 |
| 포트       | 기본값 — PostgreSQL `5432` · MySQL `3306` · MS-SQL `1433` · Oracle `1521` · MongoDB `27017` |
| 데이터베이스   | 대상 데이터베이스                                                                                |
| 스키마 (선택) | 스키마 지정 (MongoDB 제외)                                                                      |
| 사용자      | 접속 계정                                                                                    |
| 비밀번호     | 접속 비밀번호 (AES-256-GCM 암호화 저장)                                                             |

### SSL / TLS

| 모드                        | 설명                |
| ------------------------- | ----------------- |
| 사용 안 함                    | 암호화하지 않음          |
| 암호화 (require)             | 전송 암호화만           |
| CA 검증 (verify-ca)         | 서버 CA 인증서(PEM) 검증 |
| CA + 호스트 검증 (verify-full) | CA + 호스트명까지 검증    |

<Note>
  verify 모드(verify-ca · verify-full)는 서버 CA 인증서(PEM)가 필요합니다.
</Note>

### SSH 터널 (선택)

Bastion 호스트를 경유해 DB에 접속합니다. 필드: Bastion 호스트 · 포트 · 사용자 · 인증 방식(개인 키 PEM 또는 비밀번호). 인증정보는 암호화되어 저장됩니다.

## 데이터 조회

<Tabs>
  <Tab title="테이블 (SQL)">
    조회할 테이블을 선택하거나 **직접 쿼리**를 작성합니다. 직접 쿼리는 `SELECT` / `WITH` (읽기 전용)만 허용되며, 간단 빌더로 기본 `SELECT` 문을 생성할 수 있습니다.
  </Tab>

  <Tab title="MongoDB">
    컬렉션을 선택하고 소스 방식을 고릅니다.

    * **컬렉션 샘플**: 컬렉션에서 샘플을 읽습니다.
    * **Aggregation 파이프라인**: JSON 배열로 파이프라인을 작성합니다. `$out` · `$merge`는 허용되지 않습니다(읽기 전용).
  </Tab>
</Tabs>

## 보안 · 수정

<Warning>
  비밀번호는 **AES-256-GCM으로 암호화**되어 저장되며 클라이언트로 반환되지 않습니다.
  수정 시 비밀번호 입력란을 비워 두면 저장된 값이 유지됩니다.
</Warning>

<Note>
  수정 화면에서는 연결 대상(호스트 · 포트 · 데이터베이스 · 사용자)은 읽기 전용이며, 보안 설정(SSL · SSH 터널)과 비밀번호만 변경할 수 있습니다.
</Note>