更新时间:2024-05-07 GMT+08:00

函数

函数类型解析

  1. 从系统表pg_proc中选择所有可能被选到的函数。如果使用了一个不带模式修饰的函数名称,那么认为该函数是那些在当前搜索路径中的函数。如果给出一个带修饰的函数名,那么只考虑指定模式中的函数。

    如果搜索路径中找到了多个不同参数类型的函数。将从中选择一个合适的函数。

  2. 查找和输入参数类型完全匹配的函数。如果找到一个,则用之。如果输入的实参类型都是unknown类型,则不会找到匹配的函数。
  3. 如果未找到完全匹配,请查看该函数是否为一个特殊的类型转换函数。
  4. 寻找最优匹配。
    1. 抛弃那些输入类型不匹配并且也不能隐式转换成匹配的候选函数。unknown文本在这种情况下可以转换成任何东西。如果只剩下一个候选项,则用之,否则继续下一步。
    2. 遍历所有候选函数,保留那些输入类型匹配最准确的。此时,域被看作和它们的基本类型相同。如果没有一个函数能准确匹配,则保留所有候选。如果只剩下一个候选项,则用之,否则继续下一步。
    3. 遍历所有候选函数,保留那些需要类型转换时接受首选类型位置最多的函数。如果没有接受首选类型的函数,则保留所有候选。如果只剩下一个候选项,则用之,否则继续下一步。
    4. 如果有任何输入参数是unknown类型,检查剩余的候选函数对应参数位置的类型范畴。在每一个能够接受字符串类型范畴的位置使用string类型(这种对字符串的偏爱是合适的,因为unknown文本确实像字符串)。另外,如果所有剩下的候选函数都接受相同的类型范畴,则选择该类型范畴,否则抛出一个错误(因为在没有更多线索的条件下无法作出正确的选择)。现在抛弃不接受选定的类型范畴的候选函数,然后,如果任意候选函数在那个范畴接受一个首选类型,则抛弃那些在该参数位置接受非首选类型的候选函数。如果没有一个候选符合这些测试则保留所有候选。如果只有一个候选函数符合,则使用它;否则,继续下一步。
    5. 如果同时有unknown和已知类型的参数,并且所有已知类型的参数有相同的类型,假设unknown参数也是这种类型,检查哪个候选函数可以在unknown参数位置接受这种类型。如果正好一个候选符合,那么使用它。否则,产生一个错误。

示例

示例1:圆整函数参数类型解析。只有一个round函数有两个参数(第一个是numeric,第二个是integer)。所以下面的查询自动把第一个类型为integer的参数转换成numeric类型。

1
2
3
4
5
gaussdb=# SELECT round(4, 4);
 round
--------
 4.0000
(1 row)

实际上它被分析器转换成:

1
gaussdb=# SELECT round(CAST (4 AS numeric), 4);

因为带小数点的数值常量初始时被赋予numeric类型,因此下面的查询将不需要类型转换,并且可能会略微高效一些:

1
gaussdb=# SELECT round(4.0, 4);

示例2:子字符串函数类型解析。有好几个substr函数,其中一个接受text和integer类型。如果用一个未声明类型的字符串常量调用它,系统将选择接受string类型范畴的首选类型(也就是text类型)的候选函数。

1
2
3
4
5
gaussdb=# SELECT substr('1234', 3);
 substr
--------
     34
(1 row)

如果该字符串声明为varchar类型,就像从表中取出来的数据一样,分析器将试着将其转换成text类型:

1
2
3
4
5
gaussdb=# SELECT substr(varchar '1234', 3);
 substr
--------
     34
(1 row)

被分析器转换后实际上变成:

1
gaussdb=# SELECT substr(CAST (varchar '1234' AS text), 3);

分析器从pg_cast表中了解到text和varchar是二进制兼容的,意思是说一个可以传递给接受另一个的函数而不需要做任何物理转换。因此,在这种情况下,实际上没有做任何类型转换。

而且,如果以integer为参数调用函数,分析器将试图将其转换成text类型:

1
2
3
4
5
gaussdb=# SELECT substr(1234, 3);
substr
--------
 34
(1 row)

被分析器转换后实际上变成:

1
2
3
4
5
gaussdb=# SELECT substr(CAST (1234 AS text), 3);
 substr
--------
     34
(1 row)