大网数据广告活动
数据库部署与 SQL 参考

本地身份验证

· 52CE 我爱测

StarRocks 本地身份验证是一种基于密码的身份验证方法。此外,StarRocks 还支持与外部身份验证系统集成,如 LDAP。更多说明,请参见通过安全集成认证用户。

本地身份验证

通过 SQL 命令在 StarRocks 中使用本地身份验证创建和管理用户。

StarRocks 本地身份验证是一种基于密码的身份验证方法。此外,StarRocks 还支持与外部身份验证系统集成,如 LDAP。更多说明,请参见通过安全集成认证用户。

具有系统定义角色 user_admin 的用户可以在 StarRocks 中创建用户、修改用户和删除用户。

StarRocks 集群最初创建时,系统会自动生成 root 用户,该用户拥有 root 权限。由于 root 用户、角色的权限范围过大,建议您在后续使用和维护集群时创建新的用户和角色,避免直接使用此用户和角色。root 用户的密码请您妥善保管。

创建用户

您可以通过指定用户身份、身份验证方法以及可选的默认角色来创建用户。要为用户启用本地身份验证,您需要明确指定明文或密文密码。

以下示例创建用户 jack,仅允许其从 IP 地址 172.10.1.10 连接,启用本地身份验证,将密码设置为明文 12345,并将角色 example_role 作为其默认角色分配给它:

CREATE USER jack@'172.10.1.10' IDENTIFIED BY '12345' DEFAULT ROLE 'example_role';
  • StarRocks 在存储用户密码之前会对其进行加密。您可以使用 password() 函数获取加密后的密码。
  • 如果在创建用户时未指定默认角色,则会为用户分配系统定义的默认角色 PUBLIC。

用户的默认角色在连接到 StarRocks 时会自动激活。有关如何在连接后为用户启用所有(默认和授予的)角色的说明,请参见启用所有角色。

有关创建用户的更多信息和高级说明,请参见CREATE USER。

变更用户

您可以更改用户的密码、默认角色或属性。

有关如何更改用户默认角色的说明,请参见更改用户的默认角色。

变更用户属性

您可以使用 ALTER USER 设置用户的属性。

以下示例将用户 jack 的最大连接数设置为 1000。具有相同用户名的用户身份共享相同的属性。

因此,您只需为 jack 设置属性,此设置将对所有具有用户名 jack 的用户身份生效。

ALTER USER 'jack' SET PROPERTIES ("max_user_connections" = "1000");

重置用户密码

您可以使用 SET PASSWORD 或 ALTER USER 重置用户的密码。

NOTE

  • 任何用户都可以在不需要任何权限的情况下重置自己的密码。

以下两个示例都将 jack 的密码重置为 54321:

  • 使用 SET PASSWORD 重置密码:

    SET PASSWORD FOR jack@'172.10.1.10' = PASSWORD('54321');
    
  • 使用 ALTER USER 重置密码:

    ALTER USER jack@'172.10.1.10' IDENTIFIED BY '54321';
    

重置遗失的 root 用户密码

只有 root 用户本身可以设置其密码。如果您丢失了 root 用户的密码并且无法连接到 StarRocks,可以通过以下步骤重置:

  1. 在 所有 FE 节点 的配置文件 fe/conf/fe.conf 中添加以下配置项以禁用用户身份验证:

    enable_auth_check = false
    
  2. 重启 所有 FE 节点 以使配置生效。

    ./fe/bin/stop_fe.sh
    ./fe/bin/start_fe.sh
    
  3. 从 MySQL 客户端通过 root 用户连接到 StarRocks。禁用用户身份验证时,无需指定密码。

    mysql -h <fe_ip_or_fqdn> -P<fe_query_port> -uroot
    
  4. 重置 root 用户的密码。

    SET PASSWORD for root = PASSWORD('xxxxxx');
    
  5. 通过在 所有 FE 节点 的配置文件 fe/conf/fe.conf 中将配置项 enable_auth_check 设置为 true 来重新启用用户身份验证。

    enable_auth_check = true
    
  6. 重启 所有 FE 节点 以使配置生效。

    ./fe/bin/stop_fe.sh
    ./fe/bin/start_fe.sh
    
  7. 从 MySQL 客户端使用 root 用户和新密码连接到 StarRocks,以验证密码是否重置成功。

    mysql -h <fe_ip_or_fqdn> -P<fe_query_port> -uroot -p<xxxxxx>
    

删除用户

您可以使用 DROP USER 删除用户。

以下示例删除用户 jack:

DROP USER jack@'172.10.1.10';

查看用户

您可以使用 SHOW USERS 查看 StarRocks 集群中的所有用户。

SHOW USERS;

查看用户属性

您可以使用 SHOW PROPERTY 查看用户的属性。

以下示例显示用户 jack 的属性:

SHOW PROPERTY FOR 'jack';

或者查看特定属性:

SHOW PROPERTY FOR 'jack' LIKE 'max_user_connections';

本文来自 StarRocks 文档贡献者,按 Apache 2.0 整理版式与相对链接,保留正文与代码。图示请参阅原文。作者与贡献记录。

资料来源与适用范围

资料来源
StarRocks 文档贡献者
适用范围
main 文档快照(2026-11-16)
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
Apache 2.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。