如何使用Flutter SupabaseClient查询多表关联数据

需求：从表中获取活动列表，同时包含主办方信息和参会者列表，关联规则为events.host_id匹配user.user_id、events.event_id匹配attendees.event_id。

表结构 #

user(user_id, name, email)
events(event_id, event_name, host_id) -- host_id 为主办方的user_id
attendees(event_id, user_id) -- event_id关联events.event_id，user_id关联user.user_id

已尝试的代码及问题 #

1. 仅返回活动和主办方信息，缺少参会者列表：

final response = await _supabase
    .from('events')
    .select('*, $user!inner(*)')
    .order(CREATED_AT_COLUMN, ascending: ascending)
    .execute();

2. 返回参会者数据，但活动和用户信息嵌套在attendees结构内，不符合预期：

final response = await _supabase
    .from('attendees')
    .select('*, $user!inner(*), $events!inner(*)')
    .execute();

3. 未明确关联规则导致结果不符合预期：

final response = await _supabase
    .from('events')
    .select('*, $user!inner(*), $attendees!inner(*)')
    .execute();

预期输出格式 #

{
  "event_id": "xxx",
  "event_name": "xxx",
  ...
  "host": {
    "user_id": "host_id",
    "name": "host_name",
    ...
  },
  "attendees": [
    {
      "event_id": "xxx",
      "user": {
        "user_id": "user_id",
        "name": "attendee_name",
        ...
      }
    },
    ...
  ]
}

解决方案 #

由于user表与events、attendees都存在关联，需要明确指定关联关系，避免查询逻辑混淆。

方案1：使用外键约束名称指定关联

final response = await _supabase
    .from('events')
    .select('''
      *,
      user!events_host_id_fkey(user_id, name, email), -- 关联主办方（对应events.host_id→user.user_id的外键）
      attendees!inner(*, user!attendees_user_id_fkey(user_id, name, email)) -- 关联参会者及对应用户信息
    ''')
    .order(CREATED_AT_COLUMN, ascending: ascending)
    .execute();

注：events_host_id_fkey和attendees_user_id_fkey是表关联的外键名称，可在Supabase控制台的表约束详情中查看。

方案2：自定义关联规则并设置别名

直接指定字段匹配规则，同时给主办方设置别名host，让返回结构更贴合预期：

final response = await _supabase
    .from('events')
    .select('''
      *,
      host:user!inner(user_id=host_id) (user_id, name, email), -- 匹配主办方：user.user_id = events.host_id
      attendees!inner(*) (
        event_id,
        attendee:user!inner(user_id=user_id) (user_id, name, email) -- 匹配参会者用户信息
      )
    ''')
    .order(CREATED_AT_COLUMN, ascending: ascending)
    .execute();

以上两种方式都能返回包含活动、主办方、参会者列表的结构，其中方案2的返回字段名更贴近你预期的格式。

内容的提问来源于stack exchange，提问作者Mahesh Jamdade