search_path - Amazon Redshift
值 (粗體為預設值)描述範例

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

search_path

值 (粗體為預設值)

'$user', public, schema_names

以逗號分隔的現有結構描述名稱清單。如果有 '$user'，清單會取代和 SESSION_USER 相同名稱的結構描述；如果沒有，則會忽略清單。

描述

當以簡單名稱參考物件 (如資料表或函數) 且不提供結構描述元件時，指定搜尋結構描述的順序：

  • 外部結構描述和外部資料表不支援搜尋路徑。外部資料表必須以外部結構描述明確限定。

  • 建立物件時若沒有指定特定目標結構描述，系統會將物件置於搜尋路徑中列出的第一個結構描述。如果搜尋路徑是空的，系統會傳回錯誤。

  • 當其他結構描述中有同名的物件時，會使用搜尋路徑中先找到的那一個。

  • 物件若不在搜尋路徑裡的任何結構描述中，則只能使用它的完整名稱 (指定包含它的結構描述) 來參考它。

  • 一定會搜尋系統目錄結構描述 pg_catalog。如果路徑中有它，會依指定順序搜尋。如果沒有，會先搜尋它再搜尋路徑中的項目。

  • 一定會搜尋目前工作階段的暫時資料表結構描述 pg_temp_nnn (如果存在)。可以使用 alias pg_temp 將它明確列在路徑中。如果路徑中沒有它，則會先搜尋它 (甚至在 pg_catalog 之前)。不過，只會搜尋暫時結構描述中的關係名稱 (資料表、名稱)。不會搜尋函數名稱。

範例

下列範例會建立結構描述，ENTERPRISE並將 search_path 設定為新的結構描述。

create schema enterprise;
set search_path to enterprise;
show search_path;

 search_path
-------------
 enterprise
(1 row)

下列範例會將結構描述新增至ENTERPRISE預設 search_path。

set search_path to '$user', public, enterprise;
show search_path;

         search_path
-----------------------------
 "$user", public, enterprise
(1 row)

下列範例會將資料表新增至FRONTIER結構描述 ENTERPRISE。

create table enterprise.frontier (c1 int);

當在相同資料庫中建立資料表 PUBLIC.FRONTIER 且使用者未在查詢中指定結構描述名稱時，PUBLIC.FRONTIER 優先於 ENTERPRISE。FRONTIER

create table public.frontier(c1 int);
insert into enterprise.frontier values(1);
select * from frontier;

frontier
----
(0 rows)

select * from enterprise.frontier;

c1
----
1
(1 row)