ALTER ACCOUNT

语法说明

修改租户信息。

Note

  1. 集群管理员（即 root 用户）可以修改它所创建的租户的密码。
  2. 租户本身可以修改自己的密码。
  3. 仅集群管理员（即 root 用户）可以执行暂停（SUSPEND）、恢复（OPEN）和限制（RESTRICTED）租户的操作。

语法结构

  1. > ALTER ACCOUNT [IF EXISTS]
  2. account auth_option [COMMENT 'comment_string']
  4. auth_option: {
  5. ADMIN_NAME [=] 'admin_name'
  6. IDENTIFIED BY 'auth_string'
  7. }
  9. status_option: {
  10. OPEN
  11. | SUSPEND
  12. | RESTRICTED
  13. }

参数释义

auth_option

修改租户的帐号名和授权方式，auth_string 表示显式返回指定密码。

status_option

设置租户的状态。作为 VARCHAR 类型存储在系统数据库 mo_catalog 下的 mo_account 表中。

  • SUSPEND：暂停某个租户的服务，即暂停后该租户不能再访问 MatrixOne；正在访问的租户也无法再访问 MatrixOne。
  • OPEN：恢复某个暂停状态的租户，恢复后，该租户将正常访问 MatrixOne。
  • RESTRICTED：允许用户访问并做出有限的行为。对租户启用了 RESTRICTED 状态以后，这个租户只能对数据库进行 SHOW/DELETE/SELECT/USE/SET 操作，其他操作不可以使用。
    • 对该租户启用了 RESTRICTED 状态后，即使租户正在访问，访问行为也将受到限制。
    • 解除对用户的限制，将状态切换为 OPEN 即可解除限制，即使用 ALTER ACCOUNT account_name OPEN 解除限制。

comment

租户注释作为 VARCHAR 类型存储在系统数据库 mo_catalog 下的 mo_account 表中。

COMMENT 可以是任意引用的文本，新的 COMMENT 替换任何现有的用户注释。如下所示：

  1. mysql> desc mo_catalog.mo_account;
  2. +----------------+--------------+------+------+---------+-------+---------+
  3. | Field          | Type         | Null | Key  | Default | Extra | Comment |
  4. +----------------+--------------+------+------+---------+-------+---------+
  5. | account_id     | INT          | YES  |      | NULL    |       |         |
  6. | account_name   | VARCHAR(300) | YES  |      | NULL    |       |         |
  7. | status         | VARCHAR(300) | YES  |      | NULL    |       |         |
  8. | created_time   | TIMESTAMP    | YES  |      | NULL    |       |         |
  9. | comments       | VARCHAR(256) | YES  |      | NULL    |       |         |
  10. | suspended_time | TIMESTAMP    | YES  |      | null    |       |         |
  11. +----------------+--------------+------+------+---------+-------+---------+
  12. 6 rows in set (0.06 sec)

示例

  • 示例 1：修改租户信息
  1. -- 创建一个名为 "root1" 密码为 "111" 租户
  2. mysql> create account acc1 admin_name "root1" identified by "111";
  3. Query OK, 0 rows affected (0.42 sec)
  4. -- 将租户的初始密码 "111" 修改为 "Abcd_1234@1234"
  5. mysql> alter account acc1 admin_name "root1" identified by "Abcd_1234@1234";
  6. Query OK, 0 rows affected (0.01 sec)
  7. -- 修改租户 "root1" 的备注
  8. mysql> alter account acc1 comment "new accout";
  9. Query OK, 0 rows affected (0.02 sec)
  10. -- 查看验证是否给租户 "root1" 增加了 "new accout" 的备注
  11. mysql> show accounts;
  12. +--------------+------------+---------------------+--------+----------------+----------+-------------+-----------+-------+----------------+
  13. | account_name | admin_name | created             | status | suspended_time | db_count | table_count | row_count | size  | comment        |
  14. +--------------+------------+---------------------+--------+----------------+----------+-------------+-----------+-------+----------------+
  15. | acc1         | root1      | 2023-02-15 06:26:51 | open   | NULL           |        5 |          34 |       787 | 0.036 | new accout     |
  16. | sys          | root       | 2023-02-14 06:58:15 | open   | NULL           |        8 |          57 |      3767 | 0.599 | system account |
  17. +--------------+------------+---------------------+--------+----------------+----------+-------------+-----------+-------+----------------+
  18. 3 rows in set (0.19 sec)
  • 示例 2：修改租户状态
  1. -- 创建一个名为 "root1" 密码为 "111" 租户
  2. mysql> create account accx admin_name "root1" identified by "111";
  3. Query OK, 0 rows affected (0.27 sec)
  4. -- 修改租户状态为 "suspend"，即暂停用户访问 MatrixOne
  5. mysql> alter account accx suspend;
  6. Query OK, 0 rows affected (0.01 sec)
  7. -- 查看一下是否修改状态成功
  8. mysql> show accounts;
  9. +--------------+------------+---------------------+---------+---------------------+----------+-------------+-----------+-------+----------------+
  10. | account_name | admin_name | created             | status  | suspended_time      | db_count | table_count | row_count | size  | comment        |
  11. +--------------+------------+---------------------+---------+---------------------+----------+-------------+-----------+-------+----------------+
  12. | accx         | root1      | 2023-02-15 06:26:51 | suspend | 2023-02-15 06:27:15 |        5 |          34 |       787 | 0.036 | new accout     |
  13. | sys          | root       | 2023-02-14 06:58:15 | open    | NULL                |        8 |          57 |      3767 | 0.599 | system account |
  14. +--------------+------------+---------------------+---------+---------------------+----------+-------------+-----------+-------+----------------+
  15. 2 rows in set (0.15 sec)