Knative Docs项目数据库服务表结构设计与初始化

概述

本文档详细介绍了Knative Docs项目中数据库服务的表结构设计方案，包含完整的SQL建表语句以及示例数据初始化方法。该数据库设计旨在为Knative文档系统提供稳定可靠的数据存储支持。

核心表结构设计

文档主表(documents)

CREATE TABLE documents (
    id VARCHAR(36) PRIMARY KEY,
    title VARCHAR(255) NOT NULL,
    content TEXT,
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP,
    status ENUM('draft', 'published', 'archived') DEFAULT 'draft',
    author_id VARCHAR(36) NOT NULL,
    version INT DEFAULT 1
);

用户表(users)

CREATE TABLE users (
    id VARCHAR(36) PRIMARY KEY,
    username VARCHAR(50) UNIQUE NOT NULL,
    email VARCHAR(100) UNIQUE NOT NULL,
    password_hash VARCHAR(255) NOT NULL,
    role ENUM('admin', 'editor', 'viewer') DEFAULT 'viewer',
    created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    last_login TIMESTAMP
);

文档版本历史表(document_versions)

CREATE TABLE document_versions (
    id VARCHAR(36) PRIMARY KEY,
    document_id VARCHAR(36) NOT NULL,
    version_number INT NOT NULL,
    content TEXT NOT NULL,
    changed_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
    changed_by VARCHAR(36) NOT NULL,
    change_description TEXT,
    FOREIGN KEY (document_id) REFERENCES documents(id),
    FOREIGN KEY (changed_by) REFERENCES users(id),
    UNIQUE(document_id, version_number)
);

示例数据初始化

用户数据

INSERT INTO users (id, username, email, password_hash, role) VALUES
('550e8400-e29b-41d4-a716-446655440000', 'admin', '[e-mail]', '$2a$10$xJwL5v5zLJ3h5Vp5X5v5.e5v5e5v5e5v5e5', 'admin'),
('550e8400-e29b-41d4-a716-446655440001', 'editor1', '[e-mail]', '$2a$10$xJwL5v5zLJ3h5Vp5X5v5.e5v5e5v5e5v5e5', 'editor');

文档数据

INSERT INTO documents (id, title, content, author_id, status) VALUES
('660e8400-e29b-41d4-a716-446655440000', 'Knative入门指南', '本文介绍Knative的基本概念和使用方法...', '550e8400-e29b-41d4-a716-446655440001', 'published'),
('660e8400-e29b-41d4-a716-446655440001', '事件驱动架构设计', '深入解析事件驱动架构在Knative中的应用...', '550e8400-e29b-41d4-a716-446655440000', 'draft');

文档版本历史数据

INSERT INTO document_versions (id, document_id, version_number, content, changed_by, change_description) VALUES
('770e8400-e29b-41d4-a716-446655440000', '660e8400-e29b-41d4-a716-446655440000', 1, '初始版本内容...', '550e8400-e29b-41d4-a716-446655440001', '初次创建文档'),
('770e8400-e29b-41d4-a716-446655440001', '660e8400-e29b-41d4-a716-446655440000', 2, '更新后的内容...', '550e8400-e29b-41d4-a716-446655440000', '添加新功能介绍');

设计考虑因素

1. 数据完整性：通过外键约束确保关联数据的一致性
2. 版本控制：独立的版本历史表记录文档变更轨迹
3. 权限管理：用户角色区分实现细粒度访问控制
4. 性能优化：合理的索引设计和字段类型选择
5. 审计追踪：自动记录创建和修改时间戳

最佳实践建议

1. 定期备份数据库，特别是文档内容数据
2. 对大文本字段考虑使用专门的存储方案
3. 实现定期归档机制，避免版本历史表过大
4. 考虑添加全文索引以支持文档内容搜索
5. 对于生产环境，建议添加适当的数据库监控

该数据库设计为Knative文档系统提供了坚实的基础，既满足了当前功能需求，也为未来可能的扩展预留了空间。开发团队可根据实际业务需求在此基础上有针对性地进行调整和优化。