进阶 questdb.com 2026-10-13 06:17:07 · 30 阅读
第10章 QuestDB 基于角色的访问控制 (RBAC) 详解
基于角色的访问控制(RBAC)QuestDB Enterprise 版本提供的 RBAC 可为 QuestDB 实例配置细粒度权限。了解更多
QuestDB Enterprise 提供细粒度的访问控制,可将权限限制到数据库、表、列,甚至行级别(通过视图实现)。
快速上手
下面是一个完整示例,一分钟内即可创建只读的分析师用户:
-- 1. 创建用户
CREATE USER analyst WITH PASSWORD 'secure_password_here';
-- 2. 授予端点访问权限(连接所必需)
GRANT PGWIRE, HTTP TO analyst;
-- 3. 授予指定表的读权限
GRANT SELECT ON trades, prices TO analyst;
-- 完成!分析师现在可以连接并查询 trades 和 prices 表
验证方式: SHOW PERMISSIONS analyst;
访问控制维度 QuestDB 的访问控制涵盖两个维度: 数据访问粒度 控制用户能访问哪些数据: 级别可控制的内容示例数据库所有表、全局操作GRANT SELECT ON ALL TABLES TO user表特定表GRANT SELECT ON trades TO user列表中的特定列GRANT SELECT ON trades(ts, price) TO user行通过视图控制特定行创建带 WHERE 子句的视图,再授予视图访问权限 连接访问粒度 控制用户以何种方式连接: 权限协议使用场景HTTPREST API、Web 控制台、ILP/HTTP交互式用户、Web 应用PGWIREPostgreSQL Wire ProtocolSQL 客户端、BI 工具、程序化访问ILPInfluxDB Line Protocol(TCP)高吞吐数据写入 -- 仅允许通过 PostgreSQL 协议连接(不能使用 Web 控制台)
GRANT PGWIRE TO analyst;
-- 服务只能通过 ILP 写入数据,无法查询
GRANT ILP TO ingest_service;
-- 完整的交互式访问
GRANT HTTP, PGWIRE TO developer;
这两个维度相互独立:一个用户可以对所有表拥有 SELECT 权限但只能通过 PGWIRE 连接,也可以拥有 INSERT 权限但只能通过 ILP 使用。 列级访问 将用户的可见范围限制在某些列: -- 用户只能看到时间戳和价格,看不到数量和交易员 ID
GRANT SELECT ON trades(ts, price) TO analyst;
若想排除少数几列、授予其余所有列的权限,可用 * 通配符配合 EXCLUDE 列表: -- 用户可以看到除 trader_id 之外的所有列
GRANT SELECT ON trades(* EXCLUDE (trader_id)) TO analyst;
通配符覆盖的是语句执行时已存在的列,而非之后添加的列。详情请参见 GRANT。 基于视图的行级访问 对于行级安全控制,创建一个用于过滤行的视图,然后向该视图而非底层表授予访问权限: -- 创建一个仅显示 AAPL 交易记录的视图
CREATE VIEW aapl_trades AS (
SELECT * FROM trades WHERE symbol = 'AAPL'
);
-- 向视图而非基础表授予访问权限
GRANT SELECT ON aapl_trades TO aapl_analyst;
-- 未向 trades 表授予权限 = 用户无法查看其他交易品种
用户 aapl_analyst 只能看到 AAPL 的交易记录,无法访问底层的 trades 表。 常见场景 只读分析师 该用户可查询数据,但无法修改任何内容: CREATE USER analyst WITH PASSWORD 'pwd';
GRANT HTTP, PGWIRE TO analyst;
GRANT SELECT ON ALL TABLES TO analyst;
应用服务账户 这是应用程序的服务账户,用于将数据写入特定表: CREATE SERVICE ACCOUNT ingest_app WITH PASSWORD 'pwd';
GRANT ILP TO ingest_app; -- 允许 InfluxDB Line Protocol 访问
GRANT INSERT ON sensor_data TO ingest_app; -- 仅可写入 sensor_data
限制噪声租户的查询内存 限制用户每个查询可分配的原生内存上限,以便单个租户的失控查询会导致失败,而不是耗尽共享内存: ALTER USER tenant_a SET MEMORY LIMIT 1G;
有关限制如何解析的详情,请参阅 Memory limits。 基于组的团队访问 多个用户共享相同权限: -- 创建组
CREATE GROUP trading_team;
-- 向组授予权限
GRANT HTTP, PGWIRE TO trading_team;
GRANT SELECT ON trades, positions TO trading_team;
GRANT INSERT ON trades TO trading_team;
-- 将用户添加到组 - 他们将继承所有权限
CREATE USER alice WITH PASSWORD 'pwd1';
CREATE USER bob WITH PASSWORD 'pwd2';
ADD USER alice TO trading_team;
ADD USER bob TO trading_team;
列级限制(隐藏敏感数据) 允许访问表,但隐藏敏感列: CREATE USER auditor WITH PASSWORD 'pwd';
GRANT HTTP, PGWIRE TO auditor;
-- 仅授予对非敏感列的访问权限
GRANT SELECT ON employees(id, name, department, hire_date) TO auditor;
-- 未授予 salary 和 ssn 列 = 对 auditor 不可见
行级安全控制(多租户) 不同用户看到不同的数据子集: -- 基础表包含所有区域的数据
CREATE TABLE sales (ts TIMESTAMP, region SYMBOL, amount DOUBLE) TIMESTAMP(ts);
-- 创建按地区划分的视图
CREATE VIEW sales_emea AS (SELECT * FROM sales WHERE region = 'EMEA');
CREATE VIEW sales_apac AS (SELECT * FROM sales WHERE region = 'APAC');
-- 仅授予用户访问其所属地区数据的权限
CREATE USER emea_manager WITH PASSWORD 'pwd';
GRANT HTTP, PGWIRE TO emea_manager;
GRANT SELECT ON sales_emea TO emea_manager;
CREATE USER apac_manager WITH PASSWORD 'pwd';
GRANT HTTP, PGWIRE TO apac_manager;
GRANT SELECT ON sales_apac TO apac_manager;
数据库管理员 拥有完全控制权(但不等同于内置管理员)的用户: CREATE USER dba WITH PASSWORD 'pwd';
GRANT DATABASE ADMIN TO dba;
注意:DATABASE ADMIN 权限包含当前及未来所有的访问权限,请谨慎使用。 故障转移操作员 服务账户,允许在节点间切换主节点角色,适用于外部协调器或运维手册场景,且不赋予其他管理权限: CREATE SERVICE ACCOUNT failover_bot WITH PASSWORD 'pwd';
GRANT HTTP TO failover_bot; -- 在 9003 端口执行 POST /lifecycle/switch
GRANT SWITCH ROLE TO failover_bot; -- 切换角色、查询状态及相应端点
执行角色切换既不需要也不足以依赖 SYSTEM ADMIN,而 DATABASE ADMIN 包含 SWITCH ROLE 权限。监控账户无需此权限: node_role() 和 GET /lifecycle 端点对任何已认证主体开放。请参阅故障转移与角色切换章节。 核心概念 用户、服务账户与组 用户与服务账户 QuestDB 有两种主体类型: 用户:面向人类个体。可加入多个组并继承组权限。不能被其他主体假设(即 impersonate)。 服务账户:面向应用程序。不能加入组,所有权限必须直接授予。可被授权用户假设用于测试。 CREATE USER human_user WITH PASSWORD 'pwd';
CREATE SERVICE ACCOUNT app_account WITH PASSWORD 'pwd';
名称必须在所有用户、服务账号和组之间保持唯一。 为什么需要服务账号? 服务账号提供了干净、可测试的应用访问方式: | 对比项 | 用户 | 服务账号 | |---|---|---| | 权限来源 | 直接授权 + 从组继承 | 仅直接授权 | | 可加入组 | 是 | 否 | | 可被 ASSUME 切换 | 否 | 是 | | 典型用途 | 真实用户 | 应用、服务 | 由于服务账号没有继承权限,其访问权限完全显式、可预测。再加上可以被 ASSUME 切换的特性,你可以轻松验证一个应用到底能做什么、不能做什么: -- 创建具有特定权限的服务账号
CREATE SERVICE ACCOUNT trading_app WITH PASSWORD 'pwd';
GRANT ILP TO trading_app;
GRANT INSERT ON trades TO trading_app;
GRANT SELECT ON positions TO trading_app;
-- 开发者可以切换到服务账号来测试其访问权限
GRANT ASSUME SERVICE ACCOUNT trading_app TO developer;
-- 开发者切换到服务账号上下文
ASSUME SERVICE ACCOUNT trading_app;
-- 现在以 trading_app 的精确权限运行
-- 测试哪些操作可以执行、哪些不可以...
EXIT SERVICE ACCOUNT;
对于需要可预测、可审计、可测试的访问控制的应用场景,服务账号是理想选择。 组 当多个用户需要相同的访问权限时,组可以简化权限管理: CREATE GROUP analysts;
GRANT SELECT ON ALL TABLES TO analysts;
-- 加入该组的所有用户都能读取所有表
ADD USER alice TO analysts;
ADD USER bob TO analysts;
用户从所属组继承权限。继承来的权限不能直接从用户身上撤销,只能从组上撤销。组被删除后,所有成员会失去从该组继承的权限。 认证方式 认证与授权流程 QuestDB 支持三种认证方式: | 方式 | 使用场景 | 端点 | |---|---|---| | 密码 | 交互式用户 | REST API、PostgreSQL Wire | | JWK Token | ILP 数据写入 | InfluxDB Line Protocol | | REST API Token | 程序化 REST 访问 | REST API | 用户可以同时启用多种认证方式: -- 为 ILP 访问添加 JWK token
ALTER USER sensor_writer CREATE TOKEN TYPE JWK;
-- 添加 REST API token(30 天有效期)
ALTER USER api_user CREATE TOKEN TYPE REST WITH TTL '30d';
REVOKE SELECT ON secret_table FROM user;
-- 结果:用户获得除 secret_table 外所有表的表级别 SELECT 权限
-- 未来创建的表将不可访问
同样的逻辑也适用于从表级别到列级别: GRANT SELECT ON trades TO user; -- 表级别
REVOKE SELECT ON trades(ssn) FROM user; -- 撤销某一列
-- 结果:用户获得除 ssn 外所有列的列级别 SELECT 权限
-- 未来创建的列将不可访问
注意在删除表时,默认会保留该表上的权限(这在表被重建时很有用)。如需同时移除所有关联权限,请使用 DROP TABLE ... CASCADE PERMISSIONS。 ### 隐式时间戳权限 如果用户对表中任意列拥有 SELECT 或 UPDATE 权限,他们会自动获得在指定时间戳列上的相同权限。这确保了时序操作(如 SAMPLE BY、LATEST ON 等)能正确运行。 ### 对不存在对象的授权 您可以对尚不存在的表/列授予权限: GRANT INSERT ON future_table TO app;
-- 当 future_table 创建时,该权限自动生效
使用 WITH VERIFICATION 可以捕获拼写错误: GRANT SELECT ON trdaes TO user WITH VERIFICATION;
-- 由于 'trdaes' 不存在,会立即失败
### 服务账户假设 用户可以临时假设(Assume)服务账户的权限进行调试: -- 授予假设权限
GRANT ASSUME SERVICE ACCOUNT ingest_app TO developer;
-- 开发者现在可以切换上下文
ASSUME SERVICE ACCOUNT ingest_app;
-- ... 使用应用的权限进行调试 ...
EXIT SERVICE ACCOUNT;
### 用户管理参考 #### 创建和删除主体 -- 用户
CREATE USER username WITH PASSWORD 'pwd';
DROP USER username;
-- 服务账户
CREATE SERVICE ACCOUNT appname WITH PASSWORD 'pwd';
DROP SERVICE ACCOUNT appname;
-- 组
CREATE GROUP groupname;
DROP GROUP groupname;
#### 管理组成员资格 ADD USER username TO group1, group2;
REMOVE USER username FROM group1;
管理认证 -- 修改密码
ALTER USER username WITH PASSWORD 'new_pwd';
-- 移除密码(禁用密码认证)
ALTER USER username WITH NO PASSWORD;
-- 创建 token
ALTER USER username CREATE TOKEN TYPE JWK;
ALTER USER username CREATE TOKEN TYPE REST WITH TTL '30d';
ALTER USER username CREATE TOKEN TYPE REST WITH TTL '1d' REFRESH; -- 自动刷新
-- 移除 token
ALTER USER username DROP TOKEN TYPE JWK;
ALTER USER username DROP TOKEN TYPE REST; -- 移除所有 REST token
ALTER USER username DROP TOKEN TYPE REST 'token_value_here'; -- 移除指定 token
移除所有认证方式(密码和 token)后,用户实际上被禁用,将无法再连接数据库。 查看信息 SHOW USERS; -- 列出所有用户
SHOW SERVICE ACCOUNTS; -- 列出所有 service account
SHOW GROUPS; -- 列出所有 group
SHOW GROUPS username; -- 列出某用户所属的 group
SHOW USER username; -- 查看用户的认证方式
SHOW PERMISSIONS username; -- 查看用户的权限
SHOW USERS、SHOW GROUPS 和 SHOW SERVICE ACCOUNTS 还会显示每个实体的内存限制。 SHOW USER 的示例输出: auth_type enabled
--------- -------
Password true
JWK Token false
REST Token true
注意:查看其他用户的信息需要 LIST USERS(列出全部)或 USER DETAILS(查看详情)权限。用户无需这些权限即可随时查看自己的信息。 内存限制 QuestDB Enterprise 可以限制单个查询占用的原生内存,针对特定用户、group 或 service account 覆盖全局查询内存限制。可以用它防止某个租户的失控查询耗尽共享内存,或者给可信的主体分配比默认值更多的空间。按主体设置的限制自 QuestDB Enterprise 4.0.2 起可用;它所覆盖的全局工作负载限制自 QuestDB 10.0.0 起可用。 使用 ALTER USER、ALTER GROUP 或 ALTER SERVICE ACCOUNT 设置限制: ALTER USER john SET MEMORY LIMIT 512M;
ALTER GROUP analysts SET MEMORY LIMIT 2G;
ALTER SERVICE ACCOUNT ingest_app SET MEMORY LIMIT 1G;
ALTER USER john SET MEMORY LIMIT UNLIMITED; -- 清除该用户自身的限制
值可以是字节数,也可以是带有 K、M 或 G 后缀的大小。每个后缀代表乘以 1024,例如 512M 等于 536870912 字节。设置限制需要持有 SET MEMORY LIMIT 权限,该权限包含在 GRANT ALL 中,并且数据库管理员隐式拥有此权限。 warning 将 SET MEMORY LIMIT 视为管理权限,而非自助服务权限。它不需要指定实体名称,因此持有者可以设置任何主体(包括其自身)的限制。由于单个主体的限制是覆盖工作负载限制而非收紧限制(参见“限制如何解析”),持有此权限的非管理员可以将自己的上限提高到高于 `cairo.query.memory.limit.bytes` 的值。内置管理员仅作为目标被豁免:根本无法为内置管理员设置限制。GRANT ALL 在授予时刻展开为单项权限。在升级到包含此功能的版本之前被授予 ALL 的主体,不会自动获得 SET MEMORY LIMIT;只有升级后发出的授予语句才包含该权限,且迁移过程不会回填此权限。请显式为现有管理员授予权限:GRANT SET MEMORY LIMIT TO admins;。 限制如何解析 QuestDB 通过严格的优先级顺序解析查询的限制。它采用第一个被设置的层级值,而非所有层级中的最小值: 主体的自身限制。对于用户,这是用户自身的限制;对于假定服务账户身份的查询,则是该服务账户的限制。 群组限制(仅限用户)。当用户自身没有设置限制时,会继承其所属于的群组中最严格(即最小正值)的限制。服务账户从不继承群组限制。 工作负载限制。如果上述均未设置,则应用服务器全局的 `cairo.query.memory.limit.bytes`。 如果某层级的值为 0(或 UNLIMITED),则表示该层级“未设置”,解析过程将落入下一层级。当更具体的层级已设置时,它会完全覆盖更广泛的层级限制,即使其数值更大也会生效。因此,按用户或按群组的覆盖规则可以提高主体的上限至高于工作负载限制,而不仅仅是降低它。假设服务账户身份的用户将采用该服务账户的限制。 内置管理员无法被设置限制,因此 `ALTER USER admin SET MEMORY LIMIT` 会被拒绝,并报错“无法为内置管理员设置内存限制”,管理员运行在工作负载限制之下。请考虑到管理员诊断查询的需求来设定该限制。 该限制适用于主体在主节点和副本节点上的查询。该语句本身仅在主节点执行:副本节点会以“replica cannot set memory limit”为由拒绝执行,并通过复制的 ACL 表接收新值。修改后的限制应用于主体的下一条查询,即使连接已打开亦然;而已在执行中的查询仍沿用其启动时的限制。 超过限制的查询将失败,产生与违反工作负载限制相同的错误:`query memory limit exceeded [workload=QUERY, ...]`。有关消息格式,请参阅“内存限制”。 note 限制约束的是单个查询。同一主体的两个并发查询各自都在完整限制下运行,因此主体的总使用量可能会超过该限制。此限制旨在防止单个失控的工作负载,而非限制总并发使用量。 单个主体限制的覆盖范围 单个主体限制具有与工作负载限制相同的覆盖范围。 它们适用于跟踪以下情况的本地内存分配: 主体的查询。 其后台 `COPY ... TO` 导出操作,该操作使用发起主体的限制。用于生成导出文件的某些内存尚未被覆盖,且导出操作不会出现在 `query_activity` 中,因此在运行期间无法观察其使用情况。 对非 WAL 表的 `UPDATE` 操作,该操作在调用者的自身线程上应用,并获取其专属的查询工作负载跟踪器。 它不覆盖在内部上下文而非主体下运行的工作。这些工作仅受限于自身的工作负载限制: 对 WAL 表(默认表类型)的 `UPDATE` 操作,因为该语句由 WAL 应用任务处理,并占用该任务的 `cairo.wal.apply.memory.limit.bytes` 预算。因此,大型 `UPDATE` 是否受 `SET MEMORY LIMIT` 覆盖限制取决于表类型。如果 WAL 表的 `UPDATE` 违反 WAL 应用限制,该表将被挂起,影响所有主体,直到执行 `ALTER TABLE RESUME WAL`,因此故障不会隔离在发起租户范围内。 物化视图刷新、实时视图刷新以及 WAL 应用本身。WAL 应用将多个主体的事务批量归入一个跟踪器,因此无论如何都无法将使用量归因于单个主体。 `COPY ... FROM` 导入操作,它们根本不获取内存跟踪器,且不受任一类限制的影响。 note 外部(SSO/OIDC)用户只能通过继承群组的限制来获得限制:对外部用户执行 `ALTER USER ... SET MEMORY LIMIT` 会被拒绝,并报错“无法为外部用户设置内存限制”。用户在登录时获得继承的群组限制。在主节点上,后续的 `ALTER GROUP ... SET MEMORY LIMIT` 也会在用户的下一条查询时达到其已打开的会话。在副本节点上,以及在主节点重启或晋升为 primary 之后,现有的外部会话将保持其登录时的限制,直到重新连接为止。 检查限制 `SHOW USERS`、`SHOW GROUPS` 和 `SHOW SERVICE ACCOUNTS` 会在 `memory_limit` 列中报告每个主体的限制,单位为字节。对于用户,这是其自身限制,或在其自身无限制时为其群组中最严格的限制。对于群组和服务账户,则是该实体自身的限制。该列不包含服务器全局的工作负载限制。`null` 表示该实体自身没有限制,对于用户而言也未继承任何限制,因此其查询适用工作负载限制。 过滤形式 `SHOW GROUPS userName` 和 `SHOW SERVICE ACCOUNTS { userName | groupName }` 也带有该列,报告列表中每个群组或服务账户的自身限制。这显示了对于自身无限制的用户,哪个继承的限制生效。 `query_activity` 通过其 `memory_limit` 和 `memory_used` 列暴露每个正在运行的查询的有效限制和实时使用情况。 `SHOW USER` 不带该列。未过滤的 `SHOW USERS`、`SHOW GROUPS` 和 `SHOW SERVICE ACCOUNTS` 需要 `LIST USERS` 权限;过滤形式需要 `USER DETAILS` 权限,除非调用者指定其自身或自身所属群组。没有 `LIST USERS` 权限的用户仍可从 `query_activity` 的 `memory_limit` 列读取其自身的有效上限,因为该视图始终列出调用者自身的查询。 存储的值持久化在 `sys.acl_entities` 系统表中。该表受保护:只有内置管理员可以读取它,持有 `DATABASE ADMIN` 的 ACL 主体仍会被拒绝访问。 升级 破坏性变更 `memory_limit` 作为最后一列添加到 `SHOW USERS`、`SHOW GROUPS` 和 `SHOW SERVICE ACCOUNTS`(包括其过滤形式)中,无论是否设置限制。对 `sys.acl_entities` 执行 `SELECT *` 也会多返回一列。按位置读取这些结果的客户端必须更新;按列名读取的客户端不受影响。 `SHOW` 结果从升级后的二进制文件首次启动时携带该列,在限制被设置前读取为 `null`。存储该值的 `sys.acl_entities` 列由自动迁移添加,当升级后的节点首次作为 primary 启动或从副本晋升为 primary 时触发。在迁移应用之前,持久化的主体限制不会被强制执行。迁移过程经过两个窗口,每个窗口拒绝不同类型的语句: 在列存在之前,带有非零大小的 `SET MEMORY LIMIT` 会被拒绝,报错: `Cannot modify ACL entities: the memory_limit column has not been migrated in yet; retry shortly, or restart the node if it persists`
SET MEMORY LIMIT UNLIMITED 以及 ALTER ... ENABLE 或 DISABLE 语句仍可成功执行。 列已添加但 WAL apply 尚未处理到该列时,SET MEMORY LIMIT UNLIMITED 及 ALTER ... ENABLE 或 DISABLE 同样会被拒绝,从而防止过时的内存值覆盖已存储的限制。非零的 SET MEMORY LIMIT 保留首条错误消息,其他情况则分别显示: “ACL memory_limit 列迁移仍在应用期间无法设置内存限制,请重试 [name=john]
” 状态变更时,则显示“...期间无法启用”或“...期间无法禁用”。 通常情况下,一旦 WAL apply 追上进度,此窗口期会自动关闭,因此请首先重试该语句。若错误持续存在,则重启节点:迁移任务将在启动时重新运行。 权限参考 使用 all_permissions() 查看所有可用权限: SELECT * FROM all_permissions();
完整权限表(点击展开)数据库权限权限级别说明ADD COLUMNDatabase | Table向表中添加列ADD INDEXDatabase | Table | Column在 symbol 列上添加索引ALTER COLUMN CACHEDatabase | Table | Column启用/禁用 symbol 缓存ALTER COLUMN TYPEDatabase | Table | Column修改列类型ATTACH PARTITIONDatabase | Table挂载分区BACKUP DATABASEDatabase创建数据库备份CANCEL ANY COPYDatabase取消 COPY 操作CREATE TABLEDatabase创建表CREATE MATERIALIZED VIEWDatabase创建物化视图CREATE LIVE VIEWDatabase创建 live 视图DEDUP ENABLEDatabase | Table启用去重DEDUP DISABLEDatabase | Table禁用去重DETACH PARTITIONDatabase | Table卸载分区DISABLE STORAGE POLICYDatabase | Table禁用存储策略DROP COLUMNDatabase | Table | Column删除列DROP INDEXDatabase | Table | Column删除索引DROP PARTITIONDatabase | Table删除分区DROP TABLEDatabase | Table删除表DROP MATERIALIZED VIEWDatabase | Table删除物化视图DROP LIVE VIEWDatabase | Table删除 live 视图ENABLE STORAGE POLICYDatabase | Table启用存储策略INSERTDatabase | Table插入数据REFRESH MATERIALIZED VIEWDatabase | Table刷新物化视图REINDEXDatabase | Table | Column重建列索引REMOVE STORAGE POLICYDatabase | Table移除存储策略RENAME COLUMNDatabase | Table | Column重命名列RENable TABLEDatabase | Table重命名表RESUME WALDatabase | Table恢复 WAL 处理SELECTDatabase | Table | Column读取数据SET STORAGE POLICYDatabase | Table设置存储策略SET TABLE PARAMDatabase | Table设置表参数SET TABLE TYPEDatabase | Table修改表类型SETTINGSDatabase在 Web Console 中修改实例设置SNAPSHOTDatabase创建快照SQL ENGINE ADMINDatabase查看/取消正在运行的查询SWITCH ROLEDatabase切换复制角色,参见 SWITCH STATUSSYSTEM ADMINDatabase系统函数(reload_tls 等)TRUNCATE TABLEDatabase | Table清空表UPDATEDatabase | Table | Column更新数据VACUUM TABLEDatabase | Table回收存储空间 用户管理权限权限说明ADD EXTERNAL ALIAS创建外部组映射ADD PASSWORD设置用户密码ADD USER将用户添加到组CREATE GROUP创建组CREATE JWK创建 JWK tokenCREATE REST TOKEN创建 REST API tokenCREATE SERVICE ACCOUNT创建服务账号CREATE USER创建用户DISABLE USER禁用用户DROP GROUP删除组DROP JWK删除 JWK tokenDROP REST TOKEN删除 REST API tokenDROP SERVICE ACCOUNT删除服务账号DROP USER删除用户ENABLE USER启用用户LIST USERS列出用户/组/服务账号REMOVE EXTERNAL ALIAS移除外部组映射REMOVE PASSWORD移除密码REMOVE USER将用户从组中移除SET MEMORY LIMIT为用户、组和服务账号设置内存限制USER DETAILS查看用户/组/服务账号详情 特殊权限权限说明ALL所授级别(数据库/表/列)的所有权限DATABASE ADMIN包括未来新增在内的所有权限;可切换到任意服务账号 少数操作保留给数据库管理员,无法作为权限授予: 操作说明ALTER TABLE REBASE WAL使用新的 sequencer 重建处于挂起状态的 WAL 表SWITCH COLD STORAGE ROLE转移冷存储管理角色,支持 FORCE 相比之下,用于转移复制角色的 SWITCH ROLE 只是一条普通的可授予权限。 SQL 命令参考 ADD USER ALTER GROUP ALTER SERVICE ACCOUNT ALTER USER ASSUME SERVICE ACCOUNT CREATE GROUP CREATE SERVICE ACCOUNT CREATE USER DROP GROUP DROP SERVICE ACCOUNT DROP USER EXIT SERVICE ACCOUNT GRANT GRANT ASSUME SERVICE ACCOUNT REMOVE USER REVOKE REVOKE ASSUME SERVICE ACCOUNT SHOW USER SHOW USERS SHOW GROUPS SHOW SERVICE ACCOUNT SHOW SERVICE ACCOUNTS SHOW PERMISSIONS
CREATE USER analyst WITH PASSWORD 'secure_password_here';
-- 2. 授予端点访问权限(连接所必需)
GRANT PGWIRE, HTTP TO analyst;
-- 3. 授予指定表的读权限
GRANT SELECT ON trades, prices TO analyst;
-- 完成!分析师现在可以连接并查询 trades 和 prices 表
验证方式: SHOW PERMISSIONS analyst;
访问控制维度 QuestDB 的访问控制涵盖两个维度: 数据访问粒度 控制用户能访问哪些数据: 级别可控制的内容示例数据库所有表、全局操作GRANT SELECT ON ALL TABLES TO user表特定表GRANT SELECT ON trades TO user列表中的特定列GRANT SELECT ON trades(ts, price) TO user行通过视图控制特定行创建带 WHERE 子句的视图,再授予视图访问权限 连接访问粒度 控制用户以何种方式连接: 权限协议使用场景HTTPREST API、Web 控制台、ILP/HTTP交互式用户、Web 应用PGWIREPostgreSQL Wire ProtocolSQL 客户端、BI 工具、程序化访问ILPInfluxDB Line Protocol(TCP)高吞吐数据写入 -- 仅允许通过 PostgreSQL 协议连接(不能使用 Web 控制台)
GRANT PGWIRE TO analyst;
-- 服务只能通过 ILP 写入数据,无法查询
GRANT ILP TO ingest_service;
-- 完整的交互式访问
GRANT HTTP, PGWIRE TO developer;
这两个维度相互独立:一个用户可以对所有表拥有 SELECT 权限但只能通过 PGWIRE 连接,也可以拥有 INSERT 权限但只能通过 ILP 使用。 列级访问 将用户的可见范围限制在某些列: -- 用户只能看到时间戳和价格,看不到数量和交易员 ID
GRANT SELECT ON trades(ts, price) TO analyst;
若想排除少数几列、授予其余所有列的权限,可用 * 通配符配合 EXCLUDE 列表: -- 用户可以看到除 trader_id 之外的所有列
GRANT SELECT ON trades(* EXCLUDE (trader_id)) TO analyst;
通配符覆盖的是语句执行时已存在的列,而非之后添加的列。详情请参见 GRANT。 基于视图的行级访问 对于行级安全控制,创建一个用于过滤行的视图,然后向该视图而非底层表授予访问权限: -- 创建一个仅显示 AAPL 交易记录的视图
CREATE VIEW aapl_trades AS (
SELECT * FROM trades WHERE symbol = 'AAPL'
);
-- 向视图而非基础表授予访问权限
GRANT SELECT ON aapl_trades TO aapl_analyst;
-- 未向 trades 表授予权限 = 用户无法查看其他交易品种
用户 aapl_analyst 只能看到 AAPL 的交易记录,无法访问底层的 trades 表。 常见场景 只读分析师 该用户可查询数据,但无法修改任何内容: CREATE USER analyst WITH PASSWORD 'pwd';
GRANT HTTP, PGWIRE TO analyst;
GRANT SELECT ON ALL TABLES TO analyst;
应用服务账户 这是应用程序的服务账户,用于将数据写入特定表: CREATE SERVICE ACCOUNT ingest_app WITH PASSWORD 'pwd';
GRANT ILP TO ingest_app; -- 允许 InfluxDB Line Protocol 访问
GRANT INSERT ON sensor_data TO ingest_app; -- 仅可写入 sensor_data
限制噪声租户的查询内存 限制用户每个查询可分配的原生内存上限,以便单个租户的失控查询会导致失败,而不是耗尽共享内存: ALTER USER tenant_a SET MEMORY LIMIT 1G;
有关限制如何解析的详情,请参阅 Memory limits。 基于组的团队访问 多个用户共享相同权限: -- 创建组
CREATE GROUP trading_team;
-- 向组授予权限
GRANT HTTP, PGWIRE TO trading_team;
GRANT SELECT ON trades, positions TO trading_team;
GRANT INSERT ON trades TO trading_team;
-- 将用户添加到组 - 他们将继承所有权限
CREATE USER alice WITH PASSWORD 'pwd1';
CREATE USER bob WITH PASSWORD 'pwd2';
ADD USER alice TO trading_team;
ADD USER bob TO trading_team;
列级限制(隐藏敏感数据) 允许访问表,但隐藏敏感列: CREATE USER auditor WITH PASSWORD 'pwd';
GRANT HTTP, PGWIRE TO auditor;
-- 仅授予对非敏感列的访问权限
GRANT SELECT ON employees(id, name, department, hire_date) TO auditor;
-- 未授予 salary 和 ssn 列 = 对 auditor 不可见
行级安全控制(多租户) 不同用户看到不同的数据子集: -- 基础表包含所有区域的数据
CREATE TABLE sales (ts TIMESTAMP, region SYMBOL, amount DOUBLE) TIMESTAMP(ts);
-- 创建按地区划分的视图
CREATE VIEW sales_emea AS (SELECT * FROM sales WHERE region = 'EMEA');
CREATE VIEW sales_apac AS (SELECT * FROM sales WHERE region = 'APAC');
-- 仅授予用户访问其所属地区数据的权限
CREATE USER emea_manager WITH PASSWORD 'pwd';
GRANT HTTP, PGWIRE TO emea_manager;
GRANT SELECT ON sales_emea TO emea_manager;
CREATE USER apac_manager WITH PASSWORD 'pwd';
GRANT HTTP, PGWIRE TO apac_manager;
GRANT SELECT ON sales_apac TO apac_manager;
数据库管理员 拥有完全控制权(但不等同于内置管理员)的用户: CREATE USER dba WITH PASSWORD 'pwd';
GRANT DATABASE ADMIN TO dba;
注意:DATABASE ADMIN 权限包含当前及未来所有的访问权限,请谨慎使用。 故障转移操作员 服务账户,允许在节点间切换主节点角色,适用于外部协调器或运维手册场景,且不赋予其他管理权限: CREATE SERVICE ACCOUNT failover_bot WITH PASSWORD 'pwd';
GRANT HTTP TO failover_bot; -- 在 9003 端口执行 POST /lifecycle/switch
GRANT SWITCH ROLE TO failover_bot; -- 切换角色、查询状态及相应端点
执行角色切换既不需要也不足以依赖 SYSTEM ADMIN,而 DATABASE ADMIN 包含 SWITCH ROLE 权限。监控账户无需此权限: node_role() 和 GET /lifecycle 端点对任何已认证主体开放。请参阅故障转移与角色切换章节。 核心概念 用户、服务账户与组 用户与服务账户 QuestDB 有两种主体类型: 用户:面向人类个体。可加入多个组并继承组权限。不能被其他主体假设(即 impersonate)。 服务账户:面向应用程序。不能加入组,所有权限必须直接授予。可被授权用户假设用于测试。 CREATE USER human_user WITH PASSWORD 'pwd';
CREATE SERVICE ACCOUNT app_account WITH PASSWORD 'pwd';
名称必须在所有用户、服务账号和组之间保持唯一。 为什么需要服务账号? 服务账号提供了干净、可测试的应用访问方式: | 对比项 | 用户 | 服务账号 | |---|---|---| | 权限来源 | 直接授权 + 从组继承 | 仅直接授权 | | 可加入组 | 是 | 否 | | 可被 ASSUME 切换 | 否 | 是 | | 典型用途 | 真实用户 | 应用、服务 | 由于服务账号没有继承权限,其访问权限完全显式、可预测。再加上可以被 ASSUME 切换的特性,你可以轻松验证一个应用到底能做什么、不能做什么: -- 创建具有特定权限的服务账号
CREATE SERVICE ACCOUNT trading_app WITH PASSWORD 'pwd';
GRANT ILP TO trading_app;
GRANT INSERT ON trades TO trading_app;
GRANT SELECT ON positions TO trading_app;
-- 开发者可以切换到服务账号来测试其访问权限
GRANT ASSUME SERVICE ACCOUNT trading_app TO developer;
-- 开发者切换到服务账号上下文
ASSUME SERVICE ACCOUNT trading_app;
-- 现在以 trading_app 的精确权限运行
-- 测试哪些操作可以执行、哪些不可以...
EXIT SERVICE ACCOUNT;
对于需要可预测、可审计、可测试的访问控制的应用场景,服务账号是理想选择。 组 当多个用户需要相同的访问权限时,组可以简化权限管理: CREATE GROUP analysts;
GRANT SELECT ON ALL TABLES TO analysts;
-- 加入该组的所有用户都能读取所有表
ADD USER alice TO analysts;
ADD USER bob TO analysts;
用户从所属组继承权限。继承来的权限不能直接从用户身上撤销,只能从组上撤销。组被删除后,所有成员会失去从该组继承的权限。 认证方式 认证与授权流程 QuestDB 支持三种认证方式: | 方式 | 使用场景 | 端点 | |---|---|---| | 密码 | 交互式用户 | REST API、PostgreSQL Wire | | JWK Token | ILP 数据写入 | InfluxDB Line Protocol | | REST API Token | 程序化 REST 访问 | REST API | 用户可以同时启用多种认证方式: -- 为 ILP 访问添加 JWK token
ALTER USER sensor_writer CREATE TOKEN TYPE JWK;
-- 添加 REST API token(30 天有效期)
ALTER USER api_user CREATE TOKEN TYPE REST WITH TTL '30d';
warning QuestDB 不会在创建后保存私钥或令牌。请立即保存,因为一旦丢失将无法恢复。
tip 身份验证必须通过安全的 TLS 连接进行,以保护传输过程中的凭证。
端点权限
用户连接前需先获得端点权限:
| 权限 | 允许访问 | 说明 |
|---|---|---|
| HTTP | REST API、Web Console、ILP over HTTP | — |
| PGWIRE | PostgreSQL Wire Protocol (端口 8812) | — |
| ILP | InfluxDB Line Protocol TCP (端口 9009) | — |
典型配置示例:
-- 交互式用户典型配置 GRANT HTTP, PGWIRE TO analyst; -- 数据摄入服务典型配置 GRANT ILP TO ingest_service;
内置管理员
每个 QuestDB 实例启动时都会带有一个内置管理员账户:
默认用户名:admin
默认密码:quest
请在生产环境中立即通过 server.conf 修改这些默认值:
acl.admin.user=your_admin_name acl.admin.password=your_secure_password
内置管理员拥有不可撤销的根权限。创建其他管理员用户后,应禁用该账户:
acl.admin.user.enabled=false
在复制集群中需注意,内置管理员可独立于复制访问列表,使用其自身凭证授权角色切换。它是应急账户,在需要提升权限但 SWITCH ROLE 授权尚未复制到目标节点时用于紧急管理。
权限层级
权限具有不同的粒度,决定了应用范围:
| 粒度 | 可授予范围 |
|---|---|
| Database | 仅限数据库 |
| Table | 数据库或特定表 |
| Column | 数据库、表或特定列 |
示例:
-- 数据库级:适用于所有表 GRANT SELECT ON ALL TABLES TO user; -- 表级:适用于特定表 GRANT SELECT ON trades, prices TO user; -- 列级:适用于特定列 GRANT SELECT ON trades(ts, symbol, price) TO user;
GRANT 选项
授予权限时,可允许接收者将该权限进一步授予他人:
## 所有者权限 用户创建表后,会自动获得该表的所有权限,并附带 GRANT 选项。这种所有权不会持续保留——一旦被撤销,用户无法自行恢复,必须由其他用户重新授予。 ## 进阶主题 ### 权限重新调整 数据库级别的权限包含对未来表的访问权。如果您撤销了对某一张表的访问权限,QuestDB 会自动将数据库级别的授权转换为单独的表级别授权: GRANT SELECT ON ALL TABLES TO user; -- 数据库级别GRANT SELECT ON trades TO team_lead WITH GRANT OPTION; -- team_lead 现在可将 trades 的 SELECT 权限授予他人
REVOKE SELECT ON secret_table FROM user;
-- 结果:用户获得除 secret_table 外所有表的表级别 SELECT 权限
-- 未来创建的表将不可访问
同样的逻辑也适用于从表级别到列级别: GRANT SELECT ON trades TO user; -- 表级别
REVOKE SELECT ON trades(ssn) FROM user; -- 撤销某一列
-- 结果:用户获得除 ssn 外所有列的列级别 SELECT 权限
-- 未来创建的列将不可访问
注意在删除表时,默认会保留该表上的权限(这在表被重建时很有用)。如需同时移除所有关联权限,请使用 DROP TABLE ... CASCADE PERMISSIONS。 ### 隐式时间戳权限 如果用户对表中任意列拥有 SELECT 或 UPDATE 权限,他们会自动获得在指定时间戳列上的相同权限。这确保了时序操作(如 SAMPLE BY、LATEST ON 等)能正确运行。 ### 对不存在对象的授权 您可以对尚不存在的表/列授予权限: GRANT INSERT ON future_table TO app;
-- 当 future_table 创建时,该权限自动生效
使用 WITH VERIFICATION 可以捕获拼写错误: GRANT SELECT ON trdaes TO user WITH VERIFICATION;
-- 由于 'trdaes' 不存在,会立即失败
### 服务账户假设 用户可以临时假设(Assume)服务账户的权限进行调试: -- 授予假设权限
GRANT ASSUME SERVICE ACCOUNT ingest_app TO developer;
-- 开发者现在可以切换上下文
ASSUME SERVICE ACCOUNT ingest_app;
-- ... 使用应用的权限进行调试 ...
EXIT SERVICE ACCOUNT;
### 用户管理参考 #### 创建和删除主体 -- 用户
CREATE USER username WITH PASSWORD 'pwd';
DROP USER username;
-- 服务账户
CREATE SERVICE ACCOUNT appname WITH PASSWORD 'pwd';
DROP SERVICE ACCOUNT appname;
-- 组
CREATE GROUP groupname;
DROP GROUP groupname;
#### 管理组成员资格 ADD USER username TO group1, group2;
REMOVE USER username FROM group1;
管理认证 -- 修改密码
ALTER USER username WITH PASSWORD 'new_pwd';
-- 移除密码(禁用密码认证)
ALTER USER username WITH NO PASSWORD;
-- 创建 token
ALTER USER username CREATE TOKEN TYPE JWK;
ALTER USER username CREATE TOKEN TYPE REST WITH TTL '30d';
ALTER USER username CREATE TOKEN TYPE REST WITH TTL '1d' REFRESH; -- 自动刷新
-- 移除 token
ALTER USER username DROP TOKEN TYPE JWK;
ALTER USER username DROP TOKEN TYPE REST; -- 移除所有 REST token
ALTER USER username DROP TOKEN TYPE REST 'token_value_here'; -- 移除指定 token
移除所有认证方式(密码和 token)后,用户实际上被禁用,将无法再连接数据库。 查看信息 SHOW USERS; -- 列出所有用户
SHOW SERVICE ACCOUNTS; -- 列出所有 service account
SHOW GROUPS; -- 列出所有 group
SHOW GROUPS username; -- 列出某用户所属的 group
SHOW USER username; -- 查看用户的认证方式
SHOW PERMISSIONS username; -- 查看用户的权限
SHOW USERS、SHOW GROUPS 和 SHOW SERVICE ACCOUNTS 还会显示每个实体的内存限制。 SHOW USER 的示例输出: auth_type enabled
--------- -------
Password true
JWK Token false
REST Token true
注意:查看其他用户的信息需要 LIST USERS(列出全部)或 USER DETAILS(查看详情)权限。用户无需这些权限即可随时查看自己的信息。 内存限制 QuestDB Enterprise 可以限制单个查询占用的原生内存,针对特定用户、group 或 service account 覆盖全局查询内存限制。可以用它防止某个租户的失控查询耗尽共享内存,或者给可信的主体分配比默认值更多的空间。按主体设置的限制自 QuestDB Enterprise 4.0.2 起可用;它所覆盖的全局工作负载限制自 QuestDB 10.0.0 起可用。 使用 ALTER USER、ALTER GROUP 或 ALTER SERVICE ACCOUNT 设置限制: ALTER USER john SET MEMORY LIMIT 512M;
ALTER GROUP analysts SET MEMORY LIMIT 2G;
ALTER SERVICE ACCOUNT ingest_app SET MEMORY LIMIT 1G;
ALTER USER john SET MEMORY LIMIT UNLIMITED; -- 清除该用户自身的限制
值可以是字节数,也可以是带有 K、M 或 G 后缀的大小。每个后缀代表乘以 1024,例如 512M 等于 536870912 字节。设置限制需要持有 SET MEMORY LIMIT 权限,该权限包含在 GRANT ALL 中,并且数据库管理员隐式拥有此权限。 warning 将 SET MEMORY LIMIT 视为管理权限,而非自助服务权限。它不需要指定实体名称,因此持有者可以设置任何主体(包括其自身)的限制。由于单个主体的限制是覆盖工作负载限制而非收紧限制(参见“限制如何解析”),持有此权限的非管理员可以将自己的上限提高到高于 `cairo.query.memory.limit.bytes` 的值。内置管理员仅作为目标被豁免:根本无法为内置管理员设置限制。GRANT ALL 在授予时刻展开为单项权限。在升级到包含此功能的版本之前被授予 ALL 的主体,不会自动获得 SET MEMORY LIMIT;只有升级后发出的授予语句才包含该权限,且迁移过程不会回填此权限。请显式为现有管理员授予权限:GRANT SET MEMORY LIMIT TO admins;。 限制如何解析 QuestDB 通过严格的优先级顺序解析查询的限制。它采用第一个被设置的层级值,而非所有层级中的最小值: 主体的自身限制。对于用户,这是用户自身的限制;对于假定服务账户身份的查询,则是该服务账户的限制。 群组限制(仅限用户)。当用户自身没有设置限制时,会继承其所属于的群组中最严格(即最小正值)的限制。服务账户从不继承群组限制。 工作负载限制。如果上述均未设置,则应用服务器全局的 `cairo.query.memory.limit.bytes`。 如果某层级的值为 0(或 UNLIMITED),则表示该层级“未设置”,解析过程将落入下一层级。当更具体的层级已设置时,它会完全覆盖更广泛的层级限制,即使其数值更大也会生效。因此,按用户或按群组的覆盖规则可以提高主体的上限至高于工作负载限制,而不仅仅是降低它。假设服务账户身份的用户将采用该服务账户的限制。 内置管理员无法被设置限制,因此 `ALTER USER admin SET MEMORY LIMIT` 会被拒绝,并报错“无法为内置管理员设置内存限制”,管理员运行在工作负载限制之下。请考虑到管理员诊断查询的需求来设定该限制。 该限制适用于主体在主节点和副本节点上的查询。该语句本身仅在主节点执行:副本节点会以“replica cannot set memory limit”为由拒绝执行,并通过复制的 ACL 表接收新值。修改后的限制应用于主体的下一条查询,即使连接已打开亦然;而已在执行中的查询仍沿用其启动时的限制。 超过限制的查询将失败,产生与违反工作负载限制相同的错误:`query memory limit exceeded [workload=QUERY, ...]`。有关消息格式,请参阅“内存限制”。 note 限制约束的是单个查询。同一主体的两个并发查询各自都在完整限制下运行,因此主体的总使用量可能会超过该限制。此限制旨在防止单个失控的工作负载,而非限制总并发使用量。 单个主体限制的覆盖范围 单个主体限制具有与工作负载限制相同的覆盖范围。 它们适用于跟踪以下情况的本地内存分配: 主体的查询。 其后台 `COPY ... TO` 导出操作,该操作使用发起主体的限制。用于生成导出文件的某些内存尚未被覆盖,且导出操作不会出现在 `query_activity` 中,因此在运行期间无法观察其使用情况。 对非 WAL 表的 `UPDATE` 操作,该操作在调用者的自身线程上应用,并获取其专属的查询工作负载跟踪器。 它不覆盖在内部上下文而非主体下运行的工作。这些工作仅受限于自身的工作负载限制: 对 WAL 表(默认表类型)的 `UPDATE` 操作,因为该语句由 WAL 应用任务处理,并占用该任务的 `cairo.wal.apply.memory.limit.bytes` 预算。因此,大型 `UPDATE` 是否受 `SET MEMORY LIMIT` 覆盖限制取决于表类型。如果 WAL 表的 `UPDATE` 违反 WAL 应用限制,该表将被挂起,影响所有主体,直到执行 `ALTER TABLE RESUME WAL`,因此故障不会隔离在发起租户范围内。 物化视图刷新、实时视图刷新以及 WAL 应用本身。WAL 应用将多个主体的事务批量归入一个跟踪器,因此无论如何都无法将使用量归因于单个主体。 `COPY ... FROM` 导入操作,它们根本不获取内存跟踪器,且不受任一类限制的影响。 note 外部(SSO/OIDC)用户只能通过继承群组的限制来获得限制:对外部用户执行 `ALTER USER ... SET MEMORY LIMIT` 会被拒绝,并报错“无法为外部用户设置内存限制”。用户在登录时获得继承的群组限制。在主节点上,后续的 `ALTER GROUP ... SET MEMORY LIMIT` 也会在用户的下一条查询时达到其已打开的会话。在副本节点上,以及在主节点重启或晋升为 primary 之后,现有的外部会话将保持其登录时的限制,直到重新连接为止。 检查限制 `SHOW USERS`、`SHOW GROUPS` 和 `SHOW SERVICE ACCOUNTS` 会在 `memory_limit` 列中报告每个主体的限制,单位为字节。对于用户,这是其自身限制,或在其自身无限制时为其群组中最严格的限制。对于群组和服务账户,则是该实体自身的限制。该列不包含服务器全局的工作负载限制。`null` 表示该实体自身没有限制,对于用户而言也未继承任何限制,因此其查询适用工作负载限制。 过滤形式 `SHOW GROUPS userName` 和 `SHOW SERVICE ACCOUNTS { userName | groupName }` 也带有该列,报告列表中每个群组或服务账户的自身限制。这显示了对于自身无限制的用户,哪个继承的限制生效。 `query_activity` 通过其 `memory_limit` 和 `memory_used` 列暴露每个正在运行的查询的有效限制和实时使用情况。 `SHOW USER` 不带该列。未过滤的 `SHOW USERS`、`SHOW GROUPS` 和 `SHOW SERVICE ACCOUNTS` 需要 `LIST USERS` 权限;过滤形式需要 `USER DETAILS` 权限,除非调用者指定其自身或自身所属群组。没有 `LIST USERS` 权限的用户仍可从 `query_activity` 的 `memory_limit` 列读取其自身的有效上限,因为该视图始终列出调用者自身的查询。 存储的值持久化在 `sys.acl_entities` 系统表中。该表受保护:只有内置管理员可以读取它,持有 `DATABASE ADMIN` 的 ACL 主体仍会被拒绝访问。 升级 破坏性变更 `memory_limit` 作为最后一列添加到 `SHOW USERS`、`SHOW GROUPS` 和 `SHOW SERVICE ACCOUNTS`(包括其过滤形式)中,无论是否设置限制。对 `sys.acl_entities` 执行 `SELECT *` 也会多返回一列。按位置读取这些结果的客户端必须更新;按列名读取的客户端不受影响。 `SHOW` 结果从升级后的二进制文件首次启动时携带该列,在限制被设置前读取为 `null`。存储该值的 `sys.acl_entities` 列由自动迁移添加,当升级后的节点首次作为 primary 启动或从副本晋升为 primary 时触发。在迁移应用之前,持久化的主体限制不会被强制执行。迁移过程经过两个窗口,每个窗口拒绝不同类型的语句: 在列存在之前,带有非零大小的 `SET MEMORY LIMIT` 会被拒绝,报错: `Cannot modify ACL entities: the memory_limit column has not been migrated in yet; retry shortly, or restart the node if it persists`
SET MEMORY LIMIT UNLIMITED 以及 ALTER ... ENABLE 或 DISABLE 语句仍可成功执行。 列已添加但 WAL apply 尚未处理到该列时,SET MEMORY LIMIT UNLIMITED 及 ALTER ... ENABLE 或 DISABLE 同样会被拒绝,从而防止过时的内存值覆盖已存储的限制。非零的 SET MEMORY LIMIT 保留首条错误消息,其他情况则分别显示: “ACL memory_limit 列迁移仍在应用期间无法设置内存限制,请重试 [name=john]
” 状态变更时,则显示“...期间无法启用”或“...期间无法禁用”。 通常情况下,一旦 WAL apply 追上进度,此窗口期会自动关闭,因此请首先重试该语句。若错误持续存在,则重启节点:迁移任务将在启动时重新运行。 权限参考 使用 all_permissions() 查看所有可用权限: SELECT * FROM all_permissions();
完整权限表(点击展开)数据库权限权限级别说明ADD COLUMNDatabase | Table向表中添加列ADD INDEXDatabase | Table | Column在 symbol 列上添加索引ALTER COLUMN CACHEDatabase | Table | Column启用/禁用 symbol 缓存ALTER COLUMN TYPEDatabase | Table | Column修改列类型ATTACH PARTITIONDatabase | Table挂载分区BACKUP DATABASEDatabase创建数据库备份CANCEL ANY COPYDatabase取消 COPY 操作CREATE TABLEDatabase创建表CREATE MATERIALIZED VIEWDatabase创建物化视图CREATE LIVE VIEWDatabase创建 live 视图DEDUP ENABLEDatabase | Table启用去重DEDUP DISABLEDatabase | Table禁用去重DETACH PARTITIONDatabase | Table卸载分区DISABLE STORAGE POLICYDatabase | Table禁用存储策略DROP COLUMNDatabase | Table | Column删除列DROP INDEXDatabase | Table | Column删除索引DROP PARTITIONDatabase | Table删除分区DROP TABLEDatabase | Table删除表DROP MATERIALIZED VIEWDatabase | Table删除物化视图DROP LIVE VIEWDatabase | Table删除 live 视图ENABLE STORAGE POLICYDatabase | Table启用存储策略INSERTDatabase | Table插入数据REFRESH MATERIALIZED VIEWDatabase | Table刷新物化视图REINDEXDatabase | Table | Column重建列索引REMOVE STORAGE POLICYDatabase | Table移除存储策略RENAME COLUMNDatabase | Table | Column重命名列RENable TABLEDatabase | Table重命名表RESUME WALDatabase | Table恢复 WAL 处理SELECTDatabase | Table | Column读取数据SET STORAGE POLICYDatabase | Table设置存储策略SET TABLE PARAMDatabase | Table设置表参数SET TABLE TYPEDatabase | Table修改表类型SETTINGSDatabase在 Web Console 中修改实例设置SNAPSHOTDatabase创建快照SQL ENGINE ADMINDatabase查看/取消正在运行的查询SWITCH ROLEDatabase切换复制角色,参见 SWITCH STATUSSYSTEM ADMINDatabase系统函数(reload_tls 等)TRUNCATE TABLEDatabase | Table清空表UPDATEDatabase | Table | Column更新数据VACUUM TABLEDatabase | Table回收存储空间 用户管理权限权限说明ADD EXTERNAL ALIAS创建外部组映射ADD PASSWORD设置用户密码ADD USER将用户添加到组CREATE GROUP创建组CREATE JWK创建 JWK tokenCREATE REST TOKEN创建 REST API tokenCREATE SERVICE ACCOUNT创建服务账号CREATE USER创建用户DISABLE USER禁用用户DROP GROUP删除组DROP JWK删除 JWK tokenDROP REST TOKEN删除 REST API tokenDROP SERVICE ACCOUNT删除服务账号DROP USER删除用户ENABLE USER启用用户LIST USERS列出用户/组/服务账号REMOVE EXTERNAL ALIAS移除外部组映射REMOVE PASSWORD移除密码REMOVE USER将用户从组中移除SET MEMORY LIMIT为用户、组和服务账号设置内存限制USER DETAILS查看用户/组/服务账号详情 特殊权限权限说明ALL所授级别(数据库/表/列)的所有权限DATABASE ADMIN包括未来新增在内的所有权限;可切换到任意服务账号 少数操作保留给数据库管理员,无法作为权限授予: 操作说明ALTER TABLE REBASE WAL使用新的 sequencer 重建处于挂起状态的 WAL 表SWITCH COLD STORAGE ROLE转移冷存储管理角色,支持 FORCE 相比之下,用于转移复制角色的 SWITCH ROLE 只是一条普通的可授予权限。 SQL 命令参考 ADD USER ALTER GROUP ALTER SERVICE ACCOUNT ALTER USER ASSUME SERVICE ACCOUNT CREATE GROUP CREATE SERVICE ACCOUNT CREATE USER DROP GROUP DROP SERVICE ACCOUNT DROP USER EXIT SERVICE ACCOUNT GRANT GRANT ASSUME SERVICE ACCOUNT REMOVE USER REVOKE REVOKE ASSUME SERVICE ACCOUNT SHOW USER SHOW USERS SHOW GROUPS SHOW SERVICE ACCOUNT SHOW SERVICE ACCOUNTS SHOW PERMISSIONS