ccdi/assets/database-docs/database-index-validation.md

# 数据库唯一索引验证报告

## 验证日期

2026-02-08

## 验证目的

确认中介信息导入功能所需的数据库唯一索引已正确配置,为 `INSERT ... ON DUPLICATE KEY UPDATE` 语句提供基础支持。

## 涉及表

- `ccdi_biz_intermediary` (个人中介表)
- `ccdi_enterprise_base_info` (实体中介表)

---

## 检查结果

### 1. 个人中介表 (ccdi_biz_intermediary)

#### 检查项: person_id 唯一索引

**检查前状态:**

- 存在普通索引 `idx_person_id` (Non_unique = 1)
- ❌ 不满足唯一性要求

**执行操作:**

```sql
-- 删除原有普通索引
ALTER TABLE ccdi_biz_intermediary DROP INDEX idx_person_id;

-- 创建唯一索引
ALTER TABLE ccdi_biz_intermediary ADD UNIQUE KEY uk_person_id (person_id);
```

**检查后状态:**

- ✅ 唯一索引 `uk_person_id` 已创建
- Non_unique: 0
- Column_name: person_id
- Index_type: BTREE
- Cardinality: 1745

**最终索引状态:**

- ✅ PRIMARY KEY: `biz_id`
- ✅ UNIQUE KEY: `uk_person_id` (Non_unique = 0)
- ✅ INDEX: `idx_name` (普通索引)
- ✅ INDEX: `idx_mobile` (普通索引)

**完整索引列表:**

```sql
SHOW INDEX FROM ccdi_biz_intermediary;
```

| Key_name     | Column_name | Non_unique | Index_type |
|--------------|-------------|------------|------------|
| PRIMARY      | biz_id      | 0          | BTREE      |
| uk_person_id | person_id   | 0          | BTREE      |
| idx_name     | name        | 1          | BTREE      |
| idx_mobile   | mobile      | 1          | BTREE      |

---

### 2. 实体中介表 (ccdi_enterprise_base_info)

#### 检查项: social_credit_code 主键

**检查前状态:**

- ✅ `social_credit_code` 已为 PRIMARY KEY
- 字段类型: varchar(50)
- 约束: NOT NULL
- 引擎: InnoDB

**表结构确认:**

```sql
SHOW CREATE TABLE ccdi_enterprise_base_info;
```

**结论:**

- ✅ 无需修改,已满足要求

---

## 总结

### 验证结论

✅ **所有必需的唯一索引/主键均已正确配置**

### 配置详情

| 表名                        | 字段                 | 约束类型        | 状态    |
|---------------------------|--------------------|-------------|-------|
| ccdi_biz_intermediary     | person_id          | UNIQUE KEY  | ✅ 已创建 |
| ccdi_enterprise_base_info | social_credit_code | PRIMARY KEY | ✅ 已存在 |

### 对导入功能的影响

- ✅ `INSERT ... ON DUPLICATE KEY UPDATE` 现在可以正确工作
- ✅ 个人中介数据根据 `person_id` 自动去重和更新
- ✅ 实体中介数据根据 `social_credit_code` 自动去重和更新

### 注意事项

1. **唯一索引约束:** 导入数据时,如果 `person_id` 重复,将自动执行更新操作
2. **性能影响:** 唯一索引会在插入和更新时进行唯一性检查,对性能有轻微影响
3. **数据完整性:** 唯一索引确保了数据的唯一性,防止重复数据

---

## 执行人员

Claude Code AI Assistant

## 审核状态

✅ 已完成验证并创建唯一索引
✅ 文档已提交到 git (commit: a6a872b)