search_path

这个变量指定当一个对象（表、数据类型、函数等）被用一个无模式限定的简单名称引用时，搜索该对象时的模式顺序。当在不同模式中有同名对象时，将使用第一个在搜索路径中被找到的对象。一个不属于搜索路径中任何一个模式的对象只能通过用限定名（带点号）指定包含它的模式来引用。

search_path 的值必须是一个逗号分隔的模式名列表。任何不是一个已有模式的名称，或者是一个用户不具有 USAGE 权限的模式，将被静默忽略。

如果列表项之一是特殊名 $user，则具有 CURRENT_USER 返回的名字的模式将取代它（如果有这样一个模式并且该用户有该模式的 USAGE 权限；如果没有，$user 会被忽略）。

系统目录模式 pg_catalog 总是被搜索，不管它是否在搜索路径中被提及。如果它在路径中被提及，那么它将被按照路径指定的顺序搜索。如果 pg_catalog 不在路径中，则它将在任何路径项之前被搜索。

同样，如果存在，当前会话的临时表模式 pg_temp_nnn 总是被搜索。可以通过使用别名 pg_temp 在路径中显式列出它。如果它没有列在路径中，则首先搜索它（甚至在 pg_catalog 之前）。然而，临时模式仅用于搜索关系（表、视图、序列等）和数据类型名称。它永远不会用于搜索函数或操作符名称。

当对象创建时没有指定一个特定目标模式，它们将被放置在 search_path 中第一个合法模式中。如果搜索路径为空将报告一个错误。

这个参数的默认值是"$user", public。这种设置支持共享使用数据库（用户没有私有模式，所有人共享使用 public）、每个用户拥有私有模式，以及二者的组合。还可以通过全局或针对每个用户修改默认搜索路径设置来获得其他效果。

更多有关模式处理的信息，请参考第 5.10 节。特别地，只有当数据库只有一个用户或者有少数的相互信任的用户时，默认配置是合适的。

搜索路径的当前有效值可以通过 SQL 函数 current_schemas 检查（见第 9.27 节）。它和检查 search_path 的值不太一样，因为 current_schemas 显示出现在 search_path 中的项如何被解析。