PostgreSQL 系統(tǒng)信息函數(shù)和運算符

current_catalog → name

current_database () → name

返回當(dāng)前數(shù)據(jù)庫的名稱。(在SQL標準中數(shù)據(jù)庫被稱為“catalogs”，因此current_catalog是該標準的拼寫方式。)

current_query () → text

返回當(dāng)前所執(zhí)行查詢的文本，由客戶端提交的(可能包含一個以上的語句)。

current_role → name

這個等同于 current_user。

current_schema → name

current_schema () → name

返回在搜索路徑中的第一個模式的名稱(如果搜索路徑為空則返回空值)。 這個模式將用于沒有指定目標模式就創(chuàng)建的任何表或其他已命名對象。

current_schemas ( include_implicit boolean ) → name[]

返回當(dāng)前在有效搜索路徑中的所有模式的名稱的數(shù)組，以優(yōu)先級順序。 (當(dāng)前 search_path設(shè)置中與已存在的、可搜索模式不相符的項將被省略。) 如果布爾參數(shù)為true，則類似pg_catalog的隱式搜索的系統(tǒng)模式將包含在結(jié)果中。

current_user → name

返回當(dāng)前執(zhí)行上下文的用戶名。

inet_client_addr () → inet

返回當(dāng)前客戶端的IP地址，如果當(dāng)前連接是通過Unix-域套接字則返回NULL

inet_client_port () → integer

返回當(dāng)前客戶端的IP端口號，如果當(dāng)前連接是通過Unix-域套接字則返回NULL。

inet_server_addr () → inet

返回服務(wù)器接受當(dāng)前連接的IP地址，如果當(dāng)前連接是通過Unix-域套接字則返回NULL。

inet_server_port () → integer

返回服務(wù)器接受當(dāng)前連接的IP端口號，如果當(dāng)前連接是通過Unix-域套接字則返回NULL。

pg_backend_pid () → integer

返回附加到當(dāng)前會話的服務(wù)器進程的進程ID。

pg_blocking_pids ( integer ) → integer[]

返回阻止服務(wù)器進程的會話的進程ID數(shù)組，該進程ID與指定的進程ID一起獲取鎖定，如果沒有這樣的服務(wù)器進程或者沒有被阻塞，則返回一個空數(shù)組。

如果一個服務(wù)器進程持有一個與被阻塞進程的鎖請求沖突的鎖(硬阻塞)，或者正在等待一個與被阻塞進程的鎖請求沖突并且在等待隊列中位于其前面的鎖(軟阻塞)，那么這個服務(wù)器進程就會阻塞另一個服務(wù)器進程。 當(dāng)使用并行查詢時結(jié)果總是列出客戶端可見的進程ID(即pg_backend_pid的結(jié)果)，即使實際的鎖是由子工作進程持有或等待的。 因此，結(jié)果中可能存在重復(fù)的pid。還要注意當(dāng)準備好的事務(wù)持有沖突鎖時，它將用零進程ID表示。

頻繁調(diào)用這個函數(shù)可能會對數(shù)據(jù)庫性能產(chǎn)生一些影響，因為它需要在短時間內(nèi)獨占訪問鎖管理器的共享狀態(tài)。

pg_conf_load_time () → timestamp with time zone

返回服務(wù)器配置文件最后加載的時間。如果當(dāng)前會話當(dāng)時是活躍的，那么這將是會話本身重新讀取配置文件的時間(因此在不同的會話中讀取會稍有不同)。 否則，就是postmaster進程重新讀取配置文件的時間。

pg_current_logfile ( [ text ] ) → text

返回日志采集器當(dāng)前使用的日志文件的路徑名。該路徑包括log_directory目錄和單個日志文件名。 如果日志采集器被禁用，結(jié)果為NULL。當(dāng)存在多個日志文件時，每個文件的格式都不同，不帶參數(shù)的pg_current_logfile將返回在有序列表中找到的第一種格式的文件路徑: stderr，csvlog。 如果沒有日志文件具有任何這些格式，則返回NULL。 要請求關(guān)于特定日志文件格式的信息，可以提供 csvlog 或 stderr作為可選參數(shù)的值。 如果在log_destination中沒有配置需要的日志格式，則結(jié)果為 NULL。 結(jié)果反映了current_logfiles文件的內(nèi)容。

