> ## 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가 컬럼 정보를 제공하므로, 파일 커넥터와 달리 제목줄 선택 단계가 없습니다.

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

## 단계

**1. 연결 · 테이블**

접속 정보를 입력하고 `연결 & 테이블 조회`로 연결한 뒤, 테이블 또는 컬렉션을 선택합니다.

**2. 데이터 뷰 · 필터링**

미리보기를 확인하고 조건에 맞는 행만 사용하도록 필터를 설정합니다.

**3. 데이터 매핑**

컬럼마다 의미(필수, 표준 필드명)와 상세(선택)를 지정합니다.

**4. 등록**

이름을 입력하고 데이터소스를 등록합니다.

## 연결 정보 (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)가 필요합니다.

### SSH 터널 (선택)

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

## 데이터 조회

**테이블 (SQL)**

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

**MongoDB**

컬렉션을 선택하고 소스 방식을 고릅니다.

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

## 보안 · 수정

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

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.