Table 9.63展示了多个可以抽取会话和系统信息的函数。

除了本节列出的函数外，还有许多与统计系统相关的函数，这些函数也提供系统信息。有关更多信息，请参见Section 27.2.3。

session_user通常是发起当前数据库连接的用户，不过超级用户可以用SET SESSION AUTHORIZATION修改这个设置。 current_user是用于权限检查的用户标识。通常， 它总是等于会话用户，但是可以被SET ROLE改变。 它也会在函数执行的过程中随着属性SECURITY DEFINER的改变而改变。 在 Unix 的说法里，那么会话用户是“真实用户”，而当前用户是“有效用户”。 current_role以及user是current_user的同义词（SQL标准在current_role和current_user之间做了区分，但PostgreSQL不区分，因为它把用户和角色统一成了一种实体）。

current_schema 返回搜索路径中第一个模式的名称（如果搜索路径为空，则返回空值）。在创建表或其他命名对象时，如果未指定目标模式，就会使用该模式。current_schemas(boolean) 返回当前搜索路径中所有模式名称的数组。布尔选项决定是否在返回的搜索路径中包含 pg_catalog 等隐式包含的系统模式。

SET search_path TO schema [, schema, ...]

inet_client_addr 返回当前客户端的 IP 地址，inet_client_port 返回端口号。inet_server_addr 返回服务器接受当前连接所用的 IP 地址，inet_server_port 返回端口号。如果当前连接通过 Unix 域套接字建立，这些函数都返回 NULL。

pg_blocking_pids 返回一个数组，包含阻塞指定进程 ID 对应的服务器进程的会话进程 ID；如果不存在这样的服务器进程，或该进程未被阻塞，则返回空数组。一个服务器进程会在以下情况下阻塞另一个进程：它持有与被阻塞进程请求的锁冲突的锁（硬阻塞）；或者它正在等待一个会与被阻塞进程请求的锁冲突的锁，并且在等待队列中位于被阻塞进程之前（软阻塞）。使用并行查询时，即使实际持锁或等待锁的是子工作进程，结果也始终列出客户端可见的进程 ID（即 pg_backend_pid 的结果）。因此，结果中可能出现重复的 PID。另外，如果持有冲突锁的是一个预备事务，该函数会在结果中用进程 ID 0 表示它。频繁调用此函数可能影响数据库性能，因为它需要短暂地独占访问锁管理器的共享状态。

pg_conf_load_time 返回服务器配置文件最近一次加载的时间，类型为 timestamp with time zone。（如果当时当前会话已经存在，则返回该会话自身重新读取配置文件的时间，因此不同会话中的时间会略有不同。否则，返回 postmaster 进程重新读取配置文件的时间。）

pg_current_logfile 以 text 返回日志收集器当前使用的日志文件路径。路径包括 log_directory 目录和日志文件名。必须启用日志收集，否则返回值为 NULL。当存在多个格式不同的日志文件时，不带参数调用 pg_current_logfile 会按 stderr、csvlog 的顺序查找，返回找到的第一个格式的文件路径。如果没有任何日志文件采用这些格式，则返回 NULL。要请求特定文件格式，可向可选参数传入 text 类型的 csvlog 或 stderr。如果请求的日志格式未配置在 log_destination 中，返回值为 NULL。pg_current_logfile 反映 current_logfiles 文件的内容。

pg_my_temp_schema 返回当前会话的临时模式的 OID；如果没有临时模式（因为尚未创建任何临时表），则返回零。如果给定 OID 是另一个会话的临时模式的 OID，pg_is_other_temp_schema 返回真。（这可以用于从系统目录显示结果中排除其他会话的临时表等场景。）

pg_listening_channels 返回当前会话正在监听的异步通知通道名称集合。pg_notification_queue_usage 返回待处理通知当前占用的空间占通知总可用空间的比例，是一个范围为 0-1 的 double 值。更多信息请参见LISTEN和NOTIFY。

pg_postmaster_start_time 返回服务器启动的时间，类型为 timestamp with time zone。

pg_safe_snapshot_blocking_pids 返回一个数组，包含阻止指定进程 ID 对应的服务器进程获取安全快照的会话进程 ID；如果不存在这样的服务器进程，或该进程未被阻塞，则返回空数组。运行 SERIALIZABLE 事务的会话会阻止 SERIALIZABLE READ ONLY DEFERRABLE 事务获取快照，直到后者确定可以安全地不获取任何谓词锁。关于可序列化事务和可延迟事务的更多信息，请参见Section 13.2.3。频繁调用此函数可能影响数据库性能，因为它需要短暂访问谓词锁管理器的共享状态。