pg_my_temp_schema () → oid

返回當(dāng)前會話的臨時模式的OID，如果沒有則返回0(因為它沒有創(chuàng)建任何臨時表)。

pg_is_other_temp_schema ( oid ) → boolean

如果給定的OID是另一個會話的臨時模式的OID則返回真。(這可能是有用的，例如，在目錄顯示中排除其他會話的臨時表。)

pg_jit_available () → boolean

如果JIT編譯器擴展可用(參見第 31 章)，并且jit配置參數(shù)設(shè)置為on，則返回真。

pg_listening_channels () → setof text

返回當(dāng)前會話正在偵聽的異步通知通道的名稱集。

pg_notification_queue_usage () → double precision

返回當(dāng)前被等待處理的通知所占用的異步通知隊列最大尺寸的分數(shù)(0–1)。更多信息請參見LISTEN 和 NOTIFY。

pg_postmaster_start_time () → timestamp with time zone

返回服務(wù)器啟動時的時間。

pg_safe_snapshot_blocking_pids ( integer ) → integer[]

返回一個進程ID數(shù)組，該進程ID是阻塞服務(wù)器進程獲取安全快照的會話的進程ID數(shù)組，如果沒有這樣的服務(wù)器進程或者沒有阻塞，則返回一個空數(shù)組。

運行SERIALIZABLE事務(wù)的會話會阻止SERIALIZABLE READ ONLY DEFERRABLE事務(wù)獲取快照，直到后者確定可以安全地避免獲取謂詞鎖。 關(guān)于可序列化和可延遲事務(wù)的更多信息，請參見第 13.2.3 節(jié)。

頻繁調(diào)用這個函數(shù)可能會對數(shù)據(jù)庫性能產(chǎn)生一些影響，因為它需要在短時間內(nèi)訪問謂詞鎖管理器的共享狀態(tài)。

pg_trigger_depth () → integer

返回當(dāng)前嵌套層次的PostgreSQL觸發(fā)器(如果沒有調(diào)用則為 0，直接或間接，從一個觸發(fā)器內(nèi)部開始)。

session_user → name

返回會話用戶名.

user → name

這個相當(dāng)于 current_user。

version () → text

返回描述PostgreSQL服務(wù)器的版本的字符串。 你還可以從 server_version中獲得此信息，或者對于機器可讀的版本，使用server_version_num。 軟件開發(fā)人員可以使用server_version_num(從8.2起可用)或PQserverVersion，而不是解析文本版本。

has_any_column_privilege ( [ user name or oid, ] table textor oid, privilege text ) → boolean

用戶是否對表的任何列有權(quán)限? 如果對整個表持有特權(quán)，或者對至少一個列有列級的特權(quán)授予，則會成功。 允許的權(quán)限類型為SELECT, INSERT,UPDATE, 和 REFERENCES

has_column_privilege ( [ user name or oid, ] table textor oid, column text or smallint, privilege text ) → boolean

用戶對指定的表列有特權(quán)么?如果對整個表持有特權(quán)，或者對列授予了列級別的特權(quán)，則會成功。 可以通過名稱或?qū)傩跃幪?pg_attribute.attnum)指定列。 允許的特權(quán)類型為SELECT, INSERT,UPDATE, 和 REFERENCES。

has_database_privilege ( [ user name or oid, ] database textor oid, privilege text ) → boolean

用戶對數(shù)據(jù)庫有特權(quán)嗎?允許的特權(quán)類型為CREATE,CONNECT,TEMPORARY, 和TEMP (相當(dāng)于 TEMPORARY)。

has_foreign_data_wrapper_privilege ( [ user name or oid, ] fdw textor oid, privilege text ) → boolean

用戶是否擁有外部數(shù)據(jù)包裝的特權(quán)?唯一允許的特權(quán)類型是USAGE。

has_function_privilege ( [ user name or oid, ] function textor oid, privilege text ) → boolean

用戶對函數(shù)有特權(quán)嗎?唯一允許的特權(quán)類型是EXECUTE。

當(dāng)通過名稱而不是OID指定函數(shù)時，允許的輸入與regprocedure數(shù)據(jù)類型相同(參見第 8.19 節(jié))。一個例子為：

