Supabase 数据库初始化指南

本文档说明如何将 SQL 脚本导入到本地 Docker 部署的 Supabase 中。

准备工作

确保你的 Supabase Docker 容器正在运行：

docker ps --filter "name=supabase"

方法一：通过 Supabase Studio (推荐)

打开 Supabase Studio

在浏览器中访问：http://localhost:54323

注意：如果是通过 Kong 代理，可能是 http://localhost:8000
进入 SQL 编辑器

点击左侧菜单的 SQL Editor
执行建表脚本
- 新建一个 Query
- 复制 migrations/001_create_tables.sql 的内容
- 点击 Run 执行
执行种子数据脚本
- 新建另一个 Query
- 复制 migrations/002_seed_data.sql 的内容
- 点击 Run 执行
创建 Storage Bucket
- 点击左侧菜单的 Storage
- 点击 New bucket
- 输入名称：avatars
- 勾选 Public bucket
- 点击 Create bucket

方法二：通过命令行 (psql)

连接到数据库

# 获取数据库连接信息
docker exec supabase-db env | grep POSTGRES

# 连接数据库 (默认密码在 .env 文件中)
docker exec -it supabase-db psql -U postgres -d postgres

执行 SQL 脚本

# 从容器外部执行
cat supabase/migrations/001_create_tables.sql | docker exec -i supabase-db psql -U postgres -d postgres
cat supabase/migrations/002_seed_data.sql | docker exec -i supabase-db psql -U postgres -d postgres

方法三：通过 Supabase API

# 设置环境变量
SUPABASE_URL="http://localhost:8000"
SERVICE_KEY="你的 service_role key"

# 创建 Storage bucket
curl -X POST "$SUPABASE_URL/storage/v1/bucket" \
  -H "Authorization: Bearer $SERVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id": "avatars",
    "name": "avatars",
    "public": true,
    "file_size_limit": 5242880,
    "allowed_mime_types": ["image/png", "image/jpeg", "image/webp", "image/gif"]
  }'

验证数据

初始化完成后，可以在 Supabase Studio 中验证：

Table Editor - 查看表结构和数据
API Docs - 查看自动生成的 API 文档

表结构说明

表名	说明
`categories`	分类筛选，用于 Discovery 页面
`tags`	角色标签
`characters`	AI 角色信息，包含 AI 配置
`character_tags`	角色-标签关联
`characters_with_tags`	视图，包含完整的角色信息和标签

初始数据

7 个分类（全部、温柔治愈、主导强势、反差/猎奇、语音陪聊、场景扮演、会员限定）
11 个标签
4 个示例角色（Eva-09, Commander V, Yuki, Secret X）

常见问题

Q: 执行 SQL 时提示权限不足？

确保使用 postgres 用户或具有足够权限的用户执行。

Q: 视图查询返回空数据？

检查 characters 表中的 is_active 字段是否为 true。

Q: Storage 上传失败？

确保已创建 avatars bucket 并设置为公开访问。

3.0 KiB Raw Blame History Unescape Escape