PostgreSQL 内置函数
PostgreSQL 兼容的 TiDB Cloud Starter 为常见的字符串、数值、日期和时间、聚合、窗口、JSON、数组、正则表达式、序列以及系统操作提供内置函数。
字符串函数
支持以下常见字符串函数:
例如:
SELECT
UPPER('hello') AS upper_text,
LENGTH('PostgreSQL') AS text_length,
CONCAT_WS('-', '2026', '09', '19') AS date_text,
SPLIT_PART('a,b,c', ',', 2) AS second_part;
数学函数
支持以下常见数学函数:
例如:
SELECT
ABS(-42),
ROUND(4.567, 2),
SQRT(16),
POWER(2, 8);
日期和时间函数
支持以下常见日期和时间函数及表达式:
例如:
SELECT
CURRENT_DATE,
NOW(),
DATE_TRUNC('day', NOW()),
EXTRACT(YEAR FROM CURRENT_DATE);
也支持使用 INTERVAL 进行日期和时间运算:
SELECT NOW() - INTERVAL '7 days';
设置示例数据
以下各节中的一些示例会查询示例表。在运行这些示例之前,请先创建所需的表,并将示例数据插入到测试数据库中。
本页中的表定义与其他示例中的表定义不同。如果你的测试数据库中已经包含下方所示名称的表,请为本页使用单独的测试数据库。
CREATE TABLE users (
id INTEGER PRIMARY KEY,
name TEXT,
nickname TEXT,
active BOOLEAN,
score INTEGER
);
CREATE TABLE employees (
id INTEGER PRIMARY KEY,
name TEXT,
department TEXT,
salary NUMERIC
);
CREATE TABLE events (
id INTEGER PRIMARY KEY,
created_at TIMESTAMP
);
CREATE TABLE profiles (
id INTEGER PRIMARY KEY,
settings JSONB
);
INSERT INTO users (id, name, nickname, active, score) VALUES
(1, 'Alice', 'Ali', true, 100),
(2, 'Bob', NULL, false, 0),
(3, 'Charlie', NULL, true, 85);
INSERT INTO employees (id, name, department, salary) VALUES
(1, 'Alice', 'Engineering', 90000),
(2, 'Bob', 'Engineering', 85000),
(3, 'Charlie', 'Sales', 75000);
INSERT INTO events (id, created_at) VALUES
(1, '2026-09-01 10:00:00'),
(2, '2026-09-02 11:00:00'),
(3, '2026-09-03 12:00:00');
INSERT INTO profiles (id, settings) VALUES
(1, '{"theme": "dark", "active": true}'::jsonb),
(2, '{"theme": "light", "active": false}'::jsonb);
在执行基于表的示例之前,请先运行一次上述设置。使用字面量值的示例则不需要任何设置。
聚合函数
支持以下常见聚合函数:
例如:
SELECT
department,
COUNT(*) AS employee_count,
AVG(salary) AS average_salary,
MAX(salary) AS maximum_salary
FROM employees
GROUP BY department;
支持聚合 FILTER:
SELECT
COUNT(*) AS total,
COUNT(*) FILTER (WHERE active = true) AS active_count
FROM users;
窗口函数
与 PostgreSQL 兼容的 TiDB Cloud Starter 支持常见的排名窗口函数和值访问窗口函数。
排名函数
ROW_NUMBER()RANK()DENSE_RANK()NTILE()PERCENT_RANK()CUME_DIST()
例如:
SELECT
name,
department,
salary,
RANK() OVER (
PARTITION BY department
ORDER BY salary DESC
) AS salary_rank
FROM employees;
值访问函数
LAG()LEAD()FIRST_VALUE()LAST_VALUE()NTH_VALUE()
例如:
SELECT
id,
created_at,
LAG(created_at) OVER (ORDER BY created_at) AS previous_created_at
FROM events;
作为窗口函数的聚合函数
以下聚合函数可以与 OVER 子句一起使用:
SUMAVGCOUNTMINMAXSTRING_AGG
例如:
SELECT
department,
name,
salary,
AVG(salary) OVER (PARTITION BY department) AS department_average
FROM employees;
其他聚合函数不能用作窗口函数。
JSON 和 JSONB 函数
支持以下常见 JSON 和 JSONB 函数:
例如:
SELECT
JSONB_TYPEOF('{"a":1}'::jsonb),
JSONB_BUILD_OBJECT('name', 'Alice', 'active', true),
JSONB_ARRAY_LENGTH('[1,2,3]'::jsonb);
JSON 运算符
支持常见的 PostgreSQL JSON 和 JSONB 运算符,包括:
例如:
SELECT settings->>'theme'
FROM profiles
WHERE settings @> '{"active":true}';
数组函数
支持以下常见数组函数:
例如:
SELECT
ARRAY_LENGTH(ARRAY['a', 'b', 'c'], 1),
ARRAY_APPEND(ARRAY['a', 'b'], 'c'),
ARRAY_POSITION(ARRAY['a', 'b', 'c'], 'b');
正则表达式函数和操作符
支持以下正则表达式函数:
例如:
SELECT REGEXP_REPLACE(
'foo bar',
'\s+',
' ',
'g'
);
支持以下正则表达式操作符:
例如:
SELECT 'PostgreSQL' ~* 'postgres';
UUID、编码和哈希函数
常见的 UUID、编码和哈希函数包括:
此外,系统内置了额外的与 uuid-ossp 兼容的 UUID 函数,并且可以使用 CREATE EXTENSION "uuid-ossp" 来注册该扩展的元信息。
序列函数
支持以下序列函数:
例如:
CREATE SEQUENCE order_seq START WITH 1000;
SELECT nextval('order_seq');
SELECT currval('order_seq');
SELECT setval('order_seq', 2000);
NEXTVAL 等序列操作是非事务性的。
条件表达式
支持以下 PostgreSQL 条件表达式:
CASECOALESCENULLIFGREATESTLEAST
例如:
SELECT
COALESCE(nickname, name) AS display_name,
NULLIF(score, 0) AS nonzero_score
FROM users;
系统和兼容性函数
常见的 PostgreSQL 兼容系统函数包括:
例如:
SELECT
CURRENT_USER,
CURRENT_DATABASE(),
CURRENT_SCHEMA(),
PG_TYPEOF(42);
返回集合的函数
某些函数会返回多行。
在 FROM 子句中使用 GENERATE_SERIES():
SELECT value
FROM generate_series(1, 5) AS t(value);
UNNEST() 可以展开数组:
SELECT value
FROM unnest(ARRAY['a', 'b', 'c']) AS t(value);
对于某些标量函数和返回集合的函数,函数调用位置可能与 PostgreSQL 不同。为保证可移植性,建议像前面的示例那样,在 FROM 子句中使用返回集合的函数。
扩展特定函数
以下能力提供了额外的 SQL 函数:
- 向量搜索和向量嵌入
- 全文搜索
- HTTP 请求
- Parquet 导入
- UUID 生成
更多信息,参见PostgreSQL 扩展。