137 lines
3.3 KiB
Markdown
137 lines
3.3 KiB
Markdown
# PostgreSQL 约束修复说明
|
|
|
|
## 问题描述
|
|
|
|
在原始的 `video_system_database.sql` 中，使用了 PostgreSQL 不支持的 CHECK 约束语法：
|
|
|
|
```sql
|
|
CONSTRAINT chk_play_media_type CHECK (
|
|
EXISTS (
|
|
SELECT 1 FROM ak_contents
|
|
WHERE id = content_id
|
|
AND content_type IN ('video', 'audio')
|
|
)
|
|
)
|
|
```
|
|
|
|
PostgreSQL 不允许在 CHECK 约束中使用子查询，这会导致部署时报错。
|
|
|
|
## 修复方案
|
|
|
|
### 1. 移除了有问题的 CHECK 约束
|
|
|
|
移除了以下表中的 CHECK 约束：
|
|
- `ak_video_play_records.chk_play_media_type`
|
|
- `ak_image_tags.chk_image_tag_type`
|
|
- `ak_image_view_records.chk_image_view_type`
|
|
|
|
### 2. 应用层校验替代方案
|
|
|
|
创建了带内容类型校验的 RPC 函数：
|
|
|
|
#### 弹幕插入函数
|
|
```sql
|
|
SELECT insert_danmu_with_validation(
|
|
content_id,
|
|
'弹幕内容',
|
|
time_position,
|
|
color,
|
|
font_size,
|
|
position_type
|
|
);
|
|
```
|
|
|
|
#### 图片标签插入函数
|
|
```sql
|
|
SELECT insert_image_tag_with_validation(
|
|
content_id,
|
|
'标签名称',
|
|
'user', -- 标签类型
|
|
confidence -- 置信度（可选）
|
|
);
|
|
```
|
|
|
|
#### 播放记录函数
|
|
```sql
|
|
SELECT record_play_progress_with_validation(
|
|
content_id,
|
|
play_position,
|
|
play_duration,
|
|
device_type,
|
|
resolution,
|
|
quality
|
|
);
|
|
```
|
|
|
|
## 数据完整性保证
|
|
|
|
### 1. 外键约束
|
|
所有相关表都有适当的外键约束，确保引用完整性。
|
|
|
|
### 2. 应用层校验
|
|
通过 RPC 函数在应用层进行内容类型校验：
|
|
- 弹幕：仅限 `video` 和 `audio` 内容
|
|
- 播放记录：仅限 `video` 和 `audio` 内容
|
|
- 图片标签：仅限 `image` 内容
|
|
- 图片浏览记录：仅限 `image` 内容
|
|
|
|
### 3. 触发器机制
|
|
统计更新触发器仍然有效，自动维护内容统计数据。
|
|
|
|
## 使用建议
|
|
|
|
### 前端调用示例
|
|
|
|
```typescript
|
|
// 弹幕插入
|
|
const { data: danmuId } = await supabase.rpc('insert_danmu_with_validation', {
|
|
p_content_id: contentId,
|
|
p_content: danmuText,
|
|
p_time_position: currentTime,
|
|
p_color: '#FFFFFF',
|
|
p_font_size: 16
|
|
});
|
|
|
|
// 图片标签添加
|
|
const { data: tagId } = await supabase.rpc('insert_image_tag_with_validation', {
|
|
p_content_id: imageId,
|
|
p_tag_name: tagName,
|
|
p_tag_type: 'user'
|
|
});
|
|
|
|
// 播放进度记录
|
|
const { data: recordId } = await supabase.rpc('record_play_progress_with_validation', {
|
|
p_content_id: videoId,
|
|
p_play_position: currentTime,
|
|
p_play_duration: totalDuration,
|
|
p_device_type: 'mobile'
|
|
});
|
|
```
|
|
|
|
### 错误处理
|
|
|
|
RPC 函数会抛出明确的错误信息：
|
|
- `内容不存在`
|
|
- `只有视频和音频内容支持弹幕功能`
|
|
- `只有图片内容支持标签功能`
|
|
- `只有视频和音频内容支持播放记录`
|
|
|
|
### 直接插入的风险
|
|
|
|
如果绕过 RPC 函数直接插入数据，可能会导致数据不一致：
|
|
- 图片内容可能被插入弹幕记录
|
|
- 视频内容可能被插入图片标签
|
|
|
|
建议始终使用提供的 RPC 函数进行数据操作。
|
|
|
|
## 部署验证
|
|
|
|
修复后的数据库可以正常部署到 Supabase 或任何 PostgreSQL 实例，不会出现约束相关的错误。
|
|
|
|
## 下一步
|
|
|
|
1. 部署更新后的数据库结构
|
|
2. 在前端代码中使用 RPC 函数替代直接的表插入
|
|
3. 测试各种内容类型的操作，确保校验正常工作
|
|
4. 可选：添加更多业务逻辑校验（如敏感词过滤、权限检查等）
|