SELECT has_function_privilege('joeuser', 'myfunc(int, text)', 'execute');

has_language_privilege ( [ user name or oid, ] language textor oid, privilege text ) → boolean

用戶對語言有特權(quán)嗎?唯一允許的特權(quán)類型是USAGE。

has_schema_privilege ( [ user name or oid, ] schema textor oid, privilege text ) → boolean

用戶對模式有特權(quán)嗎?允許的特權(quán)類型是CREATE 和USAGE。

has_sequence_privilege ( [ user name or oid, ] sequence textor oid, privilege text ) → boolean

用戶是否有順序特權(quán)?允許的特權(quán)類型有USAGE, SELECT, 和UPDATE。

has_server_privilege ( [ user name or oid, ] server textor oid, privilege text ) → boolean

用戶是否對外部服務(wù)器有特權(quán)?唯一允許的特權(quán)類型是USAGE。

has_table_privilege ( [ user name or oid, ] table text or oid, privilege text ) → boolean

用戶對表有特權(quán)嗎?允許的特權(quán)類型有SELECT, INSERT,UPDATE, DELETE,TRUNCATE, REFERENCES,和 TRIGGER。

has_tablespace_privilege ( [ user name or oid, ] tablespace textor oid, privilege text ) → boolean

用戶對表空間有特權(quán)嗎?唯一允許的特權(quán)類型是CREATE。

has_type_privilege ( [ user name or oid, ] type text or oid, privilege text ) → boolean

用戶對數(shù)據(jù)類型有特權(quán)嗎?唯一允許的特權(quán)類型是 USAGE。 當(dāng)通過名稱而不是OID指定類型時，允許的輸入與regtype數(shù)據(jù)類型相同(參見第 8.19 節(jié))。

pg_has_role ( [ user name or oid, ] role text or oid, privilege text ) → boolean

用戶對角色有特權(quán)么?允許的特權(quán)類型是MEMBER 和 USAGE。 MEMBER表示角色中的直接或間接成員關(guān)系(即執(zhí)行SET ROLE的權(quán)利)，而USAGE表示不執(zhí)行SET ROLE情況下是否立即可用角色的特權(quán)。 此函數(shù)不允許特殊情況下將user設(shè)置為public，因為PUBLIC偽角色永遠不能成為真實角色的成員。

row_security_active ( table text or oid ) → boolean

在當(dāng)前用戶和當(dāng)前環(huán)境的上下文之中，指定表的行級安全是活動的嗎?

aclitem = aclitem → boolean

aclitem相等嗎?(注意，aclitem類型缺少比較操作符的通常集合;它只有相等。 反而言之，aclitem數(shù)組只能進行相等比較。)

'calvin=r*w/hobbes'::aclitem = 'calvin=r*w*/hobbes'::aclitem → f

aclitem[] @> aclitem → boolean

數(shù)組是否包含指定的特權(quán)?(如果有一個數(shù)組條目與aclitem的被授權(quán)人和授予人相匹配，并且至少具有特權(quán)的指定集，則此選項為真。)

'{calvin=r*w/hobbes,hobbes=r*w*/postgres}'::aclitem[] @> 'calvin=r*/hobbes'::aclitem → t

aclitem[] ~ aclitem → boolean

這是@>的已棄用別名。

'{calvin=r*w/hobbes,hobbes=r*w*/postgres}'::aclitem[] ~ 'calvin=r*/hobbes'::aclitem → t

acldefault ( type "char", ownerId oid ) → aclitem[]

構(gòu)造一個aclitem數(shù)組，該數(shù)組持有type類型對象的默認訪問特權(quán)，該對象屬于OID為ownerId的角色。 這表示當(dāng)對象的ACL條目為空時所假定的訪問特權(quán)。(默認的訪問特權(quán)在第 5.7 節(jié)中描述。) type 參數(shù)必須是下列中的一個 'c' 對應(yīng) COLUMN, 'r' 對應(yīng) TABLE 和類表對象, 's' 對應(yīng) SEQUENCE, 'd' 對應(yīng) DATABASE, 'f' 對應(yīng) FUNCTION 或 PROCEDURE, 'l' 對應(yīng) LANGUAGE, 'L' 對應(yīng) LARGE OBJECT, 'n' 對應(yīng) SCHEMA, 't' 對應(yīng) TABLESPACE, 'F' 對應(yīng) FOREIGN DATA WRAPPER, 'S' 對應(yīng) FOREIGN SERVER,或 'T' 對應(yīng) TYPE 或 DOMAIN.

