citext
模块提供了一种大小写不敏感的字符串类型:citext
。特别地,它在比较值时内部调用的是lower
。除此之外,它的行为几乎与text
完全相同。
在PostgreSQL中做大小写不敏感匹配的标准方法曾经是在比较值时使用lower
函数,例如:
SELECT * FROM tab WHERE lower(col) = LOWER(?);
这工作得比较好,但是有一些缺点:
它让你的 SQL 语句冗长,并且你必须总是要记住在列和查询值上使用lower
。
它不会使用一个索引,除非你使用lower
创建一个函数索引。
如果你声明一个列为UNIQUE
或PRIMARY KEY
,隐式生成的索引是大小写敏感的。因此,它对于大小写不敏感的搜索是没有用处的,并且它不会强制大小写不敏感的唯一性。
citext
数据类型允许你在 SQL 查询中消除对lower
的调用,并且允许一个主键是大小写无关的。就和text
一样,citext
是区域相关的,这意味着大写和小写字符的匹配依赖于数据库LC_CTYPE
设置的规则。此外,这种行为和在查询中使用lower
是一样的。但是因为它是由数据类型以透明的方式完成的,你不需要记住在你的查询中做任何特殊的事情。
这里是一个简单的用法示例:
CREATE TABLE users ( nick CITEXT PRIMARY KEY, pass TEXT NOT NULL ); INSERT INTO users VALUES ( 'larry', sha256(random()::text::bytea) ); INSERT INTO users VALUES ( 'Tom', sha256(random()::text::bytea) ); INSERT INTO users VALUES ( 'Damian', sha256(random()::text::bytea) ); INSERT INTO users VALUES ( 'NEAL', sha256(random()::text::bytea) ); INSERT INTO users VALUES ( 'Bjørn', sha256(random()::text::bytea) ); SELECT * FROM users WHERE nick = 'Larry';
即使nick
列被设置为larry
而查询是Larry
,SELECT
语句也将只返回一个元组。
citext
执行比较时先将每一个串转换成小写形式(调用lower
)然后正常地比较结果。因此,如果两个串通过lower
产生相同的结果,它们就被认为是相等。
为了尽可能接近地模拟一种大小写不敏感的排序规则,一些串处理操作符和函数有citext
相关的版本。例如,当应用到citext
时,正则表达式操作符~
和~*
会展现出相同的行为:它们都以大小写不敏感的方式匹配。!~
和!~*
也是一样,以及LIKE
操作符~~
和~~*
,以及!~~
和!~~*
。如果你想以大小写敏感的方式匹配,你可以把该操作符的参数造型成text
。
相似地,如果下列函数的参数是citext
,它们会以大小写不敏感的方式执行匹配:
regexp_match()
regexp_matches()
regexp_replace()
regexp_split_to_array()
regexp_split_to_table()
replace()
split_part()
strpos()
translate()
对于 regexp 函数,如果你想要以大小写敏感的方式匹配,你可以指定“c”标志来强制大小写敏感的匹配。否则,如果你想要大小写敏感的行为,你必须在使用这些函数之一之前造型到text
。
citext
的大小写折叠行为取决于你的数据库的LC_CTYPE
设置。因此它如何比较值是在数据库被创建时决定的。在 Unicode 标准定义的术语中没有真正的大小写不敏感。实际上,它的含义是,只要你对你的排序规则满意,你就应该对citext
的比较满意。但是如果在你的数据库中存储有不同语言的数据,当排序规则是用于一种语言时,另一种语言的用户可能会发现他们的查询结果并不是所期待的。
自PostgreSQL 9.1 其,你可以为citext
列或数据值附加一个COLLATE
说明。当前,在比较大小写折叠过的字符串时,citext
操作符将尊重一种非默认的COLLATE
说明,但是最初到小写形式的折叠是根据数据库的 LC_CTYPE
设置完成的(就是说,尽管给出了COLLATE "default"
)。这可能在未来的发行中被改变,这样两步都能遵循输入的COLLATE
说明。
citext
的效率不如text
,因为操作符函数和 B 树比较函数必须创建数据的拷贝并且将它转换为小写形式来进行比较。不过,它比使用lower
进行大小写不敏感的匹配的效率要略高。
如果你在某些环境下需要以大小写敏感的方式比较数据并且在另一些环境下需要以大小写不敏感的方式比较数据,citext
就帮不上什么忙。标准的答案是使用text
类型并且在你需要以大小写不敏感的方式比较时手工使用lower
函数。如果大小写不敏感的比较需求不频繁,这会工作得不错。如果你大部分时间需要大小写不敏感的行为,考虑将数据存储为citext
并且在进行大小写敏感比较时显式地将列造型为text
。不管在那种情况下,你都需要两个索引来让两种类型的搜索更快。
包含citext
操作符的模式必须在当前的search_path
(通常是public
)中。如果它不在搜索路径中,普通的大小写敏感的text
操作符将会取而代之。