9.19. 系统信息函数

表9-40显示了几个抽取会话及系统信息的函数。

session_user 通常是连接当前数据库的初始用户，不过超级用户可以用 SET SESSION AUTHORIZATION 修改这个设置。current_user 是用于权限检查的用户标识。通常，它总是等于会话用户，但是可以通过 SET ROLE 改变它。在函数执行的过程中随着属性 SECURITY DEFINER 的改变，其值也会改变。用 Unix 术语来说，会话用户是"真实用户"，而当前用户是"有效用户"。

current_schema 返回在搜索路径前端的模式名字(如果搜索路径为空则返回 NULL)。如果创建表或者其它命名对象时没有声明目标模式，那么它将是用于这些对象的模式。current_schemas(boolean) 返回一个搜索路径中所有模式名字的数组。布尔选项决定像 pg_catalog 这样隐含包含的系统模式是否包含在返回的搜索路径中。

inet_client_addr 返回当前客户端的IP地址，而 inet_client_port 则返回当前客户端的端口号。inet_server_addr 返回服务器接收当前连接用的 IP 地址，而 inet_server_port 返回接收当前连接的端口号。如果是通过 Unix-domain socket 连接的，那么所有这些函数都返回 NULL 。

pg_my_temp_schema 返回当前会话的临时模式 OID ，如果不存在的话则返回 0(因为没有创建任何临时表)。pg_is_other_temp_schema 返回给定的 OID 是否为其它会话的临时模式 OID ，这个函数是有实用价值的，比如，在显示一个目录的时候排除掉其它会话的临时表。

pg_postmaster_start_time 返回服务器启动时的 timestamp with time zone 。

version 返回一个描述 PostgreSQL 服务器版本信息的字符串。

表9-41列出那些允许用户在程序里查询对象访问权限的函数。参阅节5.6获取更多有关权限的信息。

has_database_privilege 检查一个用户是否能以特定方式访问一个数据库。它可能的参数类似 has_table_privilege 。权限类型必须是 CREATE, CONNECT, TEMPORARY, TEMP(等价于 TEMPORARY)之一。

has_function_privilege 检查一个用户是否能以特定方式访问一个函数。它可能的参数类似 has_table_privilege 。我们声明一个函数用的是文本字符串而不是 OID ，允许的输入和 regprocedure 数据类型一样(参阅节8.12)。权限类型必须是 EXECUTE 。一个例子如下：

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

has_language_privilege 检查一个用户是否能以特定方式访问一个过程语言。它可能的参数类似 has_table_privilege 。权限类型必须是 USAGE 。

has_schema_privilege 检查一个用户是否能以特定方式访问一个模式。它可能的参数类似 has_table_privilege 。权限类型必须是 CREATE 或 USAGE 。

has_table_privilege 检查一个用户是否能以特定方式访问一个表。用户可以通过名字或者 OID(pg_authid.oid)来声明，如果省略该参数，则使用 current_user 。该表可以通过名字或者 OID 声明。因此，实际上有六种 has_table_privilege 变体，我们可以通过它们的参数数目和类型来区分它们。如果用名字声明，那么在必要时可以用模式进行修饰。所希望的权限类型是用一个文本字符串来声明的，必须是 SELECT, INSERT, UPDATE, DELETE, REFERENCES, TRIGGER 之一。当然，字符串的大小写没什么关系。例如：

SELECT has_table_privilege('myschema.mytable', 'select');

has_tablespace_privilege 检查一个用户是否能以特定方式访问一个表空间。它可能的参数类似 has_table_privilege 。权限类型必须是 CREATE 。

pg_has_role 检查一个用户是否能以特定方式访问一个角色。它可能的参数类似 has_table_privilege 。权限类型必须是 MEMBER 或 USAGE 。MEMBER 表示是角色中的直接或间接成员关系(也就是 SET ROLE 的权限)，而 USAGE 表示角色的权限是否无需 SET ROLE 即可立即生效。

要评估一个用户是否在权限上持有赋权选项，给权限键字附加 WITH GRANT OPTION 即可，比如：'UPDATE WITH GRANT OPTION' 。

表9-42显示了那些判断一个对象是否在当前模式搜索路径中可见的函数。如果一个表所在的模式在搜索路径中，并且没有同名的表出现在搜索路径的更靠前的地方，那么就说这个表是可见的。它等效于表可以不带明确模式修饰进行引用。比如，要列出所有可见表的名字：

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)将会很方便。例如：

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

请注意用这种方法测试一个未经修饰的名字没什么意义，因为如果一个名字可以被识别，那它首先必须是可见的。

表9-43列出了从系统表中抽取信息的函数。

format_type 通过某个数据类型的类型 OID 以及可能的类型修饰词返回其 SQL 名称。如果不知道具体的修饰词，那么在类型修饰词的位置传入 NULL 。

pg_get_constraintdef, pg_get_indexdef, pg_get_ruledef, pg_get_triggerdef 分别从一个视图、规则、索引、触发器、约束上重新构造创建它们的命令(反编译的重新构造，而不是该命令的原文)。pg_get_expr 反编译一个独立表达式的内部形式，比如一个字段的缺省值。在检查系统表的内容的时候很有用。pg_get_viewdef 重新构造出定义视图的 SELECT 查询。这些函数大多数都有两个变种，其中一个是"适合打印"的结果。这种格式更容易读，但是缺省的格式更有可能被将来的 PostgreSQL 版本用同样的方法解释；如果是用于转储，那么尽可能避免使用"适合打印"的格式。给 pretty_bool 参数传递 false 生成的结果和那个没有这个参数的变种生成的结果是完全一样。

pg_get_serial_sequence 抓取与一个字段相关的序列名字，如果没有任何序列与给定的字段相关则返回 NULL 。这个名字经过了合适的格式化，可以传递给序列函数(参阅节9.12)。这种相关性可以通过 ALTER SEQUENCE OWNED BY 修改或删除。其实将这个函数命名为 pg_get_owned_sequence 或许更为妥当，因为这个名字反映了它通常用于 serial 或 bigserial 字段的事实。

pg_get_userbyid 通过角色的 OID 抽取对应的用户名。

pg_tablespace_databases 允许检查一个表空间的状况，它返回在该表空间中保存了对象的数据库 OID 集合。如果这个函数返回数据行，那么该表空间就是非空的，因此不能删除。要显示该表空间中的特定对象，你需要把 pg_tablespace_databases 返回的数据库标识与 pg_class 表连接进行查询。

表9-44显示的函数将原来用 COMMENT 命令存储的评注抽取出来。如果没有找到，则返回 NULL 。

col_description 返回一个表中字段的评注，它是通过表 OID 和字段号来声明的。obj_description 不能用于表字段，因为字段没有自己的 OID 。

带有两个参数的 obj_description 返回一个数据库对象的评注，该对象是通过其 OID 和其所属的系统表名字声明的。比如，obj_description(123456,'pg_class') 将返回 OID 为 12345 的表的评注。只带一个参数的 obj_description 只要求对象 OID ，现在已经废弃了，因为我们不再保证 OID 在不同的系统表之间是唯一的，因此可能会返回错误的评注。

shobj_description 和 obj_description 差不多，不同之处仅在于前者用于共享对象。一些系统表是通用于集群中所有数据库的全局表，因此这些表的评注也是全局存储的。