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

# Oracle 통합

> Instant Client 설정, 스키마 및 테이블 소유자 구성과 upsert 모드를 사용해 Octoparse 수집 데이터를 Oracle에 기록하세요.

수집 데이터를 Oracle 데이터베이스에 직접 기록합니다. Octoparse를 실행하는 컴퓨터에 Oracle Instant Client를 설치해야 합니다.

## 사전 요구 사항

* Octoparse 무료 플랜 이상
* Oracle 11g 이상
* Oracle Instant Client(64비트) 설치(아래 참고)
* 대상 스키마 쓰기 권한이 있는 사용자 계정

***

## Oracle Instant Client 설치

Octoparse는 Thick 모드로 Oracle에 연결하므로 Instant Client가 필요합니다.

1. [Oracle 웹사이트](https://www.oracle.com/database/technologies/instant-client/downloads.html)에서 **Instant Client Basic**(64비트)을 다운로드합니다.
2. 로컬 디렉터리(예: `C:\oracle\instantclient`)에 압축을 풉니다.
3. 해당 디렉터리를 시스템 PATH에 추가합니다.
4. Octoparse를 다시 시작합니다.

> **참고:** Instant Client 아키텍처는 Octoparse와 일치해야 하며 둘 다 64비트여야 합니다. 아키텍처가 일치하지 않으면 `DPI-1047`이 발생합니다.

***

## 내보내기 구성

다음 순서로 내보내기 설정을 입력하세요.

**구성 이름**

나중에 재사용할 수 있도록 구성에 이름을 지정합니다. 드롭다운에서 기존 구성을 선택하거나 새 이름을 입력해 구성을 생성할 수 있습니다.

**연결 정보**

| 필드      | 설명                    | 예시              |
| ------- | --------------------- | --------------- |
| 서버 이름   | 데이터베이스 호스트(IP 또는 도메인) | `192.168.1.100` |
| 포트      | 포트 번호                 | `1521`          |
| 사용자 이름  | 데이터베이스 사용자            | `scott`         |
| 비밀번호    | 데이터베이스 비밀번호           | —               |
| 테이블 소유자 | 테이블이 속한 스키마(소유자)      | `SCOTT`         |

Octoparse는 `{server}:{port}/{database}` 형식의 연결 문자열을 자동으로 조합합니다.

> **테이블 소유자는 필수입니다.** Oracle에서 테이블은 특정 스키마에 속하므로 테이블 소유자가 없으면 Octoparse가 대상에 쿼리하거나 쓸 수 없습니다. 일반적으로 사용자 이름과 같지만 공유 스키마를 사용할 때는 다를 수 있습니다.

**데이터베이스 이름**

Oracle의 데이터베이스 이름은 드롭다운이 아닌 자유 텍스트 필드(서비스 이름 또는 SID)입니다.

**데이터베이스 테이블**

데이터베이스 이름을 입력한 후 `user_tables`에서 조회한 데이터베이스 테이블 드롭다운에서 대상 테이블을 선택합니다. 대상 스키마에 테이블을 미리 생성하세요. Octoparse는 필드 매핑을 위해 해당 열을 읽습니다.

**연결 테스트**

**연결 테스트**를 클릭해 연결을 검증한 다음 **내보내기**를 클릭해 시작합니다.

***

## 쓰기 모드

### 추가(삽입)

내보낼 때마다 기존 데이터에 영향을 주지 않고 테이블 끝에 새 행을 추가합니다.

### Upsert(삽입 또는 업데이트)

지정한 기본 키로 각 행을 판단합니다. 레코드가 있으면 업데이트하고 없으면 삽입합니다. 필드 매핑에서 기본 키 열을 지정하세요. 대상 테이블에 기본 키 제약 조건이 필요하면 Oracle에서 미리 구성합니다.

***

## 일반적인 오류

| 오류          | 원인                            | 해결 방법                                  |
| ----------- | ----------------------------- | -------------------------------------- |
| `DPI-1047`  | Instant Client 누락 또는 잘못된 아키텍처 | 64비트 Instant Client를 설치하고 PATH에 추가합니다. |
| `ORA-12899` | 값이 열 길이를 초과함                  | 열을 확장합니다(`ALTER TABLE ... MODIFY`).    |
| `ORA-01017` | 잘못된 자격 증명                     | 자격 증명을 다시 확인합니다.                       |
| `ORA-12541` | 리스너에 연결할 수 없음                 | 호스트, 포트 및 네트워크 연결을 확인합니다.              |
| `ORA-00942` | 테이블 또는 뷰가 없음                  | 테이블 소유자가 올바른지 확인합니다.                   |