> ## 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.

# SQL Server 통합

> Windows 또는 SQL Server 인증과 TLS 암호화 연결을 사용해 Octoparse 수집 데이터를 Microsoft SQL Server에 기록하세요.

수집 데이터를 Microsoft SQL Server에 직접 기록합니다. Windows 인증 및 SQL Server 계정 인증을 지원합니다.

***

## 사전 요구 사항

* Octoparse 무료 플랜 이상
* 네트워크를 통해 Octoparse에서 연결할 수 있는 SQL Server 인스턴스
* 대상 데이터베이스 쓰기 권한이 있는 사용자 계정
* Windows 인증: SQL Server Native Client 11.0이 설치된 Windows에서 Octoparse 데스크톱 클라이언트를 실행해야 함

***

## 내보내기 구성

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

**구성 이름**

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

**연결 정보**

| 필드     | 설명                    | 기본값    |
| ------ | --------------------- | ------ |
| 서버 이름  | 데이터베이스 호스트(IP 또는 도메인) | —      |
| 포트     | 포트 번호                 | `1433` |
| 인증     | 인증 방법(아래 참고)          | —      |
| 사용자 이름 | SQL Server 계정         | —      |
| 비밀번호   | 계정 비밀번호               | —      |
| 연결 암호화 | TLS 활성화               | 꺼짐     |

**인증 옵션:**

| 옵션            | 설명                                             | 플랫폼           |
| ------------- | ---------------------------------------------- | ------------- |
| SQL Server 인증 | 데이터베이스 계정 및 비밀번호로 연결                           | Windows/macOS |
| Windows 인증    | 현재 로그인된 Windows 사용자로 연결하며 사용자 이름이나 비밀번호가 필요 없음 | Windows 전용    |

Windows 인증을 선택하면 사용자 이름과 비밀번호 필드가 비활성화됩니다.

> **연결 암호화:** Azure SQL Database와 많은 관리형 SQL Server 인스턴스에는 기본적으로 암호화가 필요하므로 이 옵션을 켜세요.

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

연결 정보를 입력한 후 데이터베이스 이름 드롭다운을 클릭합니다. Octoparse가 연결해 시스템 데이터베이스를 제외한 데이터베이스를 나열하면 대상을 선택하세요.

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

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

**연결 테스트**

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

***

## 쓰기 모드

### 추가(삽입)

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

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

지정한 기본 키로 각 행을 판단합니다. 레코드가 있으면 업데이트하고 없으면 삽입합니다. 필드 매핑에서 기본 키 열을 지정하세요.

***

## 일반적인 오류

| 오류                        | 원인                                   | 해결 방법                                                       |
| ------------------------- | ------------------------------------ | ----------------------------------------------------------- |
| `Login failed for user`   | 잘못된 자격 증명                            | 자격 증명을 다시 확인합니다.                                            |
| `Cannot open database`    | 잘못된 데이터베이스 이름 또는 권한 부족               | 데이터베이스 이름과 계정 권한을 확인합니다.                                    |
| `Connection refused`      | 네트워크에 연결할 수 없거나 포트가 잘못됨              | 방화벽 규칙과 SQL Server 수신 포트를 확인합니다.                            |
| `SSL connection required` | 서버에 암호화가 필요하지만 연결 암호화가 꺼져 있음         | 연결 암호화를 켭니다.                                                |
| Windows 인증을 사용할 수 없음      | Windows가 아니거나 Native Client가 설치되지 않음 | SQL Server 인증으로 전환하거나 SQL Server Native Client 11.0을 설치합니다. |