3. SQL语法
该章节描述SQL语法的构成。该章节是后续介绍SQL定义和修改数据的章节的基础。
3.1. 词法结构
SQL输入由一条或多条命令组成。一条命令由一个或多个记号构成,并由分号(“;”)结尾。其中,记号可以是一个关键词、一个标识符、一个带引号的标识符、一个常量或者一个特殊字符符号。每个记号之间通常以空格、制表符或者新行来分隔,但在无歧义时也可不进行分隔(唯一的例子是一个特殊字符紧挨着其他记号)。
例如,下面是一个在语法上合法的SQL输入:
SELECT * FROM MY_TABLE;
UPDATE MY_TABLE SET A = 5;
INSERT INTO MY_TABLE VALUES (3, ‘hi there’);
这是一个由三条命令组成的SQL输入,每一行一条命令(同一行中也可以有多条命令,而且命令还可以被跨行分割)。
另外,注释也可以出现在SQL输入中。它们不属于记号。
根据标识命令、操作符、参数的记号不同,SQL的语法是不一样的。最前面的一些记号通常是命令名称,例如上面的例子中我们通常会说一个“SELECT”、一个“UPDATE”和一个“INSERT”命令。但是UPDATE命令中必须出现SET记号,而INSERT则要求使用VALUES记号。每个命令的详细语法规则在下文介绍。
3.1.1. 标识符和关键词
上例中的SELECT、UPDATE或VALUES记号是关键词的例子,即SQL语言中具有特定意义的词。
记号MY_TABLE和A则属于标识符。它们标识表、列或者其他数据库对象的名字,取决于使用它们的命令。因此它们有时也被简称为“名字”。关键词和标识符具有相同的词法结构。
SQL标识符和关键词必须以一个字母(a-z,也可以是带变音符的字母和非拉丁字母)或一个下划线(_)开始。后续字符可以是字母、下划线(_)、数字(0-9)或美元符号($)。需要注意的是根据SQL标准的字母规定,美元符号是不允许出现在标识符中的,因此使用美元符号可能会降低应用的可移植性。SQL标准不会定义包含数字或者以下划线开头或结尾的关键词,因此这种形式的标识符不会与未来可能的标准扩展冲突 。
系统中一个标识符的长度不能超过 NAMEDATALEN-1 字节,在命令中可以写超过此长度的标识符,但是它们会被截断。默认情况下,NAMEDATALEN 的值为64,因此标识符的长度上限为63字节。关键词和不被引号修饰的标识符是大小写不敏感的。因此:
UPDATE MY_TABLE SET A = 5;
可以等价地写成:
uPDaTE my_TabLE SeT a = 5;
常见的习惯是将关键词写成大写,而名称写成小写,例如:
UPDATE my_table SET a = 5;
这里还有第二种形式的标识符:受限标识符或引用标识符。这种标识符是由双引号(”)包围的一个任意字符序列。一个受限标识符总是一个标识符,不可能是一个关键字。因此”select”可以用于引用一个名为“select”的列或者表,而一个没有引号修饰的select则会被当作一个关键字。在上例中使用受限标识符的例子如下:
UPDATE “my_table” SET “a” = 5;
受限标识符可以包含除NUL之外的任意字符(NUL是ASCII字符集中第一个字符)。如果要包含一个双引号,则写两个双引号。这使得可以使用原本不被允许的表名或列名,例如包含空格或&的名字。但是长度依然有限制。
受限标识符也可以实现其区分大小写的作用。未使用引号引用的名称始终转化为小写。例如,瀚高数据库认为标识符FOO,foo和“foo”相同,但“Foo”和“FOO”与这三者不同。(在瀚高数据库中将未引用的名称转化为小写与SQL标准不兼容,SQL标准规定未引用的名称应转化为大写。因此,根据标准,foo应该等同于“FOO”而不是“foo”。因此在编写可移植的应用程序时,建议总是引用一个特定的名字,或者不使用引用标识符。)
另一种受限标识符的形式允许包含用代码点标识转义的Unicode字符。这种形式以U&(大写或小写U跟上一个&)开始,后面紧跟双引号引用的名称,两者之间没有任何空白,如U&”foo”。在引号内,Unicode字符可以以转义的形式指定:反斜线加上4位16进制代码点编号或者反斜线和加号加上6位16进制代码点编号。例如,标识符”data”可以写成:
U&”d\0061t+000061”
下面的例子用西里尔字母写出了俄语单词 “slon”(大象):
U&”\0441\043B\043E\043D”
如果希望使用其他转义字符来代替反斜线,可以在字符串后使用UESCAPE子句,例如:
U&”d!0061t!+000061” UESCAPE ‘!’
转义字符可以是除了16进制位、加号、单引号、双引号、空白字符之外的任意单个字符。注意转义字符是写在单引号而不是双引号内。
如果需要在标识符中包括转义字符本身,将其写两次即可。
如果服务器编码不是UTF8,这些转义的Unicode码将被转换为实际的服务器编码,如果无法转换数据库将会报错。
3.1.2. 常量
在瀚高数据库中有三种隐式常量:字符串、位串和数字。常量也可以被显式指定,这样可以更准确高效的使用该常量。
3.1.2.1. 字符串常量
在SQL中,一个字符串常量是一个由单引号(’)引用的任意字符序列,例如’This is a string’。为了在一个字符串中包括一个单引号,可以写两个相连的单引号,例如’Dianne’’s horse’。注意这和一个双引号(”)不同。
两个只由空白及至少一个新行分隔的字符串常量会被连接在一起,并且将作为一个写在一起的字符串常量来对待。例如:
SELECT ‘foo’
‘bar’;
等同于:
SELECT ‘foobar’;
但是:
SELECT ‘foo’ ‘bar’;
则不是合法的语法。
3.1.2.2. C风格转义的字符串常量
瀚高数据库也支持“转义”字符串常量,这也是SQL标准的一个扩展。一个转义字符串常量可以通过在开单引号前面写一个字母E(大写或小写形式)来指定,例如E’foo’(当一个转义字符串常量跨行时,只在第一个开引号之前写E)。在一个转义字符串内部,一个反斜线字符(\)会开始一个 C 风格的反斜线转义序列,在其中反斜线和后续字符的组合表示一个特殊的字节值(如下表所示)。
表 1.1 反斜线转义序列
反斜线转义序列 | 解释 |
---|---|
\b | 退格 |
\f | 换页 |
\n | 换行 |
\r | 回车 |
\t | 制表符 |
\o, \oo, \ooo (o = 0 - 7) | 八进制字节值 |
\xh, \xhh (h = 0 - 9, A - F) | 十六进制字节值 |
\uxxxx, \Uxxxxxxxx (x = 0 - 9, A - F) | 16 或 32-位十六进制 Unicode 字符值 |
跟随在一个反斜线后面的任何其他字符被当做其字面意思。因此,要包括一个反斜线字符,请写两个反斜线(\\)。在一个转义字符串中包括一个单引号除了普通方法’’之外,还可以写成\‘。
请确保创建的字节序列由服务器字符集编码中合法的字符组成,特别是在使用八进制或十六进制转义时。或者使用 Unicode 转义或可替代的 Unicode 转义语法(在第 1.1.2.3 节中解释),服务器将检查字符转换的可能性。
注意 |
---|
如果配置参数standard_conforming_strings为off,那么瀚高数据库对常规字符串常量和转义字符串常量中的反斜线转义都识别。在瀚高数据库中该参数的默认值为on,意味着只在转义字符串常量中识别反斜线转义。 除standard_conforming_strings之外,配置参数escape_string_warning和backslash_quote也决定了如何对待字符串常量中的反斜线 |
NUL字符不能出现在字符串常量中。
3.1.2.3. 带有 Unicode 转义的字符串常量
瀚高数据库也支持另一种类型的字符串转义语法,它允许用代码点指定任意 Unicode字符。一个 Unicode 转义字符串常量开始于U&(大写或小写形式的字母 U,后跟&),后面紧跟着开引号,之间没有任何空白,例如U&’foo’。在引号内,Unicode 字符可以使用反斜线加一个4位十六进制代码点编号或者反斜线和一个加号加一个6位十六进制代码点编号来指定。例如,字符串’data’可以被写为:
U&’d\0061t+000061’
下面的例子用西里尔字母写出了俄语的单词“slon”(大象):
U&’\0441\043B\043E\043D’
如果想要一个不是反斜线的转义字符,可以在字符串之后使用UESCAPE子句来指定,例如:
U&’d!0061t!+000061’ UESCAPE ‘!’
转义字符可以是除了16进制位、加号、单引号、双引号、空白字符之外的任意单个字符。注意转义字符是写在单引号而不是双引号内。
如果需要在标识符中包括转义字符本身,将其写两次即可。
如果服务器编码不是UTF8,这些转义的Unicode码将被转换为实际的服务器编码,如果无法转换数据库将会报错。
另外,只有当配置参数standard_conforming_strings为on时,用于字符串常量的 Unicode 转义语法才能工作。如果这个参数被设置为关闭,这种语法将被拒绝并且报告一个错误消息。
3.1.2.4. 美元引用的字符串常量
虽然用于指定字符串常量的标准语法通常都很方便,但是当字符串中包含了很多单引号或反斜线时可读性会很差。针对这种情况瀚高数据库提供了另一种被称为“美元引用”的方式来书写字符串常量。一个美元引用的字符串常量由一个美元符号($)、一个可选的零个或多个字符组成的“标签”、另一个美元符号、一个构成字符串内容的任意字符序列、一个美元符号、与开始时相同的标签和一个美元符号组成。例如,这里有两种不同的方法使用美元引用指定字符串“Dianne’s horse”:
$$Dianne’s horse$$
$SomeTag$Dianne’s horse$SomeTag$
注意在美元引用字符串中,单引号可以在不被转义的情况下使用。事实上,在一个美元引用字符串中不需要对字符进行转义:字符串内容总是按其字面意思写出。反斜线不属于特殊的字符。
可以通过在每一个嵌套级别上选择不同的标签来嵌套美元引用字符串常量。这种写法常用于编写函数定义上。例如:
$function$
BEGIN
RETURN ($1 ~ $q$[\t\r\n\v\\]$q$);
END;
$function$
这里,序列$q$[\t\r\n\v\\]$q$表示一个美元引用的文字串[\t\r\n\v\\],当该函数体被瀚高数据库执行时可以被识别。但是因为该序列不匹配外层的美元引用的定界符$function$,它只是一些在外层字符串所关注的常量中的字符而已。
一个美元引用字符串的标签不能包含美元符号。标签是大小写敏感的,因此$tag$String content$tag$是正确的,但是$TAG$String content$tag$不正确。
关键字或标识符后的美元引用字符串必须用空白与之分隔开,否则美元引用定界符可能会被作为前面标识符的一部分。
美元引用不是 SQL 标准的一部分,但是在书写复杂字符串文字方面,它常常是一种比兼容标准的单引号语法更方便的方法。当要表示的字符串常量位于其他常量中时它特别有用,这种情况常常在过程函数定义中出现。如果用单引号语法,上一个例子中的每个反斜线将必须被写成四个反斜线。
3.1.2.5. 位串常量
位串常量的写法类似常规字符串常量在开引号之前(中间无空白)加了一个B(大写或小写形式),例如B’1001’。位串常量中允许的字符只有0和1。
位串常量的另一种写法是用十六进制记号法指定,使用一个前导X(大写或小写形式),例如X’1FF’。这种记号法等价于一个用四个二进制位取代每个十六进制位的位串常量。
两种形式的位串常量可以以常规字符串常量相同的方式跨行继续。美元引用不能被用在位串常量中。
3.1.2.6. 数字常量
在以下形式中可以接受数字常量:
digits
digits.[digits][e[+-]digits]
[digits].digits[e[+-]digits]
digitse[+-]digits
其中digits是一个或多个十进制数字(0 到 9)。如果使用了小数点,在小数点前面或后面必须至少有一个数字。如果存在一个指数标记(e),在其后必须跟着至少一个数字。在该常量中不能嵌入任何空白或其他字符。注意任何数字前面的加号或减号不作为常量的一部分,它会被看作是一个应用到该常量的操作符。
这些是合法数字常量的例子:
42
3.5
\4.
.001
5e2
1.925e-3
一个不包含小数点和指数的数字常量的值如果适合类型integer(32 位),该常量会首先被假设为类型integer。如果该常量的值不适合integer但是适合类型bigint(64 位),则被假设为类型bigint。如果integer和bigint都不适合,则被假设为类型numeric。包含小数点和/或指数的常量总是首先被假设为类型numeric。
一个数字常量初始指派的数据类型只是类型转换算法的一个起点。在大部分情况中,常量将根据上下文自动被强制转换为最合适的类型。必要时,可以强制将一个数字常量指定为某种特定的数据类型。例如,如下命令可以将1.23指定为类型real(float4):
REAL ‘1.23’ – string style
1.23::REAL
3.1.2.7. 其他类型的常量
可以使用以下任一表示法输入任意类型的常量:
type ‘string’
‘string’::type
CAST ( ‘string’ AS type )
字符串常量的文本被传递到名为type的类型的输入转换程序中。如果对该常量的类型没有歧义(例如,当它被直接指派给一个表列时),显式类型可以被忽略。
字符串常量可以使用常规 SQL 记号或美元引用书写。也可以使用一个类似函数的语法来指定一个强制类型:
typename ( ‘string’ )
但是并非所有类型名都可以用在这种方法中,详见第 3.2.9 节。
如第 3.2.9 节中讨论的,::、CAST()以及函数调用语法也可以被用来指定任意表达式的运行时类型转换。要避免语法歧义,type ‘string’语法只能被用来指定简单文字常量的类型。type ‘string’语法上的另一个限制是它无法对数组类型工作,指定一个数组常量的类型可使用::或CAST()。
CAST()语法符合 SQL。type ‘string’语法是该标准的一般化:SQL 指定这种语法只用于部分数据类型,但是瀚高数据库允许它用于所有类型。带有::的语法是瀚高数据库的历史用法,就像函数调用语法一样。
3.1.3. 操作符
一个操作符名是最多NAMEDATALEN-1(默认为 63)的一个字符序列,其中的字符包括:
+ - * / < > = ~ ! @ # % ^ & | ` ?
不过,在操作符名上有一些限制:
• – 和 /*不能作为操作符名,因为它们将被作为一段注释的开始。
• 一个多字符操作符名不能以+或-结尾,除非该名称也至少包含这些字符中的一个:
~ ! @ # % ^ & | ` ?
例如,@-是一个被允许的操作符名,但*-不是。
当使用非 SQL 标准的操作符名时,通常需要用空格分隔相邻的操作符来避免歧义。例如,如果你定义了一个名为@的左一元操作符,你不能写X*@Y,你必须写X* @Y来确保瀚高数据库把它读作两个操作符名而不是一个。
3.1.4. 特殊字符
一些不是数字字母的字符有一种不同于作为操作符的特殊含义。这些字符的详细用法可以在描述相应语法元素的章节了解到。这一节只做简单介绍。
• 跟随在一个美元符号($)后面的数字被用来表示在一个函数定义或一个预备语句中的位置参数。在其他上下文中该美元符号可以作为一个标识符或者一个美元引用字符串常量的一部分。
• 圆括号(())具有它们通常的含义,用来分组表达式并且强制优先。在某些情况中,圆括号被要求作为一个特定 SQL 命令的固定语法的一部分。
• 方括号([])被用来选择一个数组中的元素。更多关于数组的信息见第 7.15 节。
• 逗号(,)被用在某些语法结构中来分割一个列表的元素。
• 分号(;)结束一个 SQL 命令。它不能出现在一个命令中间的位置,但是可以在一个字符串常量中或者一个被引用的标识符中使用。
• 冒号(:)被用来从数组中选择“切片”(见第 7.15 节)。在某些 SQL 的“方言”(例如嵌入式 SQL)中,冒号被用来作为变量名的前缀。
• 星号(*)被用在某些上下文中标记一个表的所有域或者组合值。当它被用作一个聚集函数的参数时,它还有一种特殊的含义,即该聚集不要求任何显式参数。
• 句点(.)被用在数字常量中,也被用来分割模式、表和列名。
3.1.5. 注释
一段注释是以双斜线开始并且延伸到行结尾的一个字符序列,例如:
– This is a standard SQL comment
另外,也可以使用 C 风格注释块:
/* multiline comment
* with nesting: /* nested block comment */
*/
这里该注释开始于/*并且延伸到匹配出现的*/。这些注释块可按照 SQL 标准中指定的方式嵌套,但和 C 中不同。这样我们可以注释掉一大段可能包含注释块的代码。
在进一步的语法分析前,注释会被从输入流中被移除并且实际被替换为空白。
3.1.6. 操作符优先级
下表显示了瀚高数据库中操作符的优先级和结合性。大部分操作符具有相同的优先级并且是左结合的。操作符的优先级和结合性被写在解析器中。
表 1.2 操作符优先级(从高到低)
操作符/元素 | 结合性 | 描述 |
---|---|---|
. | 左 | 表/列名分隔符 |
:: | 左 | 瀚高数据库特有的类型转换 |
[ ] | 左 | 数组元素选择 |
+ - | 右 | 一元加、一元减 |
^ | 左 | 指数 |
* / % | 左 | 乘、除、模 |
+ - | 左 | 加、减 |
(任意其他操作符) | 左 | 所有其他本地以及用户定义的操作符 |
BETWEEN IN LIKE ILIKE SIMILAR | 范围包含,设置成员,字符串匹配 | |
< > = <= >= <> | 比较操作符 | |
IS ISNULL NOTNULL | IS TRUE、IS FALSE、IS NULL、IS DISTINCT FROM等 | |
NOT | 右 | 逻辑非 |
AND | 左 | 逻辑与 |
OR | 左 | 逻辑或 |
注意该操作符规则也适用于与上述内置操作符具有相同名称的用户定义的操作符。例如,如果你为某种自定义数据类型定义了一个“+”操作符,它将具有和内置的“+”操作符相同的优先级,不管你的操作符要做什么。
当一个模式限定的操作符名被用在OPERATOR语法中时,如下面的例子:
SELECT 3 OPERATOR(pg_catalog.+) 4;
OPERATOR结构被用来为“任意其他操作符”获得上表中默认的优先级。不管出现在OPERATOR()中的是哪个指定操作符都是如此。
3.2. 值表达式
值表达式被用于各种各样的环境中,例如在SELECT命令的目标列表中、作为INSERT或UPDATE中的新列值或者若干命令中的搜索条件。为了区别于一个表表达式(是一个表)的结果,一个值表达式的结果有时候被称为一个标量。值表达式因此也被称为标量表达式(或者甚至简称为表达式)。表达式语法允许使用算数、逻辑、集合和其他操作从原始部分计算值。
一个值表达式是下列之一:
• 一个常量或文字值
• 一个列引用
• 在一个函数定义体或预备语句中的一个位置参数引用
• 一个下标表达式
• 一个域选择表达式
• 一个操作符调用
• 一个函数调用
• 一个聚集表达式
• 一个窗口函数调用
• 一个类型转换
• 一个排序规则表达式
• 一个标量子查询
• 一个数组构造器
• 一个行构造器
• 另一个在圆括号(用来分组子表达式以及重载优先级)中的值表达式
在这个列表之外,还有一些结构可以被分类为一个表达式,但是它们不遵循任何一般语法规则。这些通常具有一个函数或操作符的语义并且在第 8 章中的合适位置解释。一个例子是IS NULL子句。
我们已经在第 3.1.2 节中讨论过常量。下面的小节会讨论剩下的选项。
3.2.1. 列引用
一个列可以以下面的形式被引用:
correlation.columnname
correlation是一个表(有可能以一个模式名限定)的名字,或者是在FROM子句中为一个表定义的别名。如果列名在当前索引所使用的表中都是唯一的,关联名称和分隔用的“.”可以被忽略(另见第 5 章)。
3.2.2. 位置参数
一个位置参数引用被用来指示一个由 SQL 语句外部提供的值。参数被用于 SQL 函数定义和预备查询中。某些客户端库还支持独立于 SQL 命令字符串来指定数据值,在这种情况中参数被用来引用那些行外数据值。一个参数引用的形式是:
$number
例如,考虑一个函数dept的定义:
CREATE FUNCTION dept(text) RETURNS dept
AS $$ SELECT * FROM dept WHERE name = $1 $$
LANGUAGE SQL;
这里$1引用函数被调用时第一个函数参数的值。
3.2.3. 下标
如果一个表达式得到了一个数组类型的值,那么可以抽取出该数组值的一个特定元素:
expression[subscript]
或者抽取出多个相邻元素(一个“数组切片”):
expression[lower_subscript:upper_subscript]
(这里,方括号[ ]表示其字面意思)。每一个下标自身是一个表达式,它必须得到一个整数值。
通常,数组表达式必须被加上括号,但是当要被加下标的表达式只是一个列引用或位置参数时,括号可以被忽略。还有,当原始数组是多维时,多个下标可以被连接起来。例如:
mytable.arraycolumnΒ]
mytable.two_d_column⎜]⎮]
$1⎖:42]
(arrayfunction(a,b))⎶]
最后一个例子中的圆括号是必需的。详见第 7.15 节。
3.2.4. 域选择
如果一个表达式得到一个组合类型(行类型)的值,那么可以抽取该行的指定域
expression.fieldname
通常行表达式必须被加上括号,但是当该表达式是仅从一个表引用或位置参数选择时,圆括号可以被忽略。例如:
mytable.mycolumn
$1.somecolumn
(rowfunction(a,b)).col3
(因此,一个被限定的列引用实际上只是域选择语法的一种特例)。一种重要的特例是从一个组合类型的表列中抽取一个域:
(compositecol).somefield
(mytable.compositecol).somefield
这里需要圆括号来显示compositecol是一个列名而不是一个表名,在第二种情况中则是显示mytable是一个表名而不是一个模式名。
你可以通过书写.*来请求一个组合值的所有域:
(compositecol).*
这种记法的行为根据上下文会有不同,详见第 7.16.5 节。
3.2.5. 操作符调用
对于一次操作符调用,有三种可能的语法:
expression operator expression(二元中缀操作符)
operator expression(一元前缀操作符)
expression operator(一元后缀操作符)
其中operator记号遵循第 3.1.3 节的语法规则,或者是关键词AND、OR和NOT之一,或者是一个如下形式的受限定操作符名:
OPERATOR(schema.operatorname)
哪个特定操作符存在以及它们是一元的还是二元的取决于由系统或用户定义的那些操作符。第 8 章描述了内建操作符。
3.2.6. 函数调用
一个函数调用的语法是一个函数的名称(可能受限于一个模式名)后面跟上封闭于圆括号中的参数列表:
function_name ([expression [, expression … ]] )
例如,下面会计算 2 的平方根:
sqrt(2)
在编写函数调用时应遵守第 9.3 节中的安全防范措施。
内建函数的列表在第 8 章中。其他函数可以由用户增加。
参数可以有选择地被附加名称。详见第 3.3 节。
注意
一个采用单一组合类型参数的函数可以被有选择地称为域选择语法,并且反过来域选择可以被写成函数的风格。也就是说,col(table)和table.col是可以互换的。这种行为是非 SQL 标准的但是在瀚高数据库中被提供,因为它允许函数的使用来模拟“计算域”。详见第 7.16.5 节。
3.2.7. 聚集表达式
一个聚集表达式表示在由一个查询选择的行上应用一个聚集函数。一个聚集函数将多个输入减少到一个单一输出值,例如对输入的求和或平均。一个聚集表达式的语法是下列之一:
aggregate_name (expression [ , … ] [ order_by_clause ] ) [ FILTER
( WHERE filter_clause ) ]
aggregate_name (ALL expression [ , … ] [ order_by_clause ] ) [ FILTER
( WHERE filter_clause ) ]
aggregate_name (DISTINCT expression [ , … ] [ order_by_clause ] ) [ FILTER
( WHERE filter_clause ) ]
aggregate_name ( * ) [ FILTER ( WHERE filter_clause ) ]
aggregate_name ( [ expression [ , … ] ] ) WITHIN GROUP ( order_by_clause )
[ FILTER ( WHERE filter_clause ) ]
这里aggregate_name是一个之前定义的聚集(可能带有一个模式名限定),并且expression是任意自身不包含聚集表达式的值表达式或一个窗口函数调用。可选的order_by_clause和filter_clause描述如下。
第一种形式的聚集表达式为每一个输入行调用一次聚集。第二种形式和第一种相同,因为ALL是默认选项。第三种形式为输入行中表达式的每一个可区分值(或者对于多个表达式是值的可区分集合)调用一次聚集。第四种形式为每一个输入行调用一次聚集,因为没有特定的输入值被指定,它通常只对于count(*)聚集函数有用。最后一种形式被用于有序集聚集函数,其描述如下。
大部分聚集函数忽略空输入,这样其中一个或多个表达式得到空值的行将被丢弃。除非另有说明,对于所有内建聚集都是这样。
例如,count(*)得到输入行的总数。count(f1)得到输入行中f1为非空的数量,因为count忽略空值。而count(distinct f1)得到f1的非空可区分值的数量。
一般地,交给聚集函数的输入行是未排序的。在很多情况中这没有关系,例如不管接收到什么样的输入,min总是产生相同的结果。但是,某些聚集函数(例如array_agg和string_agg)依据输入行的排序产生结果。当使用这类聚集时,可选的order_by_clause可以被用来指定想要的顺序。order_by_clause与查询级别的ORDER BY子句(如第 5.5 节所述)具有相同的语法,除非它的表达式总是仅有表达式并且不能是输出列名称或编号。例如:
SELECT array_agg(a ORDER BY b DESC) FROM table;
在处理多参数聚集函数时,注意ORDER BY出现在所有聚集参数之后。例如,要这样写:
SELECT string_agg(a, ‘,’ ORDER BY a) FROM table;
而不能这样写:
SELECT string_agg(a ORDER BY a, ‘,’) FROM table; – 不正确
后者在语法上是合法的,但是它表示用两个ORDER BY键来调用一个单一参数聚集函数(第二个是无用的,因为它是一个常量)。
如果在order_by_clause之外指定了DISTINCT,那么所有的ORDER BY表达式必须匹配聚集的常规参数。也就是说,你不能在DISTINCT列表没有包括的表达式上排序。
注意
在一个聚集函数中指定DISTINCT以及ORDER BY的能力是一种瀚高数据库扩展。
按照到目前为止的描述,如果一般目的和统计性聚集中排序是可选的,在要为它排序输入行时可以在该聚集的常规参数列表中放置ORDER BY。有一个聚集函数的子集叫做有序集聚集,它要求提供order_by_clause,通常是因为该聚集的计算只对其输入行的特定顺序有意义。有序集聚集的典型例子包括排名和百分位计算。按照上文的最后一种语法,对于一个有序集聚集,order_by_clause被写在 WITHIN GROUP (…)中。order_by_clause中的表达式会像普通聚集参数一样对每一个输入行计算一次,按照每个order_by_clause的要求排序并且交给该聚集函数作为输入参数(这和WITHIN GROUP order_by_clause的情况不同,在其中表达式的结果不会被作为聚集函数的参数)。如果有在WITHIN GROUP之前的参数表达式,会把它们称为直接参数以便与列在 order_by_clause中的聚集参数相区分。与普通聚集参数不同,针对每次聚集调用只会计算一次直接参数,而不是为每一个输入行计算一次。这意味着只有那些变量被GROUP BY 分组时,它们才能包含这些变量。这个限制同样适用于根本不在一个聚集表达式内部的直接参数。直接参数通常被用于百分数之类的东西,它们只有作为每次聚集计算用一次的单一值才有意义。直接参数列表可以为空,在这种情况下,写成() 而不是(*)(瀚高数据库接受两种拼写,但是只有第一种符合 SQL 标准)。
有序集聚集的调用例子:
SELECT percentile_cont(0.5) WITHIN GROUP (ORDER BY income) FROM households;
percentile_cont
-—————-
50489
这会从表households的 income列得到中间值。
如果指定了FILTER,那么只有对filter_clause计算为真的输入行会被交给该聚集函数,其他行会被丢弃。例如:
SELECT
count(*) AS unfiltered,
count(*) FILTER (WHERE i < 5) AS filtered
FROM generate_series(1,10) AS s(i);
unfiltered | filtered
————+———-
10 | 4
(1 row)
预定义的聚集函数在第 8.20 节中描述。其他聚集函数可以由用户增加。
一个聚集表达式只能出现在SELECT命令的结果列表或是HAVING子句中。在其他子句(如WHERE)中禁止使用它,因为那些子句的计算在逻辑上是在聚集的结果被形成之前。
当一个聚集表达式出现在一个子查询中(见第 3.2.11 节和第 8.22 节),聚集通常在该子查询的行上被计算。但是如果该聚集的参数(以及filter_clause,如果有)只包含外层变量,则会产生一个异常:该聚集则属于最近的那个外层,并且会在那个查询的行上被计算。该聚集表达式从整体上则是对其所出现于的子查询的一种外层引用,并且在那个子查询的任意一次计算中都作为一个常量。只出现在结果列表或HAVING子句的限制适用于该聚集所属的查询层次。
3.2.8. 窗口函数调用
一个窗口函数调用表示在一个查询选择的行的某个部分上应用一个聚集类的函数。和非窗口聚集函数调用不同,在查询输出中每一个行仍保持独立。不过,窗口函数能够根据窗口函数调用的分组声明(PARTITION BY列表)访问属于当前行所在分组中的所有行。一个窗口函数调用的语法是下列之一:
function_name ([expression [, expression … ]]) [ FILTER ( WHERE filter_clause
) ] OVER window_name
function_name ([expression [, expression … ]]) [ FILTER ( WHERE filter_clause
) ] OVER ( window_definition )
function_name ( * ) [ FILTER ( WHERE filter_clause ) ] OVER window_name
function_name ( * ) [ FILTER ( WHERE filter_clause ) ] OVER ( window_definition
)
其中window_definition的语法是
[ existing_window_name ]
[ PARTITION BY expression [, …] ]
[ ORDER BY expression [ ASC | DESC | USING operator ] [ NULLS { FIRST | LAST } ]
[, …] ]
[ frame_clause ]
可选的frame_clause是下列之一
{ RANGE | ROWS | GROUPS } frame_start [ frame_exclusion ]
{ RANGE | ROWS | GROUPS } BETWEEN frame_start AND frame_end [ frame_exclusion ]
其中frame_start和frame_end可以是下面形式中的一种
UNBOUNDED PRECEDING
offset PRECEDING
CURRENT ROW
offset FOLLOWING
UNBOUNDED FOLLOWING
而frame_exclusion可以是下列之一
EXCLUDE CURRENT ROW
EXCLUDE GROUP
EXCLUDE TIES
EXCLUDE NO OTHERS
这里,expression表示任何自身不含有窗口函数调用的值表达式。
window_name是对定义在查询的WINDOW子句中的一个命名窗口声明的引用。还可以使用在WINDOW子句中定义命名窗口的相同语法在圆括号内给定一个完整的window_definition,详见SELECT参考页。值得指出的是,OVER wname并不严格地等价于OVER (wname …),后者表示复制并修改窗口定义,并且在被引用窗口声明包括一个子句时会被拒绝。
PARTITION BY选项将查询的行分组成为分区,窗口函数会独立地处理它们。PARTITION BY工作起来类似于一个查询级别的GROUP BY子句,不过它的表达式不能是输出列的名称或编号。如果没有PARTITION BY,该查询产生的所有行被当作一个单一分区来处理。ORDER BY选项决定被窗口函数处理的一个分区中的行的顺序。它工作起来类似于一个查询级别的ORDER BY子句,但是同样不能使用输出列的名称或编号。如果没有ORDER BY,行将被以未指定的顺序被处理。
frame_clause指定构成窗口帧的行集合,它是当前分区的一个子集,窗口函数将作用在该帧而不是整个分区。帧中的行集合会随着哪一行是当前行而变化。在RANGE、ROWS或者GROUPS模式中可以指定帧,在每一种情况下,帧的范围都是从frame_start到frame_end。
如果frame_end被省略,则末尾默认为CURRENT ROW。
UNBOUNDED PRECEDING的一个frame_start表示该帧开始于分区的第一行,类似地UNBOUNDED FOLLOWING的一个frame_end表示该帧结束于分区的最后一行。
在RANGE或GROUPS模式中,CURRENT ROW的一个frame_start表示帧开始于当前行的第一个平级行(被窗口的ORDER BY子句排序为与当前行等效的行),而CURRENT ROW的一个frame_end表示帧结束于当前行的最后一个平级行。在ROWS模式中,CURRENT ROW就表示当前行。
在offset PRECEDING以及offset FOLLOWING帧选项中,offset必须是一个不包含任何变量、聚集函数或者窗口函数的表达式。offset的含义取决于帧模式:
• 在ROWS模式中,offset必须得到一个非空、非负的整数,并且该选项表示帧开始于当前行之前或者之后指定数量的行。
• 在GROUPS模式中,offset也必须得到一个非空、非负的整数,并且该选项表示帧开始于当前行的平级组之前或者之后指定数量的平级组,这里平级组是在ORDER BY顺序中等效的行集合(要使用GROUPS模式,在窗口定义中就必须有一个ORDER BY子句)。
• 在RANGE模式中,这些选项要求ORDER BY子句正好指定一列。offset指定当前行中那一列的值与它在该帧中前面或后面的行中的列值的最大差值。offset表达式的数据类型会随着排序列的数据类型而变化。对于数字的排序列,它通常是与排序列相同的类型,但对于日期时间排序列它是一个interval。例如,如果排序列是类型date或者timestamp,我们可以写RANGE BETWEEN ‘1 day’ PRECEDING AND ‘10 days’ FOLLOWING。offset仍然要求是非空且非负,不过“非负”的含义取决于它的数据类型。
在任何一种情况下,到帧末尾的距离都受限于到分区末尾的距离,因此对于离分区末尾比较近的行来说,帧可能会包含比较少的行。
注意在ROWS以及GROUPS模式中,0 PRECEDING和0 FOLLOWING与CURRENT ROW等效。通常在RANGE模式中,这个结论也成立。
frame_exclusion选项允许当前行周围的行被排除在帧之外,即便根据帧的开始和结束选项应该把它们包括在帧中。EXCLUDE CURRENT ROW会把当前行排除在帧之外。EXCLUDE GROUP会把当前行以及它在顺序上的平级行都排除在帧之外。EXCLUDE TIES把当前行的任何平级行都从帧中排除,但不排除当前行本身。EXCLUDE NO OTHERS只是明确地指定不排除当前行或其平级行的这种默认行为。
默认的帧选项是RANGE UNBOUNDED PRECEDING,它和RANGE BETWEEN UNBOUNDED PRECEDING AND CURRENT ROW相同。如果使用ORDER BY,这会把该帧设置为从分区开始一直到当前行的最后一个ORDER BY平级行的所有行。如果不使用ORDER BY,就意味着分区中所有的行都被包括在窗口帧中,因为所有行都成为了当前行的平级行。
限制是frame_start不能是UNBOUNDED FOLLOWING、frame_end不能是UNBOUNDED PRECEDING,并且在上述frame_start和frame_end选项的列表中“frame_end选择”不能早于“frame_start选择”出现 — 例如不允许RANGE BETWEEN CURRENT ROW AND offset PRECEDING,但允许ROWS BETWEEN 6 PRECEDING AND 8 PRECEDING,虽然它不会选择任何行。
如果指定了FILTER,那么只有对filter_clause计算为真的输入行会被交给该窗口函数,其他行会被丢弃。只有是聚集的窗口函数才接受FILTER 。
瀚高数据库内建有窗口函数。用户可以加入其他窗口函数。此外,任何内建的或者用户定义的通用聚集或者统计性聚集都可以被用作窗口函数。
使用*的语法被用来把参数较少的聚集函数当作窗口函数调用,例如count(*) OVER (PARTITION BY x ORDER BY y)。星号(*)通常不被用于窗口相关的函数。窗口相关的函数不允许在函数参数列表中使用DISTINCT或ORDER BY。
只有在SELECT列表和查询的ORDER BY子句中才允许窗口函数调用。
更多关于窗口函数的信息可以在第 2.5 节、第 8.21 节以及第 5.2.5 节中找到。
3.2.9. 类型转换
一个类型转换指定从一种数据类型到另一种数据类型的转换。瀚高数据库接受两种等价的类型转换语法:
CAST ( expression AS type )
expression::type
CAST语法遵从 SQL,而用::的语法是瀚高数据库的自有用法。
当一个转换被应用到一种未知类型的值表达式上时,它表示一种运行时类型转换。只有已经定义了一种合适的类型转换操作时,该转换才会成功。注意这和常量的转换(如第 3.1.2.6 节中所示)使用不同。应用于一个未修饰串文字的转换表示一种类型到一个文字常量值的初始赋值,并且因此它将对任意类型都成功(如果该串文字的内容对于该数据类型的输入语法是可接受的)。
如果一个值表达式必须产生的类型没有歧义(例如当它被指派给一个表列),通常可以省略显式类型转换,在这种情况下系统会自动应用一个类型转换。但是,只有对在系统目录中被标记为“OK to apply implicitly”的转换才会执行自动转换。其他转换必须使用显式转换语法调用。这种限制是为了防止错误的转换被无声无息地应用。
还可以用像函数的语法来指定一次类型转换:
typename ( expression )
不过,这只对那些名字也作为函数名可用的类型有效。例如,double precision不能以这种方式使用,但是等效的float8可以。还有,如果名称interval、time和timestamp被用双引号引用,那么由于语法冲突的原因,它们只能以这种风格使用。因此,函数风格的转换语法的使用会导致不一致性并且应该尽可能被避免。
注意
函数风格的语法事实上只是一次函数调用。当两种标准转换语法之一被用来做一次运行时转换时,它将在内部调用一个已注册的函数来执行该转换。简而言之,这些转换函数具有和它们的输出类型相同的名字,并且因此“函数风格的语法”无非是对底层转换函数的一次直接调用。显然,一个可移植的应用不应当依赖于它。详见CREATE CAST。
3.2.10. 排序规则表达式
COLLATE子句会重载一个表达式的排序规则。它被追加到它适用的表达式:
expr COLLATE collation
这里collation可能是一个受模式限定的标识符。COLLATE子句比操作符绑得更紧,需要时可以使用圆括号。
如果没有显式指定排序规则,数据库系统会从表达式所涉及的列中得到一个排序规则,如果该表达式没有涉及列,则会默认采用数据库的默认排序规则。
COLLATE子句的两种常见使用是重载ORDER BY子句中的排序顺序,例如: SELECT a, b, c FROM tbl WHERE … ORDER BY a COLLATE “C”;
以及重载具有区域敏感结果的函数或操作符调用的排序规则,例如:
SELECT * FROM tbl WHERE a > ‘foo’ COLLATE “C”;
注意在后一种情况中,COLLATE子句被附加到我们希望影响的操作符的一个输入参数上。COLLATE子句被附加到该操作符或函数调用的哪个参数上无关紧要,因为被操作符或函数应用的排序规则是考虑所有参数得来的,并且一个显式的COLLATE子句将重载所有其他参数的排序规则(不过,附加非匹配COLLATE子句到多于一个参数是一种错误。)。因此,这会给出和前一个例子相同的结果:
SELECT * FROM tbl WHERE a COLLATE “C” > ‘foo’;
但是这是一个错误:
SELECT * FROM tbl WHERE (a > ‘foo’) COLLATE “C”;
因为它尝试把一个排序规则应用到>操作符的结果,而它的数据类型是非可排序数据类型boolean。
3.2.11. 标量子查询
一个标量子查询是一种圆括号内的普通SELECT查询,它刚好返回一行一列(关于书写查询可见第 5 章)。SELECT查询被执行并且该单一返回值被使用在周围的值表达式中。将一个返回超过一行或一列的查询作为一个标量子查询使用是一种错误(但是如果在一次特定执行期间该子查询没有返回行则不是错误,该标量结果被当做为空)。该子查询可以从周围的查询中引用变量,这些变量在该子查询的任何一次计算中都将作为常量。对于其他涉及子查询的表达式还可见第 8.22 节。
例如,下列语句会寻找每个州中最大的城市人口:
SELECT name, (SELECT max(pop) FROM cities WHERE cities.state = states.name)
FROM states;
3.2.12. 数组构造器
一个数组构造器是一个能构建一个数组值并且将值用于它的成员元素的表达式。一个简单的数组构造器由关键词ARRAY、一个左方括号[、一个用于数组元素值的表达式列表(用逗号分隔)以及最后的一个右方括号]组成。例如:
SELECT ARRAYΏ,2,3+4]
array
-——–
ӏ,2,7}
(1 row)
默认情况下,数组元素类型是成员表达式的公共类型,使用和UNION或CASE结构(见第10.5节)相同的规则决定。你可以通过显式将数组构造器转换为想要的类型来重载,例如:
SELECT ARRAYΏ,2,22.6]::integer[]
array
-———
ӏ,2,23}
(1 row)
这和把每一个表达式单独地转换为数组元素类型的效果相同。关于转换的更多信息请见第 3.2.9 节。
多维数组值可以通过嵌套数组构造器来构建。在内层的构造器中,关键词ARRAY可以被忽略。例如,这些语句产生相同的结果:
SELECT ARRAY[ARRAYΏ,2], ARRAYΑ,4]]
array
-————–
{ӏ,2},ӑ,4}}
(1 row)
SELECT ARRAY[Ώ,2],Α,4]]
array
-————–
{ӏ,2},ӑ,4}}
(1 row)
因为多维数组必须是矩形的,处于同一层次的内层构造器必须产生相同维度的子数组。任何被应用于外层ARRAY构造器的转换会自动传播到所有的内层构造器。
多维数组构造器元素不仅仅是一个子结构。例如:
CREATE TABLE arr(f1 int[], f2 int[]);
INSERT INTO arr VALUES (ARRAY[Ώ,2],Α,4]], ARRAY[Γ,6],Δ,8]]);
SELECT ARRAY[f1, f2, ‘{ӗ,10},〗,12}}’::int[]] FROM arr;
array
-———————————————–
{{ӏ,2},ӑ,4}},{ӓ,6},Ӕ,8}},{ӗ,10},〗,12}}}
(1 row)
你可以构造一个空数组,但是因为无法得到一个无类型的数组,你必须显式地把你的空数组转换成想要的类型。例如:
SELECT ARRAY[]::integer[]
array
-——
{}
(1 row)
也可以从一个子查询的结果构建一个数组。在这种形式中,数组构造器被写为关键词ARRAY后跟着一个加了圆括号(不是方括号)的子查询。例如:
SELECT ARRAY(SELECT oid FROM pg_proc WHERE proname LIKE ‘bytea%’);
array
-———————————————————————-
�,1954,1948,1952,1951,1244,1950,2005,1949,1953,2006,31,2412,2413}
(1 row)
SELECT ARRAY(SELECT ARRAY[i, i*2] FROM generate_series(1,5) AS a(i));
array
-———————————
{ӏ,2},Ӑ,4},ӑ,6},Ӓ,8},ӓ,10}}
(1 row)
子查询必须返回一个单一列。如果子查询的输出列是非数组类型,结果的一维数组将为该子查询结果中的每一行赋予一个元素,并且会有一个与子查询的输出列匹配的元素类型。如果子查询的输出列是一种数组类型,结果将是同类型的一个数组,但是要高一个维度。在这种情况下,该子查询的所有行必须产生同样维度的数组,否则结果就不会是矩形形式。
用ARRAY构建的一个数组值的下标总是从1开始。更多关于数组的信息,请见第 7.15 节。
3.2.13. 行构造器
一个行构造器是能够构建一个行值(也称作一个组合类型)并用值作为其成员域的表达式。
一个行构造器由关键词ROW、一个左圆括号、用于行的域值的零个或多个表达式(用逗号分隔)以及最后的一个右圆括号组成。例如:
SELECT ROW(1,2.5,’this is a test’);
当在列表中有超过一个表达式时,关键词ROW是可选的。
一个行构造器可以包括语法rowvalue.*,它将被扩展为该行值的元素的一个列表,就像在一个顶层SELECT列表(见第 7.16.5 节)中使用.*时发生的事情一样。例如,如果表t有列f1和f2,那么这些是相同的:
SELECT ROW(t.*, 42) FROM t;
SELECT ROW(t.f1, t.f2, 42) FROM t;
默认情况下,由一个ROW表达式创建的值是一种匿名记录类型。如果必要,它可以被转换为一种命名的组合类型 — 或者是一个表的行类型,或者是一种用CREATE TYPE AS创建的组合类型。为了避免歧义,可能需要一个显式转换。例如:
CREATE TABLE mytable(f1 int, f2 float, f3 text);
CREATE FUNCTION getf1(mytable) RETURNS int AS ‘SELECT $1.f1’ LANGUAGE SQL;
– 不需要转换因为只有一个 getf1() 存在
SELECT getf1(ROW(1,2.5,’this is a test’));
getf1
-——
1
(1 row)
CREATE TYPE myrowtype AS (f1 int, f2 text, f3 numeric);
CREATE FUNCTION getf1(myrowtype) RETURNS int AS ‘SELECT $1.f1’ LANGUAGE SQL;
– 现在我们需要一个转换来指示要调用哪个函数:
SELECT getf1(ROW(1,2.5,’this is a test’));
ERROR: function getf1(record) is not unique
SELECT getf1(ROW(1,2.5,’this is a test’)::mytable);
getf1
-——
1
(1 row)
SELECT getf1(CAST(ROW(11,’this is a test’,2.5) AS myrowtype));
getf1
-——
11
(1 row)
行构造器可以被用来构建存储在一个组合类型表列中的组合值,或者被传递给一个接受组合参数的函数。还有,可以比较两个行值,或者用IS NULL或IS NOT NULL测试一个行,例如:
SELECT ROW(1,2.5,’this is a test’) = ROW(1, 3, ‘not the same’);
SELECT ROW(table.*) IS NULL FROM table; – detect all-null rows
详见第 8.23 节。如第 8.22 节中所讨论的,行构造器也可以被用来与子查询相连接。
3.2.14. 表达式计算规则
子表达式的计算顺序没有被定义。并且,一个操作符或函数的输入不必按照从左至右或其他任何固定顺序进行计算。
此外,如果一个表达式的结果可以通过只计算其一部分来决定,那么其他子表达式可能完全不需要被计算。例如,如果我们写:
SELECT true OR somefunc();
那么somefunc()将(可能)完全不被调用。如果我们写成下面这样也是一样:
SELECT somefunc() OR true;
注意这和一些编程语言中布尔操作符从左至右的规则不同。
因此,在复杂表达式中不建议使用非必要的函数。尤其在WHERE和HAVING子句中依赖计算顺序,因为在建立一个执行计划时这些子句会被广泛地重新处理。这些子句中布尔表达式(AND/OR/NOT的组合)可能会以布尔代数定律所允许的任何方式被重组。
当有必要强制计算顺序时,可以使用一个CASE结构(见第 8.16 节)。例如,在一个WHERE子句中使用下面的方法尝试避免零被除是不可靠的:
SELECT … WHERE x > 0 AND y/x > 1.5;
但是这是安全的:
SELECT … WHERE CASE WHEN x > 0 THEN y/x > 1.5 ELSE false END;
在这个特别的例子中,最好通过写y > 1.5*x来回避这个问题。
不过,CASE不是这类问题的万灵药。上述技术的一个限制是,它无法阻止常量子表达式的提早计算。当查询被规划而不是被执行时,被标记成 IMMUTABLE的函数和操作符可以被计算。因此 SELECT CASE WHEN x > 0 THEN x ELSE 1/0 END FROM tab; 很可能会导致一次除零失败,因为规划器尝试简化常量子表达式。即便是 表中的每一行都有x > 0(这样运行时永远不会进入到 ELSE分支)也是这样。
虽然这个特别的例子可能看起来愚蠢,没有明显涉及常量的情况可能会发生在函数内执行的查询中,但是函数参数的值和本地变量可以作为常量被插入到查询中用于规划目的。例如,在PL/pgSQL函数 中,使用一个IF-THEN-ELSE语句来保护一种有风险的计算比把它嵌在一个CASE表达式中要安全得多。
另一个同类型的限制是,一个CASE无法阻止其所包含的聚集表达式的计算,因为在考虑SELECT列表或HAVING子句中的其他表达式之前,会先计算聚集表达式。例如,下面的查询会导致一个除零错误,虽然看起来好像已经这种情况加以了保护:
SELECT CASE WHEN min(employees) > 0
THEN avg(expenses / employees)
END
FROM departments;
min()和avg()聚集会在所有输入行上并行地计算, 因此如果任何行有employees等于零,在有机会测试min()的结果之前,就会发生除零错误。取而代之的是,可以使用一个WHERE或FILTER子句来阻止有问题的输入。
3.3. 调用函数
瀚高数据库允许带有命名参数的函数被使用位置或命名记号法调用。命名记号法对于有大量参数的函数特别有用,因为它让参数和实际参数之间的关联更明显和可靠。在位置记号法中,书写一个函数调用时,其参数值要按照它们在函数声明中被定义的顺序书写。在命名记号法中,参数根据名称匹配函数参数,并且可以以任何顺序书写。对于每一种记法,还要考虑函数参数类型的效果,这些在第 9.3 节有介绍。
在任意一种记号法中,在函数声明中给出了默认值的参数根本不需要在调用中写出。但是这在命名记号法中特别有用,因为任何参数的组合都可以被忽略。而在位置记号法中参数只能从右往左忽略。
瀚高数据库也支持混合记号法,它组合了位置和命名记号法。在这种情况中,位置参数被首先写出并且命名参数出现在其后。
下边例子将展示所有三种记号法的用法:
CREATE FUNCTION concat_lower_or_upper(a text, b text, uppercase boolean DEFAULT
false)
RETURNS text
AS
$$
SELECT CASE
WHEN $3 THEN UPPER($1 || ‘ ‘ || $2)
ELSE LOWER($1 || ‘ ‘ || $2)
END;
$$
LANGUAGE SQL IMMUTABLE STRICT;
函数concat_lower_or_upper有两个强制参数,a和b。此外,有一个可选的参数uppercase,其默认值为false。a和b输入将被串接,并且根据uppercase参数被强制为大写或小写形式。
3.3.1. 使用位置记号
在瀚高数据库中,位置记号法是给函数传递参数的传统机制。举个例子:
SELECT concat_lower_or_upper(‘Hello’, ‘World’, true);
concat_lower_or_upper
-———————-
HELLO WORLD
(1 row)
所有参数被按照顺序指定。结果是大写形式,因为uppercase被指定为true。另一个例子:
SELECT concat_lower_or_upper(‘Hello’, ‘World’);
concat_lower_or_upper
-———————-
hello world
(1 row)
这里,uppercase参数被忽略,因此它接收它的默认值false,并导致小写形式的输出。在位置记号法中,参数可以按照从右往左被忽略并且因此而得到默认值。
3.3.2. 使用命名记号
在命名记号法中,每一个参数名都用=> 指定来把它与参数表达式分隔开。例如:
SELECT concat_lower_or_upper(a => ‘Hello’, b => ‘World’);
concat_lower_or_upper
-———————-
hello world
(1 row)
参数uppercase被忽略,因此它被隐式地设置为false。使用命名记号法的一个优点是参数可以用任何顺序指定,例如:
SELECT concat_lower_or_upper(a => ‘Hello’, b => ‘World’, uppercase => true);
concat_lower_or_upper
-———————-
HELLO WORLD
(1 row)
SELECT concat_lower_or_upper(a => ‘Hello’, uppercase => true, b => ‘World’);
concat_lower_or_upper
-———————-
HELLO WORLD
(1 row)
为了向后兼容性,基于 “:=” 的旧语法仍被支持:
SELECT concat_lower_or_upper(a := ‘Hello’, uppercase := true, b := ‘World’);
concat_lower_or_upper
-———————-
HELLO WORLD
(1 row)
3.3.3. 使用混合记号
混合记号法组合了位置和命名记号法。不过,命名参数不能超越位置参数。例如:
SELECT concat_lower_or_upper(‘Hello’, ‘World’, uppercase => true);
concat_lower_or_upper
-———————-
HELLO WORLD
(1 row)
在上述查询中,参数a和b被以位置指定,而uppercase通过名字指定。在一个具有大量带默认值参数的复杂函数中,命名的或混合的记号法可以节省大量的书写并且减少出错的机会.
注意 |
---|
命名的和混合的调用记号法当前不能在调用聚集函数时使用(但是当聚集函数被用作窗口函数时它们可以被使用)。 |