我的书签
添加书签
移除书签在存算分离架构下，可以将一个或多个计算节点 (BE) 组成一个计算集群 (Compute Cluster)。本文档介绍如何使用计算集群，其中涉及的操作包括：
- 查看所有计算集群
- 计算集群授权
- 在用户级别绑定计算集群 (
default_cloud_cluster) 以达到用户级别的隔离效果
备注
本文涉及的 cluster 均表示计算集群。
查看所有计算集群
可通过 show clusters 查看当前仓库拥有的所有计算集群。
> mysql show clusters;+-------------------------------+------------+------------+| cluster | is_current | users |+-------------------------------+------------+------------+| regression_test_cluster_name0 | FALSE | root, jack || regression_test_cluster_name5 | FALSE | |+-------------------------------+------------+------------+2 rows in set (0.01 sec)mysql SET PROPERTY 'default_cloud_cluster' = 'regression_test_cluster_name5';Query OK, 0 rows affected (0.01 sec)
授予计算集群访问权限
使用 MySQL Client 创建一个新用户。
语法
GRANT USAGE_PRIV ON CLUSTER {cluster_name} TO {user}
示例
// 使用 Root 账号在 MySQL Client 中创建 Jack 用户mysql CREATE USER jack IDENTIFIED BY '123456' DEFAULT ROLE "admin";Query OK, 0 rows affected (0.01 sec)mysql GRANT USAGE_PRIV ON CLUSTER regression_test_cluster_name0 TO jack;Query OK, 0 rows affected (0.01 sec)// 使用 Jack 登录 MySQL Clientmysql use d1@regression_test_cluster_name0;Database changedmysql show grants for jack\G*************************** 1. row ***************************UserIdentity: 'jack'@'%'Password: YesGlobalPrivs: Admin_priv (false)CatalogPrivs: NULLDatabasePrivs: internal.information_schema: Select_priv (false)TablePrivs: NULLResourcePrivs: NULLCloudCluster: regression_test_cluster_name0: Usage_priv (false)CloudStage: NULL1 row in set (0.00 sec)mysql select * from t1;+------+------+-------+| id | name | score |+------+------+-------+| 1 | aaa | 20 || 2 | bbb | 320 || 3 | ccc | 30 || 4 | ddd | 120 || 5 | eee | 30 || 6 | fff | 30 || 7 | ggg | 90 || 8 | hhh | 30 |+------+------+-------+8 rows in set (12.70 sec)mysql insert into t1 (id, name, score) values (8, "hhh", 30);Query OK, 1 row affected (7.22 sec){'label':'insert_6f40c1713baf4d61_9c33c0962c68ab07', 'status':'VISIBLE', 'txnId':'5462662627547136'}
若向 Jack 用户授权一个不存在的计算集群，系统不会报错，而会在执行相应的 use @cluster 时报错。
mysql GRANT USAGE_PRIV ON CLUSTER not_exist_cluster TO jack;Query OK, 0 rows affected (0.05 sec)mysql show grants for jack\G*************************** 1. row ***************************UserIdentity: 'jack'@'%'Password: YesGlobalPrivs: Admin_priv (false)CatalogPrivs: NULLDatabasePrivs: internal.information_schema: Select_priv (false)TablePrivs: NULLResourcePrivs: NULLCloudCluster: not_exist_cluster: Usage_priv (false)CloudStage: NULL1 row in set (0.00 sec)切换到 Jack 账号，执行 use @not_exist_cluster，将出现提示 not_exist_cluster 不存在的报错提示mysql use information_schema@not_exist_cluster;No connection. Trying to reconnect...Connection id: 1Current database: *** NONE ***ERROR 5091 (42000): Cluster not_exist_cluster not exist
撤销计算集群访问权限
语法
REVOKE USAGE_PRIV ON CLUSTER {cluster_name} FROM {user}
示例
// 使用 Root 账号在 MySQL Client 中创建 Jack 用户mysql REVOKE USAGE_PRIV ON CLUSTER regression_test_cluster_name0 FROM jack;Query OK, 0 rows affected (0.01 sec)mysql show grants for jack\G*************************** 1. row ***************************UserIdentity: 'jack'@'%'Password: YesGlobalPrivs: Admin_priv (false)CatalogPrivs: NULLDatabasePrivs: internal.information_schema: Select_priv (false)TablePrivs: NULLResourcePrivs: NULLCloudCluster: NULLCloudStage: NULL1 row in set (0.01 sec)
设置默认计算集群
用户可从多个计算集群选择设置为默认计算集群。
语法
为当前用户设置默认计算集群：
SET PROPERTY 'default_cloud_cluster' = '{clusterName}';
为其他用户设置默认计算集群（此操作需要 Admin 权限）：
SET PROPERTY FOR {user} 'default_cloud_cluster' = '{clusterName}';
查看当前用户默认计算集群，返回结果中default_cloud_cluster 的值即为默认计算集群：
SHOW PROPERTY;
查看其他用户默认计算集群，此操作需要当前用户具备相关权限，返回结果中default_cloud_cluster 的值即为默认计算集群：
SHOW PROPERTY FOR {user};
查看当前仓库下所有可用的计算集群：
SHOW CLUSTERS;
备注
- 若当前用户拥有 Admin 角色，例如：
CREATE USER jack IDENTIFIED BY '123456' DEFAULT ROLE "admin"，则：- 可以为自身以及其他用户设置默认计算集群；
- 可以查看自身以及其他用户的
PROPERTY。
- 若当前用户无 Admin 角色，例如：
CREATE USER jack1 IDENTIFIED BY '123456'，则：- 可以为自身设置默认计算集群；
- 可以查看自身的
PROPERTY； - 无法查看所有计算集群，因该操作需要
GRANT ADMIN权限。
- 若当前用户未配置默认计算集群，现有系统在执行数据读写操作时将会触发错误。为解决这一问题，用户可通过执行
use @cluster命令来指定当前 Context 所使用的计算集群，或者使用SET PROPERTY语句来设置默认计算集群。 - 若当前用户已配置默认计算集群，但随后该集群被删除，则在执行数据读写操作时同样会触发错误。用户可通过执行
use @cluster命令来重新指定当前 Context 所使用的计算集群，或者利用SET PROPERTY语句来更新默认集群设置。
示例
// 设置当前用户的默认计算集群mysql SET PROPERTY 'default_cloud_cluster' = 'regression_test_cluster_name0';Query OK, 0 rows affected (0.02 sec)// 展示当前用户的默认计算集群mysql show PROPERTY;+------------------------+-------------------------------+| Key | Value |+------------------------+-------------------------------+| cpu_resource_limit | -1 || default_cloud_cluster | regression_test_cluster_name0 || exec_mem_limit | -1 || load_mem_limit | -1 || max_query_instances | -1 || max_user_connections | 100 || quota.high | 800 || quota.low | 100 || quota.normal | 400 || resource.cpu_share | 1000 || resource.hdd_read_iops | 80 || resource.hdd_read_mbps | 30 || resource.io_share | 1000 || resource.ssd_read_iops | 1000 || resource.ssd_read_mbps | 30 || resource_tags | || sql_block_rules | |+------------------------+-------------------------------+17 rows in set (0.00 sec)// 使用 Root 账号在 MySQL Client 中创建 Jack 用户mysql CREATE USER jack IDENTIFIED BY '123456' DEFAULT ROLE "admin";Query OK, 0 rows affected (0.01 sec)// 为 jack 用户设置默认计算集群mysql SET PROPERTY FOR jack 'default_cloud_cluster' = 'regression_test_cluster_name1';Query OK, 0 rows affected (0.00 sec)// 查看其他用户的默认计算集群mysql show PROPERTY for jack;+------------------------+-------------------------------+| Key | Value |+------------------------+-------------------------------+| cpu_resource_limit | -1 || default_cloud_cluster | regression_test_cluster_name1 || exec_mem_limit | -1 || load_mem_limit | -1 || max_query_instances | -1 || max_user_connections | 100 || quota.high | 800 || quota.low | 100 || quota.normal | 400 || resource.cpu_share | 1000 || resource.hdd_read_iops | 80 || resource.hdd_read_mbps | 30 || resource.io_share | 1000 || resource.ssd_read_iops | 1000 || resource.ssd_read_mbps | 30 || resource_tags | || sql_block_rules | |+------------------------+-------------------------------+17 rows in set (0.00 sec)
若用户意图设置为默认计算集群的计算集群不存在，系统会报错并提示用户使用 SHOW CLUSTERS 命令来查看当前仓库下所有有效的计算集群。SHOW CLUSTERS 命令将返回一个结果集，其中：
Cluster列表示计算集群名称。is_current列表示当前用户是否使用此计算集群。Users列表示该计算集群被以下用户设置为默认计算集群。
mysql SET PROPERTY 'default_cloud_cluster' = 'not_exist_cluster';ERROR 5091 (42000): errCode = 2, detailMessage = Cluster not_exist_cluster not exist, use SQL 'SHOW CLUSTERS' to get a valid clustermysql show clusters;+-------------------------------+------------+------------+| cluster | is_current | users |+-------------------------------+------------+------------+| regression_test_cluster_name0 | FALSE | root, jack || regression_test_cluster_name5 | FALSE | |+-------------------------------+------------+------------+2 rows in set (0.01 sec)mysql SET PROPERTY 'default_cloud_cluster' = 'regression_test_cluster_name5';Query OK, 0 rows affected (0.01 sec)
默认计算集群的选择机制
当用户未明确设置默认计算集群时，系统将自动为用户选择一个具有 Active 后端且用户具有使用权限的计算集群。在特定会话中确定默认计算集群后，默认计算集群将在该会话期间保持不变，除非用户显式更改了默认设置。
在不同次的会话中，若发生以下情况，系统可能会自动更改用户的默认计算集群：
- 用户失去了在上次会话中所选择默认计算集群的使用权限
- 有集群被添加或移除
- 上次所选择的默认计算集群不再具有 Active 后端
其中，情况一和情况二必定会导致系统自动选择的默认计算集群更改，情况三可能会导致更改。
切换计算集群
用户可在存算分离架构中指定使用的数据库和计算集群。
语法
USE { [catalog_name.]database_name[@cluster_name] | @cluster_name }
若数据库或计算集群名称包含是保留关键字，需用反引号将相应的名称 ``` 包围。
示例
指定使用数据库 test_database：
USE test_database或者USE `test_database`
指定使用计算集群 test_cluster：
USE @test_cluster或者USE @`test_cluster`
同时指定使用数据库 test_database 和计算集群 test_cluster
USE test_database@test_clusterUSE `test_database`@`test_cluster`
