在高斯数据库（GaussDB）中，search_path 是一个非常重要的参数，用于控制 SQL 查询时查找对象（如表、函数等）的搜索路径，它决定了在未显式指定 schema 的情况下，查询表时系统会按照哪些 schema 依次查找。
查询当前的 search_path
你可以使用以下 SQL 语句来查询当前的 search_path：
SHOW search_path;
执行该语句后，将返回当前会话使用的 schema 列表，例如：
"$user", public, pg_catalog
表示优先查找与用户同名的 schema，然后是 public schema，最后是系统表所在的 pg_catalog。
| 配置项 | 含义 |
|---|---|
"$user" | 当前用户同名的 schema（如果存在） |
public | 默认公共 schema，所有用户都可以访问 |
pg_catalog | 系统内置对象所在的 schema，比如系统视图、函数等 |
✅ "$user" 的含义
🔍 说明：
$user是一个特殊的 关键字，表示 当前连接用户同名的 schema。- 如果这个 schema 存在，则优先从该 schema 中查找对象。
- 如果不存在，则跳过该条目，继续查找下一个 schema（即
public）。
🧠 示例：
假设当前登录数据库的用户是 test_user，那么：
$user就代表test_user这个 schema。- 如果存在名为
test_user.test_table的表，则执行SELECT * FROM test_table;会访问这个表。 - 如果不存在，则转向
publicschema 查找test_table。
** 注意: **
当你执行类似
SELECT * FROM table_name的语句时，如果未指定 schema 名称（即schema_name.table_name），GaussDB 将根据search_path中定义的顺序查找匹配的表。如果多个 schema 中存在同名表，则只会使用第一个找到的表。
✅ 如何修改 search_path
你可以通过以下方式修改：
- 临时修改当前会话的
search_path
SET LOCAL search_path TO schema1, schema2, public;
或者
set search_path = schema1；
- 修改特定用户的默认
search_path
ALTER USER username SET search_path TO schema1, public;
- 修改数据库级别的默认
search_path
ALTER DATABASE dbname SET search_path TO schema1, public;
建议
- 在生产环境中，推荐始终使用
schema_name.table_name显式指定 schema，以避免因search_path设置不同导致查询结果不一致的问题。 - 如果多人协作开发，了解并统一
search_path设置有助于减少歧义和潜在错误。