aclexplode ( aclitem[] ) → setof record ( grantor oid, grantee oid, privilege_type text, is_grantable boolean )

以行集的形式返回aclitem數(shù)組。如果受讓人是偽角色PUBLIC，則在grantee列中用0表示。 每個被授予的特權(quán)都表示為SELECT, INSERT等。 注意，每個特權(quán)被分割成單獨的一行，因此在privilege_type列中只出現(xiàn)一個關(guān)鍵字。

makeaclitem ( grantee oid, grantor oid, privileges text, is_grantable boolean ) → aclitem

使用給定的屬性構(gòu)造 aclitem 。

pg_collation_is_visible ( collation oid ) → boolean

排序規(guī)則在搜索路徑中可見嗎？

pg_conversion_is_visible ( conversion oid ) → boolean

轉(zhuǎn)換在搜索路徑中可見嗎？

pg_function_is_visible ( function oid ) → boolean

函數(shù)在搜索路徑中可見嗎？(這也適用于過程和聚合。)

pg_opclass_is_visible ( opclass oid ) → boolean

操作符類在搜索路徑中可見嗎？

pg_operator_is_visible ( operator oid ) → boolean

操作符在搜索路徑中可見嗎？

pg_opfamily_is_visible ( opclass oid ) → boolean

操作符族在搜索路徑中可見嗎？

pg_statistics_obj_is_visible ( stat oid ) → boolean

統(tǒng)計對象在搜索路徑中可見嗎?

pg_table_is_visible ( table oid ) → boolean

表在搜索路徑中可見嗎？(這適用于所有類型的關(guān)系，包括視圖、物化視圖、索引、序列和外部表。)

pg_ts_config_is_visible ( config oid ) → boolean

文本搜索配置在搜索路徑可見嗎?

pg_ts_dict_is_visible ( dict oid ) → boolean

文本搜索字典在搜索路徑可見嗎?

pg_ts_parser_is_visible ( parser oid ) → boolean

文本搜索解析器在搜索路徑中可見嗎?

pg_ts_template_is_visible ( template oid ) → boolean

文本搜索模板在搜索路徑可見嗎?

pg_type_is_visible ( type oid ) → boolean

類型(或域)在搜索路徑中可見嗎?

format_type ( type oid, typemod integer ) → text

返回由其類型OID和可能的類型修飾符標識的數(shù)據(jù)類型的SQL名稱。如果沒有已知的類型修飾符，則傳遞NULL值給類型修飾符。

pg_get_constraintdef ( constraint oid [, pretty boolean ] ) → text

重構(gòu)為了約束的創(chuàng)建命令。(這是一個反編譯的重構(gòu)，而不是命令的原始文本。)

pg_get_expr ( expr pg_node_tree, relation oid [, pretty boolean ] ) → text

反編譯存儲在系統(tǒng)目錄中的表達式的內(nèi)部形式，例如列的默認值。 如果表達式可能包含變量，則指定它們所指向的關(guān)系的OID作為第二個參數(shù);如果沒有預(yù)期的變量，傳遞0就可以了。

pg_get_functiondef ( func oid ) → text

重構(gòu)為了函數(shù)或過程的創(chuàng)建命令。(這是一個反編譯的重構(gòu)，而不是命令的原始文本。) 結(jié)果是一個完整的CREATE OR REPLACE FUNCTION 或 CREATE OR REPLACE PROCEDURE語句。

pg_get_function_arguments ( func oid ) → text

重新構(gòu)造函數(shù)或過程的參數(shù)列表，以其在 CREATE FUNCTION里面需要出現(xiàn)的形式(包括默認值)。

pg_get_function_identity_arguments ( func oid ) → text

重新構(gòu)造標識函數(shù)或過程所需的參數(shù)列表，以其應(yīng)出現(xiàn)在ALTER FUNCTION等命令中的形式。這個表單省略默認值。

pg_get_function_result ( func oid ) → text

