# 生成列映射

为 MatrixOne 目标表生成导出列映射建议。

```text
POST https://moi.matrixorigin.cn/newmoi/connectors/mo/column/mapping
```

## 调用前准备

先确认目标 MatrixOne 连接器、数据库和表。准备个人访问令牌、工作区 ID 和连接器 ID。

## 请求体

| 参数 | 类型 | 是否必填 | 说明 |
| --- | --- | --- | --- |
| `connector_id` | string | 是 | MatrixOne 连接器 ID。 |
| `database` | string | 是 | 目标数据库名称。 |
| `table` | string | 是 | 目标表名称。 |
| `export_columns` | object | 是 | 源列名与目标列名的映射。 |

## 请求示例

```bash
curl -X POST "https://moi.matrixorigin.cn/newmoi/connectors/mo/column/mapping" \
  -H "X-API-Key: $AI_STUDIO_API_KEY" \
  -H "X-Workspace-ID: $WORKSPACE_ID" \
  -H "Content-Type: application/json" \
  -d "{
    \"connector_id\": \"$CONNECTOR_ID\",
    \"database\": \"analytics\",
    \"table\": \"orders\",
    \"export_columns\": {\"source_id\": \"id\"}
  }"
```

## 成功响应

成功时返回列映射建议。使用建议配置导出任务前，请核对源列和目标列的实际语义。

## 错误响应

连接器、数据库、表或列映射无效时，检查请求体后重试。