version 返回一个描述 PostgreSQL 服务器版本的字符串。也可以通过 server_version 获取此信息，或者通过 server_version_num 获取机器可读的版本。软件开发者应使用 server_version_num（自 8.2 起提供）或 PQserverVersion ，而不是解析文本版本。

Table 9.64列出了允许用户以编程方式查询对象访问权限的函数。关于权限的更多信息，请参见Section 5.7。

has_table_privilege检查用户是否可以以某种方式访问表。用户参数可以是名称、OID（pg_authid.oid）， public（表示 PUBLIC 伪角色）；如果省略该参数，则使用current_user。表可以通过名称或 OID 指定。（因此，has_table_privilege实际上有六种变体，可以通过参数的数量和类型来区分。）通过名称指定时，如有需要，可以用模式限定名称。所需访问权限类型由文本字符串指定，其值必须为以下值之一：SELECT， INSERT， UPDATE， DELETE， TRUNCATE， REFERENCES，或TRIGGER。还可以添加WITH GRANT OPTION到权限类型后，以检查该权限是否附带授予选项。也可以用逗号分隔列出多个权限类型；只要拥有列出的任一权限，结果就为true。（权限字符串不区分大小写，权限名之间允许有额外的空白，但权限名内部不允许。）下面是一些示例：

SELECT has_table_privilege('myschema.mytable', 'select');
SELECT has_table_privilege('joe', 'mytable', 'INSERT, SELECT WITH GRANT OPTION');

has_sequence_privilege 检查用户是否可以以某种方式访问序列。其参数形式与 has_table_privilege 类似。所需访问权限类型必须为 USAGE、SELECT 或 UPDATE 之一。

has_any_column_privilege 检查用户是否可以以某种方式访问表的任意列。其参数形式与 has_table_privilege 类似，但所需访问权限类型必须为 SELECT、INSERT、UPDATE 或 REFERENCES 的某种组合。注意，在表级别拥有这些权限中的任意一种，就隐式地对表的每一列拥有该权限，因此对于相同参数，如果 has_table_privilege 返回 true，has_any_column_privilege 也总是返回真。但是，只要至少有一列获得该权限的列级授权，has_any_column_privilege 也会成功。

has_column_privilege 检查用户是否可以以某种方式访问列。其参数形式与 has_table_privilege 类似，但还可以通过列名或属性编号指定列。所需访问权限类型必须为 SELECT、INSERT、UPDATE 或 REFERENCES 的某种组合。注意，在表级别拥有这些权限中的任意一种，就隐式地对表的每一列拥有该权限。

has_database_privilege 检查用户是否可以以某种方式访问数据库。其参数形式与 has_table_privilege 类似。所需访问权限类型必须为 CREATE、CONNECT、TEMPORARY 或 TEMP（等同于 TEMPORARY）的某种组合。

has_function_privilege检查用户是否可以以某种方式访问函数。其参数形式类似于has_table_privilege。通过文本字符串而不是 OID 指定函数时，允许的输入与regprocedure数据类型相同（参见Section 8.19）。所需访问权限类型必须为EXECUTE。例如：

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

has_foreign_data_wrapper_privilege 检查用户是否可以以某种方式访问外部数据包装器。其参数形式与 has_table_privilege 类似。所需访问权限类型必须为 USAGE。

has_language_privilege 检查用户是否可以以某种方式访问过程语言。其参数形式与 has_table_privilege 类似。所需访问权限类型必须为 USAGE。

has_schema_privilege 检查用户是否可以以某种方式访问模式。其参数形式与 has_table_privilege 类似。所需访问权限类型必须为 CREATE 或 USAGE 的某种组合。

has_server_privilege 检查用户是否可以以某种方式访问外部服务器。其参数形式与 has_table_privilege 类似。所需访问权限类型必须为 USAGE。

has_tablespace_privilege 检查用户是否可以以某种方式访问表空间。其参数形式与 has_table_privilege 类似。所需访问权限类型必须为 CREATE。