重構(gòu)函數(shù)的RETURNS子句，以其需要出現(xiàn)在CREATE FUNCTION中的形式。對于過程，返回NULL。

pg_get_indexdef ( index oid [, column integer, pretty boolean ] ) → text

重構(gòu)針對索引的創(chuàng)建命令。(這是一個反編譯的重構(gòu)，而不是命令的原始文本。)如果提供了column而且不為零，則只重構(gòu)該列的定義。

pg_get_keywords () → setof record ( word text, catcode "char", catdesc text )

返回一組描述服務(wù)器識別的SQL關(guān)鍵字的記錄。word列包含關(guān)鍵字。 catcode列包含一個類別代碼:U表示無保留關(guān)鍵字，C表示可以是列名的關(guān)鍵字，T表示可以是類型或函數(shù)名的關(guān)鍵字，或者 R表示完全保留關(guān)鍵字。 catdesc列包含描述類別的可能本地化字符串。

pg_get_ruledef ( rule oid [, pretty boolean ] ) → text

重構(gòu)針對規(guī)則的創(chuàng)建命令。(這是一個反編譯的重構(gòu)，而不是命令的原始文本。)

pg_get_serial_sequence ( table text, column text ) → text

返回與列相關(guān)聯(lián)的序列名稱，如果沒有序列與該列相關(guān)聯(lián)則返回NULL。 如果列是標識列，則關(guān)聯(lián)序列是在內(nèi)部為該列創(chuàng)建的序列。 對于使用一種串行類型(serial, smallserial, bigserial)創(chuàng)建的列，它是為該串行列定義創(chuàng)建的序列。 在后一種情況下，可以使用ALTER SEQUENCE OWNED BY修改或刪除關(guān)聯(lián)。 (這個函數(shù)可能應(yīng)該被稱為pg_get_owned_sequence;它的當(dāng)前名稱反映了它在歷史上曾與串行類型的列一起使用。) 第一個參數(shù)是具有可選模式的表名，第二個參數(shù)是列名。 由于第一個參數(shù)可能包含模式名和表名，因此按照通常的SQL規(guī)則解析它，這意味著默認情況下它是小寫的。 第二個參數(shù)只是一個列名，按照字面來處理，因此保留了它的大小寫。結(jié)果經(jīng)過了適當(dāng)?shù)母袷交?，可以傳遞給序列函數(shù)(參見第 9.17 節(jié))。

典型的用法是讀取序列的當(dāng)前值以獲取標識或串行列，示例如下:

SELECT currval(pg_get_serial_sequence('sometable', 'id'));

pg_get_statisticsobjdef ( statobj oid ) → text

重構(gòu)針對擴展統(tǒng)計對象的創(chuàng)建命令。(這是一個反編譯的重構(gòu)，而不是命令的原始文本。)

pg_get_triggerdef ( trigger oid [, pretty boolean ] ) → text

重構(gòu)針對觸發(fā)器的創(chuàng)建命令。(這是一個反編譯的重構(gòu)，而不是命令的原始文本。)

pg_get_userbyid ( role oid ) → name

根據(jù)OID返回角色名。

pg_get_viewdef ( view oid [, pretty boolean ] ) → text

重構(gòu)針對視圖或物化視圖的SELECT命令。(這是一個反編譯的重構(gòu)，而不是命令的原始文本。)

pg_get_viewdef ( view oid, wrap_column integer ) → text

重構(gòu)針對視圖或物化視圖的底層SELECT命令。(這是一個反編譯的重構(gòu)，而不是命令的原始文本。) 在這種形式的函數(shù)中，總是啟用美觀打印，并對長行進行換行，以盡量使它們小于指定的列數(shù)。

pg_get_viewdef ( view text [, pretty boolean ] ) → text

根據(jù)視圖的文本名稱而不是它的OID，重構(gòu)針對視圖或物化視圖的底層SELECT命令。(這是棄用;請使用OID變體。)

pg_index_column_has_property ( index regclass, column integer, property text) → boolean

測試一個索引列是否具有命名屬性。表 9.69列出了常用索引列屬性。 (注意，擴展訪問方法可以為其索引定義額外的屬性名。) 如果屬性名未知或不適用于特定對象，或者OID或列號不能識別有效的對象，則返回NULL。

