PostgreSQL / 系统课时
对象名称与标识符规则
对象名称与标识符规则
本课解决“明明创建了表却查不到”以及名称大小写混乱的问题。你将理解未加引号标识符会折叠为小写,并建立便于长期维护的命名规范。
学习目标
- 解释未加双引号名称为何会转换为小写
- 正确访问带双引号创建的大小写敏感对象
- 为表、列和约束制定稳定命名规则
未加引号名称会折叠为小写
在 PostgreSQL 中,未使用双引号的标识符会被转换为小写。因此,USER_PROFILE、User_Profile 和 user_profile 在未加引号时都指向 user_profile。
双引号会保留名称的大小写和特殊字符。对象一旦以双引号混合大小写创建,后续每次引用都必须使用完全相同的双引号写法。
验证两类名称的差异
下面脚本创建一个普通小写表和一个带双引号的混合大小写表,再分别查询它们。
DROP TABLE IF EXISTS user_profile;
DROP TABLE IF EXISTS "UserProfile";
CREATE TABLE user_profile (
user_id bigint PRIMARY KEY,
display_name varchar(100) NOT NULL
);
CREATE TABLE "UserProfile" (
"UserID" bigint PRIMARY KEY,
"DisplayName" varchar(100) NOT NULL
);
INSERT INTO user_profile (user_id, display_name)
VALUES (1, '普通命名');
INSERT INTO "UserProfile" ("UserID", "DisplayName")
VALUES (2, '引号命名');
SELECT user_id, display_name
FROM USER_PROFILE;
SELECT "UserID", "DisplayName"
FROM "UserProfile";预期结果
user_id | display_name
---------+--------------
1 | 普通命名
(1 row)
UserID | DisplayName
--------+-------------
2 | 引号命名
(1 row)第一条查询虽然写成 USER_PROFILE,仍会折叠为小写并访问 user_profile。第二张表必须保留双引号和原始大小写,否则会被解释为不存在的 userprofile。
双引号不是字符串引号
标识符使用双引号,例如 "UserProfile";字符串值使用单引号,例如 '普通命名'。把两者混用会导致语法错误或引用错误对象。
双引号还允许空格、短横线和关键字出现在名称中,但这些名称会增加 SQL 编写、迁移工具和跨系统集成的成本。除非兼容旧系统,通常不应主动创建此类对象。
推荐命名规范
表名、列名、索引名和约束名统一使用小写 snake_case,避免依赖双引号。名称应表达业务含义,不使用空格、短横线或含义模糊的缩写。
表名采用单数还是复数并没有数据库层面的强制要求,关键是全项目一致。约束和索引可以使用可追踪前缀,例如 pk_user_profile、uk_user_profile_email 和 idx_user_profile_created_at。
PostgreSQL 默认标识符长度上限为 63 字节,超长名称会被截断。命名应简洁,并把区分度高的信息放在前部。跨模式访问时可写成 schema_name.table_name,避免搜索路径变化导致引用到错误对象。