128 lines
3.3 KiB
Markdown
128 lines
3.3 KiB
Markdown
# 数据库重复对象修复说明
|
||
|
||
## 问题描述
|
||
|
||
在重新运行 `video_system_database.sql` 时，遇到了 `relation "idx_comments_parent" already exists` 错误。这是因为数据库中已经存在了某些表、索引或其他对象，重复创建会导致错误。
|
||
|
||
## 修复方案
|
||
|
||
### 1. 添加 `IF NOT EXISTS` 子句
|
||
|
||
为所有可能重复的数据库对象添加了 `IF NOT EXISTS` 子句，使脚本可以安全地重复运行：
|
||
|
||
#### 表创建
|
||
```sql
|
||
CREATE TABLE IF NOT EXISTS ak_video_danmakus (...)
|
||
CREATE TABLE IF NOT EXISTS ak_user_interactions (...)
|
||
CREATE TABLE IF NOT EXISTS ak_content_comments (...)
|
||
-- ... 所有其他表
|
||
```
|
||
|
||
#### 索引创建
|
||
```sql
|
||
CREATE INDEX IF NOT EXISTS idx_comments_parent ON ak_content_comments(parent_id);
|
||
CREATE INDEX IF NOT EXISTS idx_danmakus_content_time ON ak_video_danmakus(content_id, time_point);
|
||
-- ... 所有其他索引
|
||
```
|
||
|
||
#### 列添加
|
||
```sql
|
||
ALTER TABLE ak_contents
|
||
ADD COLUMN IF NOT EXISTS content_type VARCHAR(20) DEFAULT 'article',
|
||
ADD COLUMN IF NOT EXISTS video_url TEXT,
|
||
-- ... 所有其他列
|
||
```
|
||
|
||
### 2. 修复字段引用错误
|
||
|
||
#### 弹幕表字段名修正
|
||
- 修正了 RPC 函数中的字段名：`content` → `text`
|
||
- 添加了 `user_name` 字段的自动填充
|
||
|
||
#### 时长字段引用修正
|
||
- 修正了播放记录函数中的时长字段引用
|
||
- 根据内容类型动态选择 `video_duration` 或 `audio_duration`
|
||
|
||
### 3. 增强的 RPC 函数
|
||
|
||
```sql
|
||
-- 弹幕插入函数 - 现在包含用户名自动填充
|
||
CREATE OR REPLACE FUNCTION insert_danmu_with_validation(...)
|
||
|
||
-- 播放记录函数 - 现在正确处理不同媒体类型的时长
|
||
CREATE OR REPLACE FUNCTION record_play_progress_with_validation(...)
|
||
```
|
||
|
||
## 现在的优势
|
||
|
||
### ✅ 幂等性（Idempotent）
|
||
- 脚本可以安全地多次运行
|
||
- 不会因为对象已存在而失败
|
||
- 支持增量更新和重新部署
|
||
|
||
### ✅ 错误处理
|
||
- 自动处理重复对象创建
|
||
- 提供清晰的错误信息
|
||
- 支持部分失败恢复
|
||
|
||
### ✅ 向后兼容
|
||
- 保持所有现有功能
|
||
- 不破坏已有数据
|
||
- 支持渐进式迁移
|
||
|
||
## 使用建议
|
||
|
||
### 部署流程
|
||
1. **第一次部署**：创建所有新对象
|
||
2. **更新部署**：只创建不存在的对象，跳过已存在的
|
||
3. **修复部署**：可以安全地重新运行整个脚本
|
||
|
||
### 开发流程
|
||
```bash
|
||
# 可以安全地重复运行
|
||
psql -f video_system_database.sql
|
||
|
||
# 或者在 Supabase 中直接粘贴执行
|
||
# 不需要担心重复执行问题
|
||
```
|
||
|
||
### 监控建议
|
||
- 关注 RPC 函数的执行日志
|
||
- 监控数据一致性
|
||
- 验证索引性能
|
||
|
||
## 测试验证
|
||
|
||
### 基础功能测试
|
||
```sql
|
||
-- 测试弹幕插入
|
||
SELECT insert_danmu_with_validation(
|
||
'content-uuid-here'::UUID,
|
||
'测试弹幕',
|
||
10.5
|
||
);
|
||
|
||
-- 测试播放记录
|
||
SELECT record_play_progress_with_validation(
|
||
'content-uuid-here'::UUID,
|
||
30.0,
|
||
5.0
|
||
);
|
||
```
|
||
|
||
### 重复执行测试
|
||
```sql
|
||
-- 这些命令应该不会报错，即使多次执行
|
||
CREATE INDEX IF NOT EXISTS idx_test ON ak_video_danmakus(id);
|
||
CREATE TABLE IF NOT EXISTS ak_test_table (id UUID);
|
||
```
|
||
|
||
## 未来扩展
|
||
|
||
脚本现在具备了良好的可维护性基础：
|
||
- 新增表或索引时记得使用 `IF NOT EXISTS`
|
||
- 新增列时使用 `ADD COLUMN IF NOT EXISTS`
|
||
- RPC 函数使用 `CREATE OR REPLACE FUNCTION`
|
||
|
||
这确保了系统的稳定性和可扩展性。
|