CREATE USER

描述

CREATE USER 语句用于创建新的 OceanBase 数据库用户。创建新用户后，可以使用新用户连接 OceanBase 数据库。

使用限制及注意事项

• 认证串格式校验：IDENTIFIED AS/BY PASSWORD，校验 $S$ 格式，拒绝 $A$（sha2）等错误格式。
• 标准 MySQL Connector 可以连接使用 caching_sha2_password 认证插件的用户。
• ob_sm3_password 为 OceanBase 特有认证插件，标准 MySQL Connector / 未适配的 ODP 可能无法完成使用该认证插件的用户的连接。

权限要求

执行 CREATE USER 语句创建用户需要当前用户拥有全局的 CREATE USER 权限。有关 OceanBase 数据库权限的详细介绍，请参见 MySQL 模式下的权限分类。

语法

CREATE USER [IF NOT EXISTS] {user [, user...]}
    [REQUIRE {NONE | SSL | X509 | tls_option}]
    [WITH resource_option [resource_option...]];

user:
      user_name
    | user_name IDENTIFIED [WITH auth_plugin] BY password
    | user_name IDENTIFIED [WITH auth_plugin] BY PASSWORD password
    | user_name IDENTIFIED [WITH auth_plugin] AS PASSWORD 'auth_string'

auth_plugin:
    mysql_native_password
    | caching_sha2_password
    | ob_sm3_password

tls_option:
      CIPHER cipher_name
    | ISSUER issuer_name
    | SUBJECT subject_name

resource_option:
      MAX_CONNECTIONS_PER_HOUR integer
    | MAX_USER_CONNECTIONS integer

参数说明

auth_plugin

• mysql_native_password：传统的密码认证插件，使用 SHA-1 哈希算法。

• caching_sha2_password：基于 SHA-256 的密码认证插件，具有更高的安全防护等级。

  说明

  对于 V4.4.2 版本，从 V4.4.2 BP2 版本开始支持认证插件 caching_sha2_password。

• ob_sm3_password：该插件在认证协议与状态机上完全复用 caching_sha2_password（AuthSwitch、快速认证/完整认证、TLS/RSA 传密），但算法与元数据保持独立，使用 SM3 哈希算法替代 SHA-256，用于密码存储与认证校验。

  说明

  对于 V4.4.2 版本，从 V4.4.2 BP3 版本开始支持认证插件 ob_sm3_password。

示例

• 创建用户 test1 和 test2，并指定明文密码及用户允许的最大连接数

  obclient> CREATE USER IF NOT EXISTS test1 IDENTIFIED BY '********', test2 IDENTIFIED BY '********' WITH MAX_USER_CONNECTIONS 10;
  

• 创建用户 test3，指定密文密码，同时指定必须使用 SSL 连接进行身份验证

  obclient> CREATE USER IF NOT EXISTS test3 IDENTIFIED BY PASSWORD '********' REQUIRE SSL;
  

• 创建用户 test4，并指定需使用 mysql_native_password 身份验证插件

  obclient> CREATE USER IF NOT EXISTS test4 IDENTIFIED WITH mysql_native_password BY PASSWORD '********';
  

相关文档

• 授予用户权限的操作可参见 授予权限。

• 可从 mysql.user 表中查看创建的用户信息，mysql.user 表的详细介绍可参见 mysql.user

• 使用创建的用户连接 OceanBase 数据库的操作可参见 连接 OceanBase 数据库 章节。

• 有关创建新用户时使用默认插件的介绍，参见 default_authentication_plugin。

• 有关认证插件的介绍，参见 身份鉴别。