PostgreSQL循环中执行INSERT报错[42P01]：关系test_artist不存在

问题场景 #

需要向test_artist表插入3.5亿条数据，为避免一次性插入的性能压力，将INSERT语句放入PL/pgSQL的WHILE循环中分批插入（每次约100万条）。单独测试WHILE循环逻辑和单条INSERT语句均正常，但二者结合执行时抛出错误：

SQL Error [42P01]: ERROR: relation "test_artist" does not exist
Where: PL/pgSQL function inline_code_block line 6 at SQL statement

已确认test_artist表确实存在，简化后的测试代码如下：

do $$
declare 
   counter integer := 0;
begin
   while counter < 5 loop
    insert into test_artist (record_id, name)
    values('2627', 'el tri');
      counter := counter + 1;
   end loop;
end$$;

可能原因及解决办法 #

1. 未指定表的所属Schema #

PL/pgSQL块的执行上下文搜索路径可能与单独执行INSERT时不同，导致找不到表。解决办法是使用完整的表名（包含Schema）：

do $$
declare 
   counter integer := 0;
begin
   while counter < 5 loop
    insert into public.test_artist (record_id, name) -- 替换为实际的Schema名
    values('2627', 'el tri');
      counter := counter + 1;
   end loop;
end$$;

2. 表名大小写不匹配 #

如果创建表时使用了双引号（例如CREATE TABLE "Test_Artist" (...)），PostgreSQL会保留表名的大小写，此时引用表必须带双引号：

do $$
declare 
   counter integer := 0;
begin
   while counter < 5 loop
    insert into "Test_Artist" (record_id, name) -- 与创建时的表名大小写一致并加双引号
    values('2627', 'el tri');
      counter := counter + 1;
   end loop;
end$$;

3. 执行上下文搜索路径问题 #

可以在PL/pgSQL块开头显式设置搜索路径，确保包含表所在的Schema：

do $$
declare 
   counter integer := 0;
begin
   set search_path to public, your_schema_name; -- 替换为实际的Schema列表
   while counter < 5 loop
    insert into test_artist (record_id, name)
    values('2627', 'el tri');
      counter := counter + 1;
   end loop;
end$$;

4. 权限不足 #

虽然表存在，但执行PL/pgSQL块的用户在函数执行上下文可能没有该表的INSERT权限，可执行以下语句授权：

GRANT INSERT ON test_artist TO your_execution_user; -- 替换为实际执行用户

额外优化建议 #

插入3.5亿条数据时，单条循环插入效率极低，建议改用批量插入提升性能，示例代码如下：

do $$
declare 
   batch_size integer := 1000000; -- 每批插入100万条
   total_records bigint := 350000000;
   inserted bigint := 0;
begin
   while inserted < total_records loop
      insert into public.test_artist (record_id, name)
      select 
         ('2627' || (inserted + generate_series(1, least(batch_size, total_records - inserted))))::text,
         'el tri'
      from generate_series(1, least(batch_size, total_records - inserted));
      
      inserted := inserted + least(batch_size, total_records - inserted);
      commit; -- 每批提交一次，避免事务过大
   end loop;
end$$;

内容的提问来源于stack exchange，提问作者Ctrl Alt Elite