---
title: "DB upload実行"
slug: "analytics-cloudsearch-postdbupload"
updated: 2026-09-17T09:57:29Z
published: 2026-09-17T09:57:29Z
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実行

ドメインに対しデータベースアップロード機能を実行します。

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

## リクエスト

### リクエストパラメータ

| パラメータ名 | 必須有無 | タイプ | 制約事項 | 説明 |
| --- | --- | --- | --- | --- |
| name | Yes | string | 作成済みのドメイン名 | 自動補完設定履歴を照会するドメイン名 |

## リクエスト

### リクエストボディ

| パラメータ名 | 必須有無 | タイプ | 制約事項 | 説明 |
| --- | --- | --- | --- | --- |
| dbKind | Yes | String | mysql, mariadb | データベースの種類 |
| host | Yes | String |  | データベースのIP |
| port | Yes | Integer |  | データベースのポート |
| user | Yes | String |  | ユーザーID |
| password | Yes | String |  | パスワード |
| db | Yes | String |  | データベース名 |
| charset | Yes | String |  | データベースのキャラクターセット |
| keyField | Yes | String |  | 適用するキーカラム |
| indexTypeField | Yes | String |  | 適用するインデックスカラム |
| sql | Yes | String |  | DB query |
| connectTimeout | Yes | Int |  | 接続タイムアウト、単位は秒 |

## レスポンス

### レスポンス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
accept: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,
}
```

### データベースの例

| 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"}
```