---
title: "DB upload 실행 (VPC)"
slug: "analytics-cloudsearch-postdbuploadvpc"
tags: ["Cloud Search"]
updated: 2026-10-22T10:46:51Z
published: 2026-10-22T10:46:51Z
canonical: "api-gov.ncloud-docs.com/analytics-cloudsearch-postdbuploadvpc"
---

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

# DB upload 실행 (VPC)

VPC 환경에서 이용 가능합니다.

도메인에 db upload 기능을 실행합니다.

```
POST https://cloudsearch.apigw.gov-ntruss.com/CloudSearch/v1/domain/{name}/document/manage/db_upload/vpc
```

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string | 생성되어져 있는 Domain 이름 | 자동 완성 설정 이력을 조회하고자 하는 Domain 이름 |
| region | Yes | string | 리전 코드 | DB 서버가 설치된 리전 코드 |

## 요청

### 요청 바디

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| dbKind | Yes | String | mysql, mariadb | DB 종류 |
| host | Yes | String |  | DB 의 Instance ID |
| port | Yes | Integer |  | DB 포트 |
| user | Yes | String |  | 유저 아이디 |
| password | Yes | String |  | 비밀번호 |
| db | Yes | String |  | Database 이름 |
| charset | Yes | String |  | DB 의 character |
| keyField | Yes | String |  | 적용할 키칼럼 |
| indexTypeField | No | String |  | - 문서의 삭제, 추가, 업데이트 를 구별하기 위한 칼럼 사용하려는 DB 의 칼럼에는 "insert", "upsert", "update", "delete" 값만 들어가야 함 칼럼이 따로 지정이 안되어 있는경우 "upsert" 로 처리됨 |
| sql | Yes | String |  | DB query |
| connectTimeout | Yes | Int |  | connection 타이아웃, 단위 second |

## 응답

### 응답 Status

| HTTP Status | Desc |
| --- | --- |
| 200 | OK(조회 완료) |
| 400 | Bad Request |
| 401 | Unauthorized |
| 403 | Forbidden |
| 404 | Not Found |
| 500 | Internal Server Error |

## 예시

### 요청 예시

```
POST /CloudSearch/real/v1/domain/eeee/document/manage/db_upload/vpc
Host: cloudsearch.apigw.ntruss.com
accept:application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi
{
    "dbKind": "mysql",
    "host": "1111223",
    "port": 3306,
    "user": "root",
    "password": "alskdj",
    "db": "cloud_search",
    "charset": "utf8",
    "keyField": "id",
    "indexTypeField": "index_type",
    "sql": "select * from test_data",
    "connectTimeout": 4,
}
```

### Database 데이터 예시

| tid | first_name | last_name | gender | ip_address | index_type |
| --- | --- | --- | --- | --- | --- |
| 1 | Vasili | Godsmark | Male | 62.135.174.46 | upsert |
| 2 | Swen | Rumbelow | Male | 201.122.144.133 | delete |
| 3 | Davita | Ovington | Female | 57.80.83.212 | insert |
| 4 | Berri | Garwood | Female | 76.35.55.206 | update |

### 응답 예시

```
{"result":"ok"}
```