类型: | string |
默认: | "$user", public |
上下文: | user |
重新开始: | false |
这个变量指定当一个对象(表、数据类型、函数等)被用一个无模式限定的简单名称引用时,用于进行搜索该对象的模式顺序。当在不同模式中有同名对象时,将使用第一个在搜索路径中被找到的对象。一个不属于搜索路径中任何一个模式的对象只能通过用限定名(带点号)指定包含它的模式来引用。
search_path
的值必需是一个逗号分隔的模式名列表。任何不是一个已有模式的名称,或者是一个用户不具有USAGE
权限的模式,将被安静地忽略。
如果列表项之一是特殊名$user
,则具有SESSION_USER返回的名字的模式将取代它(如果有这样一个模式并且该用户有该模式的USAGE
权限;如果没有,$user
会被忽略)。
系统目录模式pg_catalog
总是被搜索,不管它是否在搜索路径中被提及。如果它在路径中被提及,那么它将被按照路径指定的顺序搜索。如果pg_catalog
不在路径中,则它将在任何路径项之前被搜索。
同样,当前会话的临时表模式pg_temp_nnn
也总是被搜索(如果存在)。它可以在路径中通过使用别名pg_temp
pg_temp显式列出。如果在路径中没有列出,那么会首先对它进行搜索(甚至是在pg_catalog
之前)。然而,临时模式只被用来搜索关系(表、视图、序列等)和数据类型名。它从不用于搜索函数或操作符名。
当对象创建时没有指定一个特定目标模式,它们将被放置在search_path
中第一个合法模式中。如果搜索路径为空将报告一个错误。
这个参数的缺省值是"$user", public
。这种设置支持一个数据库(其中没有用户拥有私有模式,并且所有人共享使用public
)、每个用户私有模式及其组合的共享使用。其它效果可以通过全局或者针对每个用户修改默认搜索路径设置获得。
更多有关方案处理的信息,请参考ddl-schemas。特别地,只有当数据库只有一个用户或者有少数的相互信任的用户时,默认配置是合适的。
搜索路径的当前有效值可以通过SQL函数current_schemas检查(见functions-info)。它和检查search_path
的值不太一样,因为current_schemas显示出现在search_path
中的项如何被解析。