has_type_privilege 检查用户是否可以以某种方式访问类型。其参数形式与 has_table_privilege 类似。通过文本字符串而不是 OID 指定类型时，允许的输入与 regtype 数据类型相同（参见Section 8.19）。所需访问权限类型必须为 USAGE。

pg_has_role 检查用户是否可以以某种方式访问角色。其参数形式与 has_table_privilege 类似，但不允许使用 public 作为用户名。所需访问权限类型必须为 MEMBER 或 USAGE 的某种组合。MEMBER 表示直接或间接地属于该角色（即有权执行 SET ROLE），而 USAGE 表示无需执行 SET ROLE 就能立即使用该角色的权限。可以在这两种权限类型后添加 WITH ADMIN OPTION 或 WITH GRANT OPTION，以检查是否拥有 ADMIN 权限（四种写法检查的是同一件事）。

row_security_active 检查在 current_user 和当前环境的上下文中，指定表的行级安全性是否生效。可以通过名称或 OID 指定表。

Table 9.65 显示了aclitem类型的可用操作符，它是访问权限的目录表示。 有关如何读取访问权限值的信息，请参阅 Section 5.7。

Table 9.66 显示了一些额外的函数来管理aclitem类型。

acldefault 返回属于角色 ownerId、类型为 type 的对象的内置默认访问权限。当对象的 ACL 条目为空值时，会采用这些访问权限。（默认访问权限见Section 5.7。）type 参数的类型为 CHAR：'c' 表示 COLUMN，'r' 表示 TABLE 和类似表的对象，'s' 表示 SEQUENCE，'d' 表示 DATABASE，'f' 表示 FUNCTION 或 PROCEDURE，'l' 表示 LANGUAGE，'L' 表示 LARGE OBJECT，'n' 表示 SCHEMA，'t' 表示 TABLESPACE，'F' 表示 FOREIGN DATA WRAPPER，'S' 表示 FOREIGN SERVER，'T' 表示 TYPE 或 DOMAIN。

aclexplode 将一个 aclitem 数组返回为行集合。输出列依次为授予者的 oid、受让者的 oid（0 表示 PUBLIC）、以 text 表示的所授予权限（SELECT 等），以及以 boolean 表示的该权限是否可以转授。makeaclitem 执行相反的操作。

Table 9.67列出了判断某个特定对象是否可见的函数，其判断依据是当前模式搜索路径。例如，如果表所在的模式位于搜索路径中，并且在搜索路径的更前面没有同名表，就称该表可见。这等价于说，可以只通过表名引用该表，而不必显式地用模式限定。要列出所有可见表的名称：

SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);

每个函数检查一种数据库对象的可见性。注意，pg_table_is_visible 也可用于视图、物化视图、索引、序列和外部表；pg_function_is_visible 也可用于过程和聚合；pg_type_is_visible 也可用于域。对于函数和操作符，如果搜索路径更前面没有名称和参数数据类型都相同的对象，那么路径中的该对象就是可见的。对于操作符类，会同时考虑名称和关联的索引访问方法。

所有这些函数都需要用对象 OID 标识要检查的对象。如果想按名称测试对象，使用 OID 别名类型会很方便（regclass， regtype， regprocedure， regoperator， regconfig，或regdictionary），例如：

SELECT pg_type_is_visible('myschema.widget'::regtype);

注意，用这种方式测试不带模式限定的类型名并没有太大意义：只要该名称能够被识别，它就必然可见。

Table 9.68 列出从系统目录中提取信息的函数。

format_type 返回数据类型的 SQL 名称，该类型由其类型 OID 和可能存在的类型修饰符标识。如果不知道具体的类型修饰符，请为类型修饰符参数传入 NULL。

pg_get_keywords 返回一组记录，描述服务器识别的 SQL 关键字。word 列包含关键字。catcode 列包含类别代码：U 表示非保留关键字，C 表示列名，T 表示类型名或函数名，R 表示保留关键字。catdesc 列包含描述该类别的字符串，该字符串可能已经过本地化。

pg_get_constraintdef、pg_get_indexdef、pg_get_ruledef、pg_get_statisticsobjdef 和 pg_get_triggerdef 分别重建约束、索引、规则、扩展统计对象或触发器的创建命令。（注意，这是通过反编译重建的，并非命令的原始文本。）pg_get_expr 反编译单个表达式的内部形式，例如列的默认值。这在检查系统目录内容时可能很有用。如果表达式可能包含 Vars，请将它们所引用的关系的 OID 指定为第二个参数；如果预计不含 Vars，传入零即可。pg_get_viewdef 重建定义视图的 SELECT 查询。这些函数中的大多数有两种变体，其中一种可以选择“美化输出”结果。美化格式更易读，但默认格式更可能被未来版本的 PostgreSQL 以相同方式解释；转储时应避免使用美化输出。向美化输出参数传入 false，所得结果与完全没有该参数的变体相同。

