---
title: "DB Table 매핑 "
slug: "analytics-cloudsearch-postdbuploadmapping"
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 매핑 

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

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

## 요청

### 요청 바디

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| --- | --- | --- | --- | --- |
| 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 |
| table | Yes | String |  | 테이블 |
| 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 |

### 응답 body

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

## 예시

### 요청 예시

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

### 응답 예시

```
{
  "document": {
    "sections": [
      {
        "name": "tid"
      },
      {
        "name": "first_name"
      },
      {
        "name": "last_name"
      },
      {
        "name": "gender"
      },
      {
        "name": "ip_address"
      },
      {
        "name": "index_type"
      }
    ],
    "indexes": [],
    "primarySectionName": "tid"
  }
}
```