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

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

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.61列出了允许用户以编程方式查询对象访问权限的函数。关于权限的更多信息，请参见Section 5.6。

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.18）。所需访问权限类型必须为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.18）。所需访问权限类型必须为 USAGE。

pg_has_role 检查用户是否可以以某种方式访问角色。其参数形式与 has_table_privilege 类似，但不允许使用 public 作为用户名。所需访问权限类型必须为 MEMBER 或 USAGE 的某种组合。MEMBER 表示直接或间接地属于该角色（即有权执行 SET ROLE），而 USAGE 表示无需执行 SET ROLE 就能立即使用该角色的权限。

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

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

SELECT relname FROM pg_class WHERE pg_table_is_visible(oid);

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

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

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

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

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

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.64，索引属性见Table 9.65，访问方法属性见Table 9.66。（注意，扩展提供的访问方法可以为其索引定义额外的属性名。）

向 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.18）；这意味着它在比较时与 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.67列出了与数据库对象 标识和定位有关的函数。

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.68中展示的函数抽取注释，注释是由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.69中的函数以可导出的形式提供服务器事务信息。这些函数主要用于确定两个快照之间有哪些事务提交。

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

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.71中的函数提供已提交事务的信息，主要是事务何时提交。只有启用 track_commit_timestamp 配置选项后，这些函数才会提供有用的数据，并且只针对启用该选项之后提交的事务。

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

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

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

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

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