pg_index_has_property ( index regclass, property text ) → boolean

測試一個索引是否具有命名屬性。表 9.70列出了常用的索引屬性。 (注意，擴展訪問方法可以為其索引定義額外的屬性名。) 如果屬性名未知或不適用于特定對象，或者OID不能識別有效的對象，則返回NULL。

pg_indexam_has_property ( am oid, property text ) → boolean

測試索引訪問方法是否具有命名屬性。訪問方法屬性如表 9.71所示。 如果屬性名未知或不適用于特定對象，或者OID不能識別有效的對象，則返回NULL。

pg_options_to_table ( options_array text[] ) → setof record ( option_name text, option_value text )

返回源自pg_class.reloptions 或 pg_attribute.attoptions的值表示的存儲選項集。

pg_tablespace_databases ( tablespace oid ) → setof oid

返回具有存儲在指定表空間中的對象的數(shù)據(jù)庫的OIDs集。 如果這個函數(shù)返回了任何行，那么表空間就不是空的，且不能被刪除。 要識別填充表空間的特定對象，需要連接到由pg_tablespace_databases標識的數(shù)據(jù)庫，并查詢它們的pg_class目錄。

pg_tablespace_location ( tablespace oid ) → text

返回表空間所在的文件系統(tǒng)路徑。

pg_typeof ( "any" ) → regtype

返回傳遞值給它的數(shù)據(jù)類型的OID。這對于故障排除或動態(tài)構(gòu)造SQL查詢很有幫助。 函數(shù)聲明為返回regtype，它是一個OID別名類型(see 第 8.19 節(jié)); 這意味著，為了比較，它與OID相同，但顯示為類型名。

例如:

SELECT pg_typeof(33);
 pg_typeof
-----------
 integer

SELECT typlen FROM pg_type WHERE oid = pg_typeof(33);
 typlen
--------
      4

COLLATION FOR ( "any" ) → text

返回傳遞值給它的排序規(guī)則的名稱。如果需要，該值會被引號括起來，并使用模式限定。 如果沒有為參數(shù)表達式派生排序規(guī)則，則返回NULL。如果參數(shù)不是可排序數(shù)據(jù)類型，則會引發(fā)錯誤。

例如:

SELECT collation for (description) FROM pg_description LIMIT 1;
 pg_collation_for
------------------
 "default"

SELECT collation for ('foo' COLLATE "de_DE");
 pg_collation_for
------------------
 "de_DE"

to_regclass ( text ) → regclass

將文本關(guān)系名轉(zhuǎn)換為它的OID。通過將字符串類型轉(zhuǎn)換為regclass可以得到類似的結(jié)果(參見第 8.19 節(jié)); 但是，如果沒有找到名稱，這個函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

to_regcollation ( text ) → regcollation

將文本排序規(guī)則名稱轉(zhuǎn)換為它的OID。通過將字符串類型轉(zhuǎn)換為regcollation(參見第 8.19 節(jié))可以得到類似的結(jié)果; 但是，如果沒有找到名稱，這個函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

to_regnamespace ( text ) → regnamespace

將文本模式名轉(zhuǎn)換為它的OID。通過將字符串轉(zhuǎn)換為regnamespace類型(參見第 8.19 節(jié))可以得到類似的結(jié)果; 但是，如果沒有找到名稱，這個函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

to_regoper ( text ) → regoper

將文本操作符名稱轉(zhuǎn)換為它的OID。通過將字符串類型轉(zhuǎn)換為regoper(參見第 8.19 節(jié))可以得到類似的結(jié)果; 但是，如果找不到名稱或名稱有多義性，該函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

to_regoperator ( text ) → regoperator

將文本操作符名稱(帶有參數(shù)類型)轉(zhuǎn)換為其OID。通過將字符串轉(zhuǎn)換為regoperator類型(參見第 8.19 節(jié)節(jié))可以得到類似的結(jié)果; 但是，如果沒有找到名稱，這個函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

to_regproc ( text ) → regproc

將文本函數(shù)或過程名轉(zhuǎn)換為其OID。通過將字符串轉(zhuǎn)換為regproc類型(參見第 8.19 節(jié))可以得到類似的結(jié)果; 但是，如果找不到名稱或名稱有多義性，該函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

