---
title: "DB Table 매핑 (VPC)"
slug: "analytics-cloudsearch-postdbuploadmappingvpc"
updated: 2026-04-23T08:56:10Z
published: 2026-04-23T09:02:33Z
---

> ## 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 Table 매핑 (VPC)

user의 db에 접근하여 table 정보를 가져온후, cloud search의 schema에 맞게 매핑하여 반환합니다.

```http
POST https://cloudsearch.apigw.ntruss.com/CloudSearch/real/v1/db_upload/mapping/vpc
```

## 요청<a name="요청"></a>

### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명 | 필수 여부 | 타입   | 제약 사항 | 설명                                   |
|-------------|-----------|--------|----------|----------------------------------------|
| region      | Yes       | string | 리전 코드 | DB 서버가 설치된 리전 코드 |

### 요청 바디<a name="요청바디"></a>

| 파라미터명 | 필수 여부 | 타입   | 제약 사항 | 설명                                   |
|-------------|-----------|--------|----------|----------------------------------------|
| 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 |
| table  | Yes | String | | 테이블 |
| connectTimeout  | Yes | Int | | connection 타임아웃, 단위 second |

## 응답<a name="응답"></a>

### 응답 Status<a name="응답Status"></a>

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

### 응답 body<a name="응답body"></a>

[Schema](/docs/common-apidatatype-csschema)

## 예시<a name="예시"></a>

### 요청 예시<a name="요청예시"></a>

```http
POST /CloudSearch/real/v1/db_upload/table/vpc
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": "1112223",
  "port": 23306,
  "user": "root",
  "password": "Cloudsearch",
  "db": "test_db",
  "charset": "utf8",
  "connectTimeout": 30,
  "table": "test_data"
}
```

### 응답 예시<a name="응답예시"></a>
```json
{
  "document": {
    "sections": [
      {
        "name": "tid"
      },
      {
        "name": "first_name"
      },
      {
        "name": "last_name"
      },
      {
        "name": "gender"
      },
      {
        "name": "ip_address"
      },
      {
        "name": "index_type"
      }
    ],
    "indexes": [],
    "primarySectionName": "tid"
  }
}
```