↑↓ 选择 ↵ 打开 ⌫ 改范围 完整检索页

pgsql.cc 提供对 postgresql.org 官网内容的中文翻译,由 Pigsty 团队维护。

文档 / 对象标识符类型 / 对象名称别名

regprocedure

函数签名别名

通过函数名称和参数类型输入和显示 OID,可以区分重载。

当前查看 PostgreSQL 18.6。

说明

带参数类型的函数。

引用目录
pg_proc
表示对象
带参数类型的函数
输入值示例
sum(int4)

存储与取值范围

对象标识符(OID)在 PostgreSQL 内部被用作若干系统表的主键。类型 oid 表示一个对象标识符。此外还有若干 oid 的别名类型,其名称均形如 reg something。 表 8.26 给出了概要说明。

oid 类型目前实现为无符号 4 字节整数。因此,在大型数据库中,它不足以提供数据库范围内的唯一性,甚至在大型的单个表中也无法保证唯一性。

oid 类型本身除比较之外几乎没有其他操作。不过,它可以转换为整数,然后再用标准整数操作符进行处理。(这样做时要注意有符号与无符号可能造成的混淆。)

名称解析与搜索路径

OID 别名类型除了专门的输入和输出例程外,没有自己的操作。这些例程能够接受并显示系统对象的符号名称,而不是 oid 类型所使用的原始数值。别名类型简化了对象 OID 值的查找。例如,要查看与表 mytable 相关的 pg_attribute 行,可以写成:

SELECT * FROM pg_attribute WHERE attrelid = 'mytable'::regclass;

而不是:

SELECT * FROM pg_attribute
  WHERE attrelid = (SELECT oid FROM pg_class WHERE relname = 'mytable');

虽然这样看起来也不算太糟,但其实仍然过于简化。如果不同模式中有多个名为 mytable 的表,就必须写一个复杂得多的子查询来选出正确的 OID。 regclass 的输入转换器会按照模式路径设置来处理表查找,因此能够自动完成 “正确的事情”。同样,把表的 OID 转换成 regclass,也很适合用来以符号形式显示数值 OID。

所有按命名空间分组的对象对应的 OID 别名类型,都接受模式限定名称;如果某对象在当前搜索路径下未经限定就无法找到,则其输出也会显示为模式限定名称。例如, myschema.mytable 可作为 regclass 的输入(前提是确有此表)。该值输出时可能是 myschema.mytable,也可能只是 mytable,具体取决于当前搜索路径。 regproc 和 regoper 只接受唯一(未重载)的输入名称,因此用途有限;多数情况下, regprocedure 或 regoperator 更合适。对于 regoperator,可以通过在未使用的操作数位置写入 NONE 来表示一元操作符。

这些类型的输入函数允许在各个词元之间插入空白,并且会把大写字母折叠为小写,双引号内除外;这样做是为了让语法规则更接近 SQL 中书写对象名的方式。反过来,如果需要让输出成为有效的 SQL 标识符,输出函数会自动加上双引号。例如,一个名为 Foo (大写 F)且带两个整数参数的函数,其 OID 可以写成 ' "Foo" ( int, integer ) '::regprocedure。输出则会是 "Foo"(integer,integer)。函数名和参数类型名也都可以带模式限定。

许多内置的 PostgreSQL 函数接受表的 OID 或其他数据库对象的 OID。为了方便,这些函数会被声明为接受 regclass (或相应的 OID 别名类型)参数。这意味着你不必手工查找对象的 OID,只需把对象名写成字符串字面值即可。例如, nextval(regclass) 函数接受一个序列关系的 OID,因此可以这样调用:

nextval('foo')              作用于序列foo
nextval('FOO')              同上
nextval('"Foo"')            作用于序列Foo
nextval('myschema.foo')     作用于myschema.foo
nextval('"myschema".foo')   同上
nextval('foo')              在搜索路径中查找foo

早绑定与后绑定

当你把这类函数的参数写成未经修饰的字符串字面值时,它会变成 regclass (或相应类型)的常量。由于这实际上只是一个 OID,所以即便对象后来被重命名、重新分配到其他模式等,它仍会持续指向最初识别到的对象。这种 “早绑定” 行为,通常很适合列默认值和视图中的对象引用。但有时你可能希望得到 “后绑定” 行为,也就是在运行时再解析对象引用。要实现后绑定,请强制把该常量存储为 text 常量,而不是 regclass:

nextval('foo'::text)      foo运行时被查找

to_regclass() 及其同类函数也可用于执行运行时查找。参见 表 9.76。

从信息模式查找 OID

regclass 的另一个实际用途,是查找 information_schema 视图中列出的表的 OID,而这些视图本身并不直接提供此类 OID。例如,你可能想调用 pg_relation_size() 函数,而它需要表的 OID。综合上述规则,正确的写法是:

SELECT table_schema, table_name,
       pg_relation_size((quote_ident(table_schema) || '.' ||
                         quote_ident(table_name))::regclass)
FROM information_schema.tables
WHERE ...

quote_ident() 函数会在需要时为标识符添加双引号。看起来似乎更简单的写法

SELECT pg_relation_size(table_name)
FROM information_schema.tables
WHERE ...

并不推荐,因为对于搜索路径之外的表,或者名字需要加引号的表,它都会失败。

依赖关系

大多数 OID 别名类型还有一个附加特性,就是会创建依赖关系。如果这些类型的常量出现在存储的表达式中(例如列默认表达式或视图),它就会对被引用对象建立依赖。例如,如果某列的默认表达式是 nextval('my_seq'::regclass), PostgreSQL 就会知道该默认表达式依赖于序列 my_seq,因此系统不允许在尚未移除该默认表达式时删除序列。改用 nextval('my_seq'::text) 则不会建立依赖。(regrole 是这一特性的例外:该类型的常量不允许出现在存储表达式中。)

相关条目

文档与源码

查看来源构建
版本
18.6
构建
PostgreSQL 18.6 手册
来源指纹
8f164426c9777438bfef5614eb8d0576a7e5e559ac2be8ea12bde26b56710b7e

同类条目

返回对象标识符类型 · 此条目的收录范围为 PostgreSQL 10 至 20;起点不一定是实际引入版本。