to_regprocedure ( text ) → regprocedure

將文本函數(shù)或過程名(帶有參數(shù)類型)轉(zhuǎn)換為其OID。通過將字符串類型轉(zhuǎn)換為regprocedure可以得到類似的結(jié)果(參見第 8.19 節(jié)); 但是，如果沒有找到名稱，這個函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

to_regrole ( text ) → regrole

將文本角色名轉(zhuǎn)換為它的OID。通過將字符串類型轉(zhuǎn)換為regrole可以得到類似的結(jié)果(參見第 8.19 節(jié)); 但是，如果沒有找到名稱，這個函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

to_regtype ( text ) → regtype

將文本類型名轉(zhuǎn)換為它的OID。通過將字符串類型轉(zhuǎn)換為regtype可以得到類似的結(jié)果(參見第 8.19 節(jié)); 但是，如果沒有找到名稱，這個函數(shù)將返回NULL而不會拋出錯誤。與強制轉(zhuǎn)換不同的是，它不接受數(shù)字OID作為輸入。

pg_describe_object ( classid oid, objid oid, objsubid integer) → text

返回由目錄OID、對象OID和子對象ID(例如表中的列號)標識的數(shù)據(jù)庫對象的文本描述;當(dāng)引用整個對象時，子對象ID為0)。 這個描述是人類可讀的，并且可以根據(jù)服務(wù)器配置進行翻譯。這對于決定pg_depend目錄中引用的對象的標識特別有用。

pg_identify_object ( classid oid, objid oid, objsubid integer) → record ( type text, schema text, name text, identity text )

返回包含足夠信息的行以唯一標識由目錄OID、對象OID和子對象ID指定的數(shù)據(jù)庫對象。 這些信息是為了機器可讀的，永遠不會被翻譯。 type標識數(shù)據(jù)庫對象的類型; schema是對象所屬的模式名，NULL表示不屬于模式的對象類型; name是對象的名稱，如果有必要，用引號括起來，如果名稱(隨著模式名稱，如果相關(guān))足以唯一地標識對象，否則為 NULL; identity是完整的對象標識，其精確格式依賴于對象類型，格式中的每個名稱都是模式限定的，并在必要時用引號括起來。

pg_identify_object_as_address ( classid oid, objid oid, objsubid integer) → record ( type text, object_names text[], object_args text[])

返回包含足夠信息的行以唯一標識由目錄OID、對象OID和子對象ID指定的數(shù)據(jù)庫對象。 返回的信息獨立于當(dāng)前服務(wù)器，也就是說，它可以用于標識另一個服務(wù)器中具有相同名稱的對象。 type標識數(shù)據(jù)庫對象的類型;object_names和object_args是文本數(shù)組，它們一起構(gòu)成對對象的引用。 這三個值可以傳遞給pg_get_object_address以獲得對象的內(nèi)部地址。

pg_get_object_address ( type text, object_names text[], object_args text[]) → record ( classid oid, objid oid, objsubid integer)

返回包含足夠信息的行以唯一標識由類型代碼、對象名稱和參數(shù)數(shù)組指定的數(shù)據(jù)庫對象。 返回的值將在系統(tǒng)目錄中使用，例如pg_depend; 它們可以傳遞給其他系統(tǒng)函數(shù)，比如 pg_describe_object或pg_identify_object。 classid是包含該對象的系統(tǒng)目錄的OID; objid 是對象本身的OID, objsubid是子對象的ID，如果沒有則為零。 這個函數(shù)是pg_identify_object_as_address的反向函數(shù)。

col_description ( table oid, column integer ) → text

返回表列的注釋，該注釋由該表的OID和列號指定。(obj_description不能用于表的列，因為列沒有自己的oid。)

obj_description ( object oid, catalog name ) → text

返回OID指定的數(shù)據(jù)庫對象的注釋和包含該對象的系統(tǒng)目錄的名稱。 例如，obj_description(123456, 'pg_class')將檢索OID為123456的表的注釋。

obj_description ( object oid ) → text

返回僅由其OID指定的數(shù)據(jù)庫對象的注釋。 這個已被棄用(deprecated)因為無法保證oid在不同的系統(tǒng)目錄中是唯一的;因此，可能會返回錯誤的注釋。