pg_get_functiondef 返回一个函数的完整 CREATE OR REPLACE FUNCTION 语句。pg_get_function_arguments 以 CREATE FUNCTION 中所需的形式返回函数参数列表。pg_get_function_result 类似地返回该函数相应的 RETURNS 子句。pg_get_function_identity_arguments 返回标识函数所需的参数列表，例如以 ALTER FUNCTION 中所需的形式返回。此形式省略默认值。

pg_get_serial_sequence返回与列关联的序列名称；如果该列没有关联序列，则返回 NULL。如果列是标识列，关联序列就是为标识列在内部创建的序列。对于使用某种串行类型（serial， smallserial， bigserial）创建的列，关联序列就是为该串行列定义创建的序列。在后一种情况下，可以使用ALTER SEQUENCE OWNED BY修改或移除这种关联。（该函数也许应该叫作pg_get_owned_sequence；它当前的名称反映了它通常用于serial或bigserial列这一事实。）第一个输入参数是可以带有模式名的表名，第二个参数是列名。由于第一个参数可能包含模式和表，它不会被当作双引号括起的标识符处理，因此默认转换为小写；第二个参数只包含列名，会被当作带双引号的标识符处理并保留大小写。函数返回的值采用适于传递给序列函数的格式（参见Section 9.16）。典型用法是读取标识列或串行列的序列当前值，例如：

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

pg_get_userbyid 根据给定 OID 获取角色名称。

pg_index_column_has_property、pg_index_has_property 和 pg_indexam_has_property 返回指定的索引列、索引或索引访问方法是否具有给定名称的属性。如果属性名未知或不适用于该对象，或者 OID 或列号不能标识有效对象，则返回 NULL。列属性见Table 9.69，索引属性见Table 9.70，访问方法属性见Table 9.71。（注意，扩展提供的访问方法可以为其索引定义额外的属性名。）

向 pg_options_to_table 传入 pg_class.reloptions 或 pg_attribute.attoptions 时，它返回存储选项名称/值对（option_name/option_value）的集合。

pg_tablespace_databases 用于检查表空间。它返回在该表空间中存储了对象的数据库 OID 集合。如果此函数返回任何行，则说明该表空间不为空，不能删除。要显示存放在该表空间中的具体对象，需要连接到 pg_tablespace_databases 标识的数据库，并查询它们的 pg_class 系统目录。

pg_typeof返回所传入值的数据类型的 OID。这有助于排查问题或动态构造 SQL 查询。函数声明的返回类型是regtype，它是一种 OID 别名类型（参见Section 8.19）；这意味着它在比较时与 OID 相同，但显示为类型名。例如：

SELECT pg_typeof(33);

 pg_typeof 
-----------
 integer
(1 row)

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

表达式collation for返回所传入值的排序规则。例如：

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

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

返回值可能带有引号和模式限定。如果不能为参数表达式推导出排序规则，则返回空值。如果参数的数据类型不支持排序规则，则会报错。

to_regclass、to_regproc、to_regprocedure、to_regoper、to_regoperator、to_regtype、to_regnamespace 和 to_regrole 函数将以 text 给出的关系、函数、操作符、类型、模式和角色名称，分别转换为 regclass、regproc、regprocedure、regoper、regoperator、regtype、regnamespace 和 regrole 类型的对象。这些函数与从文本进行类型转换的区别是：它们不接受数值 OID，而且在找不到名称时（对于 to_regproc 和 to_regoper，还包括给定名称匹配多个对象时）返回空值，而不会报错。

Table 9.72列出了与数据库对象 标识和定位有关的函数。

pg_describe_object 返回数据库对象的文本描述，对象由系统目录 OID、对象 OID 和子对象 ID 指定（例如表中的列号；引用整个对象时，子对象 ID 为零）。该描述供人阅读，并可能根据服务器配置被翻译。这有助于确定存储在 pg_depend 系统目录中的对象身份。

