acl
ACL数据类型
概览
| 扩展包名 | 版本 | 分类 | 许可证 | 语言 |
|---|---|---|---|---|
pg_acl | 1.0.4 | TYPE | BSD 2-Clause | C |
| ID | 扩展名 | Bin | Lib | Load | Create | Trust | Reloc | 模式 |
|---|---|---|---|---|---|---|---|---|
| 3860 | acl | 否 | 是 | 否 | 是 | 否 | 是 | - |
| 相关扩展 | prefix semver unit pgpdf pglite_fusion md5hash asn1oid roaringbitmap |
|---|
+cast pg_uuid_t
版本
| 类型 | 仓库 | 版本 | PG 大版本 | 包名 | 依赖 |
|---|---|---|---|---|---|
| EXT | PIGSTY | 1.0.4 | 1817161514 | pg_acl | - |
| RPM | PIGSTY | 1.0.4 | 1817161514 | acl_$v | - |
| DEB | PIGSTY | 1.0.4 | 1817161514 | postgresql-$v-acl | - |
构建
您可以使用 pig build 命令构建 pg_acl 扩展的 RPM / DEB 包：
pig build pkg pg_acl # 构建 RPM / DEB 包
安装
您可以直接安装 pg_acl 扩展包的预置二进制包，首先确保 PGDG 和 PIGSTY 仓库已经添加并启用：
pig repo add pgsql -u # 添加仓库并更新缓存
使用 pig 或者是 apt/yum/dnf 安装扩展：
pig install pg_acl; # 当前活跃 PG 版本安装
pig ext install -y pg_acl -v 18 # PG 18
pig ext install -y pg_acl -v 17 # PG 17
pig ext install -y pg_acl -v 16 # PG 16
pig ext install -y pg_acl -v 15 # PG 15
pig ext install -y pg_acl -v 14 # PG 14
dnf install -y acl_18 # PG 18
dnf install -y acl_17 # PG 17
dnf install -y acl_16 # PG 16
dnf install -y acl_15 # PG 15
dnf install -y acl_14 # PG 14
apt install -y postgresql-18-acl # PG 18
apt install -y postgresql-17-acl # PG 17
apt install -y postgresql-16-acl # PG 16
apt install -y postgresql-15-acl # PG 15
apt install -y postgresql-14-acl # PG 14
创建扩展：
CREATE EXTENSION acl;
用法
acl 扩展提供了访问控制列表类型，用于基于应用用户的行级安全控制，无需为每个用户创建独立的数据库账户。
CREATE EXTENSION acl;
数据类型
ace：基于 PostgreSQL OID 的标准角色 ACEace_int4：使用 32 位整数标识符的 ACEace_int8：使用 64 位整数标识符的 ACEace_uuid：使用 UUID 标识符的 ACE
ACL 以 ACE 类型的 PostgreSQL 数组形式存储（例如 ace[]）。
ACE 格式
[type]/[flags]/[who]=[mask]
- Type（类型）：
a（允许）或d（拒绝） - Flags（标志）：
i（仅继承）、o（对象继承）、c（容器继承）、p（不传播）、h（已继承） - Who（对象）：角色名、OID、整数、UUID 或
""（所有人） - Permissions（权限）：
r（读取）、w（写入）、d（删除）、c（读取 ACL）、s（写入 ACL），以及 16 个自定义权限（0-F）
权限检查
-- 检查当前用户的访问权限
SELECT acl_check_access(acl_column, 'rw', false) FROM my_table;
-- 检查指定角色
SELECT acl_check_access(acl_column, 'r', 'username'::name, false);
-- 检查自定义 int4 角色
SELECT acl_check_access(acl_column, 'rw', ARRAY[1001, 1002]::int4[], false);
ACL 继承
-- 从父级计算子级 ACL
SELECT acl_merge(parent_acl, child_acl, true, true);
行级安全示例
CREATE TABLE file_system (
id int PRIMARY KEY,
name text,
acl ace[]
);
ALTER TABLE file_system ENABLE ROW LEVEL SECURITY;
CREATE POLICY read_policy ON file_system FOR SELECT TO PUBLIC
USING (acl_check_access(acl, 'r', false) = 'r');
CREATE POLICY write_policy ON file_system FOR UPDATE TO PUBLIC
USING (acl_check_access(acl, 'w', false) = 'w');