shobj_description ( object oid, catalog name ) → text

返回共享數(shù)據(jù)庫對象的注釋，該對象由其OID和包含的系統(tǒng)編目的名稱指定。 這與obj_description類似，只是它用于檢索共享對象(也就是數(shù)據(jù)庫、角色和表空間)上的注釋。 有些系統(tǒng)編目對每個集群中的所有數(shù)據(jù)庫都是全局的，其中對象的描述也全局存儲。

pg_current_xact_id () → xid8

返回當(dāng)前事務(wù)的ID。如果當(dāng)前事務(wù)還沒有一個ID(因為它還沒有執(zhí)行任何數(shù)據(jù)庫更新)，它將分配一個新的事務(wù)。

pg_current_xact_id_if_assigned () → xid8

返回當(dāng)前事務(wù)的ID，如果還沒有分配ID則返回NULL。 (如果事務(wù)可能是只讀的，最好使用這種變體，以避免不必要地消耗XID。)

pg_xact_status ( xid8 ) → text

報告最近的事務(wù)的提交狀態(tài)。如果事務(wù)為最近的，系統(tǒng)會保留事務(wù)的提交狀態(tài)，則結(jié)果是 in progress、committed或aborted。 如果該事務(wù)的時間足夠久，并且系統(tǒng)中沒有對該事務(wù)的引用，而且提交狀態(tài)信息已經(jīng)被丟棄，則結(jié)果為NULL。 應(yīng)用可以使用此函數(shù)，例如，確定在進行 COMMIT時，應(yīng)用程序和數(shù)據(jù)庫服務(wù)器斷開連接后，它們的事務(wù)是已提交還是中止。 注意，準備好的事務(wù)報告為in progress的事務(wù);如果應(yīng)用需要確定一個事務(wù)ID是否屬于一個準備好的事務(wù)，則必須檢查pg_prepared_xacts。

pg_current_snapshot () → pg_snapshot

返回當(dāng)前snapshot，顯示哪些事務(wù)IDs正在進行中的數(shù)據(jù)結(jié)構(gòu)。

pg_snapshot_xip ( pg_snapshot ) → setof xid8

返回快照中包含的正在進行的事務(wù)IDs集。

pg_snapshot_xmax ( pg_snapshot ) → xid8

返回快照的xmax。

pg_snapshot_xmin ( pg_snapshot ) → xid8

返回快照的xmin。

pg_visible_in_snapshot ( xid8, pg_snapshot ) → boolean

根據(jù)此快照，給定的事務(wù)ID是否可見(visible)(也就是說，它是否在快照拍攝之前完成)? 注意，這個函數(shù)不會給出子事務(wù)ID的正確答案。

txid_current () → bigint

參見 pg_current_xact_id().

txid_current_if_assigned () → bigint

參見 pg_current_xact_id_if_assigned().

txid_current_snapshot () → txid_snapshot

參見 pg_current_snapshot().

txid_snapshot_xip ( txid_snapshot ) → setof bigint

參見 pg_snapshot_xip().

txid_snapshot_xmax ( txid_snapshot ) → bigint

參見 pg_snapshot_xmax().

txid_snapshot_xmin ( txid_snapshot ) → bigint

參見 pg_snapshot_xmin().

txid_visible_in_snapshot ( bigint, txid_snapshot ) → boolean

參見 pg_visible_in_snapshot().

txid_status ( bigint ) → text

參見 pg_xact_status().

pg_xact_commit_timestamp ( xid ) → timestamp with time zone

返回事務(wù)的提交時間戳。

pg_last_committed_xact () → record ( xid xid, timestamp timestamp with time zone )

返回最近提交的事務(wù)的事務(wù)ID和提交時間戳。

pg_control_checkpoint () → record

返回有關(guān)當(dāng)前檢查點狀態(tài)的信息, 如 表 9.79所展示。

pg_control_system () → record

返回有關(guān)當(dāng)前控制文件狀態(tài)的信息，如 表 9.80 所展示。

pg_control_init () → record

返回有關(guān)集群初始化狀態(tài)的信息，如 表 9.81所展示。

pg_control_recovery () → record

返回有關(guān)恢復(fù)狀態(tài)的信息,如 表 9.82所展示。