pg_identify_object 返回一行，其中包含足以唯一标识数据库对象的信息，该对象由系统目录 OID、对象 OID 和子对象 ID 指定。这些信息供机器读取，永远不会被翻译。type 标识数据库对象的类型；schema 是对象所属的模式名，对于不属于模式的对象类型则为 NULL；如果对象名（以及适用时的模式名）足以唯一标识该对象，name 就是对象名，并在必要时加引号，否则为 NULL；identity 是完整的对象标识，其具体格式取决于对象类型，格式中的每个名称都会根据需要加上模式限定和引号。

pg_identify_object_as_address 返回一行，其中包含足以唯一标识数据库对象的信息，该对象由系统目录 OID、对象 OID 和子对象 ID 指定。返回的信息与当前服务器无关，也就是说，它也能用于标识另一台服务器上名称相同的对象。type 标识数据库对象的类型；object_names 和 object_args 是文本数组，共同构成对该对象的引用。将这三个值传给 pg_get_object_address 可以获得对象的内部地址。此函数执行 pg_get_object_address 的逆操作。

pg_get_object_address 返回一行，其中包含足以唯一标识数据库对象的信息，该对象由其类型、对象名称数组和参数数组指定。返回的值就是 pg_depend 等系统目录中使用的值，也可以传给 pg_identify_object 或 pg_describe_object 等其他系统函数。classid 是包含该对象的系统目录的 OID；objid 是对象自身的 OID；objsubid 是子对象 ID，没有子对象时为零。此函数执行 pg_identify_object_as_address 的逆操作。

Table 9.73中展示的函数抽取注释，注释是由COMMENT命令在以前存储的。如果对指定参数找不到注释，则返回空值。

col_description 返回表列的注释，列由所属表的 OID 和列号指定。（obj_description 不能用于表列，因为列没有自身的 OID。）

obj_description 的双参数形式返回数据库对象的注释，对象由其 OID 和所在系统目录的名称指定。例如，obj_description(123456,'pg_class') 会获取 OID 为 123456 的表的注释。obj_description 的单参数形式只需要对象 OID。该形式已被弃用，因为无法保证 OID 在不同系统目录之间唯一，因而可能返回错误的注释。

shobj_description 的用法与 obj_description 相同，但用于获取共享对象的注释。有些系统目录由数据库集簇中的所有数据库全局共享，其中对象的描述也全局存储。

Table 9.74中的函数以可导出的形式提供服务器事务信息。这些函数主要用于确定两个快照之间有哪些事务提交。

内部事务 ID 类型（xid）为 32 位，每经过约 40 亿个事务就会回卷一次。不过，这些函数导出的是用“纪元”计数器扩展的 64 位格式，在一次安装的整个使用期间都不会回卷。这些函数使用的 txid_snapshot 数据类型存储某一时刻的事务 ID 可见性信息。其组成部分见Table 9.75。

txid_snapshot 的文本表示为 xmin:xmax:xip_list。例如，10:20:10,14,15 表示 xmin=10, xmax=20, xip_list=10, 14, 15。

txid_status(bigint) 报告近期事务的提交状态。如果在 COMMIT 进行过程中应用与数据库服务器断开连接，应用可以用它判断事务是提交了还是中止了。只要事务足够新，系统仍保留其提交状态，就会将状态报告为 in progress、committed 或 aborted。如果事务已足够旧，系统中不再有对它的引用，且提交状态信息已被丢弃，则此函数返回 NULL。注意，预备事务被报告为 in progress；如果需要确定某个 txid 是否为预备事务，应用必须检查 pg_prepared_xacts。

Table 9.76中的函数提供已提交事务的信息，主要是事务何时提交。只有启用 track_commit_timestamp 配置选项后，这些函数才会提供有用的数据，并且只针对启用该选项之后提交的事务。

Table 9.77中的函数显示在 initdb 期间初始化的信息，例如系统目录版本。它们也显示有关预写式日志和检查点处理的信息。这些信息适用于整个数据库集簇，而非某个特定数据库。它们与 pg_controldata 从相同来源提供大部分相同的信息，但采用更适合 SQL 函数的形式。

pg_control_checkpoint 返回一条记录，其内容见Table 9.78

pg_control_system 返回一条记录，其内容见Table 9.79

pg_control_init 返回一条记录，其内容见Table 9.80

pg_control_recovery 返回一条记录，其内容见Table 9.81