---
title: "DB upload 실행"
slug: "analytics-cloudsearch-postdbupload"
tags: ["Cloud Search"]
updated: 2026-07-23T09:04:38Z
published: 2026-07-23T09:04:38Z
canonical: "api.ncloud-docs.com/analytics-cloudsearch-postdbupload"
---

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

# DB upload 실행

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

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

## 요청

### 요청 파라미터

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| name | Yes | string | 생성되어져 있는 Domain 이름 | Domain 이름 |

## 요청

### 요청 바디

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| dbKind | Yes | String | mysql, mariadb | DB 종류 |
| host | Yes | String |  | DB 의 IP |
| 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
Host: cloudsearch.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: cDwtHuQeGmwWyNmwlN6XIGA66zge4iMXvfoDQNna05g=
x-ncp-apigw-timestamp: 1545817618751
x-ncp-iam-access-key: teGTwtcSEGA7fu28BGGi
{
    "dbKind": "mysql",
    "host": "2.2.2.2",
    "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"}
```