使用sqlc生成代码时，如何处理跨Schema引用的JOIN语句？

1. 配置文件中显式加载所有Schema #

sqlc需要明确知晓所有涉及的Schema结构，所以在sqlc.yaml（或sqlc.json）里，把所有Schema文件/目录都列在schema字段下，确保sqlc能一次性加载全量Schema定义。示例配置：

version: "2"
sql:
  - schema: 
      - "schemas/auth/*.sql"   # 第一个Schema的文件目录
      - "schemas/store/*.sql"  # 第二个Schema的文件目录
    queries: "queries/*.sql"
    engine: "postgresql"
    gen:
      go:
        package: "db"
        out: "./internal/db"

2. 查询中强制使用完整Schema前缀 #

编写JOIN语句时，每个表都必须带上所属的Schema前缀，不能省略。比如：

-- name: GetUserWithOrders :many
SELECT u.id, u.email, o.order_number, o.amount
FROM auth.users u
JOIN store.orders o ON u.id = o.user_id
WHERE u.id = $1;

这样sqlc解析时能直接定位到对应Schema下的表，不会出现“schema not found”的错误。

3. 确保Schema文件定义完整 #

每个Schema对应的SQL文件里，必须包含该Schema下所有表的完整CREATE TABLE语句，且明确指定Schema前缀。比如auth/users.sql里要写：

CREATE TABLE auth.users (
  id BIGSERIAL PRIMARY KEY,
  email TEXT UNIQUE NOT NULL,
  created_at TIMESTAMP NOT NULL DEFAULT NOW()
);

不能只写CREATE TABLE users (...)，否则sqlc无法关联到正确的Schema。

4. 避免Schema依赖冲突（可选） #

如果不同Schema下有同名表，更要注意前缀的使用，避免sqlc解析混淆。另外，不要在查询中依赖数据库的search_path设置，sqlc解析时不会读取数据库的运行时配置，必须显式指定Schema。

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