Supabase在线SQL编辑器执行TS向量列与索引操作时超时异常排查

问题背景 #

处理近15万行数据时，执行以下SQL添加生成式tsvector列并创建GIN索引：

alter table notices add column fts_en tsvector GENERATED ALWAYS AS (
   to_tsvector(
        'simple', 
        id || ' ' ||  
        coalesce(title->>'en', '') || ' ' ||  
        array_to_string_immutable( title_short,' '::text) 
     )  
    ) STORED;

create index gin_fts_en on notices using gin (fts_en);

Supabase在线编辑器返回错误：

upstream request timeout
但实际数据库中tsvector列已正确创建，GIN索引也正常生成。即使将PostgreSQL的statement_timeout设置为240s并验证生效：

alter role postgres set statement_timeout = '240s';

SELECT *
FROM   pg_settings
WHERE  name = 'statement_timeout';

在线编辑器仍会触发该超时错误。

原因分析 #

Supabase在线SQL编辑器的超时限制是前端/网关层独立设置的，和PostgreSQL数据库端的statement_timeout参数无关。当单条请求耗时超过编辑器的内置超时阈值（通常比数据库的statement_timeout短），编辑器就会返回upstream request timeout，但此时数据库端的操作可能仍在后台执行，最终完成。

解决方案 #

• 拆分SQL语句分步执行：先单独执行添加tsvector列的语句，等待执行完成后，再单独执行创建GIN索引的语句。拆分后每个操作的耗时会降低，大概率在编辑器的超时范围内。
• 使用Supabase CLI或本地数据库客户端：通过Supabase CLI（supabase sql命令）、psql或其他PostgreSQL客户端连接数据库执行操作，这些方式不受在线编辑器的超时限制。
• 优化索引创建效率：如果数据量持续增长，创建GIN索引时可以添加CONCURRENTLY关键字（仅适用于索引创建步骤），避免锁表同时让操作更平稳：

  create index concurrently gin_fts_en on notices using gin (fts_en);
  

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