[TOC] # 新建租戶 ## 通過 SQL 語句新建 OceanBase 數據庫僅支持 MySQL 類型的租戶。只有用 root 用戶連接到 sys 租戶（`root@sys`）才能執行`CREATE TENANT`命令去創建租戶。創建新租戶后，可以指定創建租戶的類型和白名單。 下述展示了創建租戶命令的語法： ~~~ CREATE TENANT [IF NOT EXISTS] tenantname [tenant_characteristic_list] [tenant_variables_list] tenant_characteristic_list: tenant_characteristic [, tenant_characteristic...] tenant_characteristic: COMMENT 'string' | {CHARACTER SET | CHARSET} [=] value | REPLICA_NUM [=] num | ZONE_LIST [=] (zone [, zone]) | PRIMARY_ZONE [=] zone | RESOURCE_POOL_LIST [=] (poolname) | {READ ONLY | READ WRITE} tenant_variables_list: SET sys_variables_list | SET VARIABLES sys_variables_list | VARIABLES sys_variables_list sys_variables_list: sys_variables [, sys_variables...] sys_variables: sys_variable_name = expr ~~~ 參數說明： * 如果要創建的租戶名已存在，并且沒有指定`IF NOT EXISTS`，則會出現錯誤。 * 租戶名的合法性和變量名一致，最長 30 個字符，字符只能是大小寫英文字母、數字和下劃線，而且必須以字母或下劃線開頭，并且不能是 OceanBase 數據庫的關鍵字。 * 在租戶下可以指定資源池。 * `RESOURCE_POOL_LIST`為創建租戶時的必填項。 * `CREATE TENANT`命令中的`RESOURCE_POOL_LIST`中，暫時僅支持一個資源池。 **示例 1**： 下述語句展示了創建名為`test_tenant`的一個 3 副本的 MySQL 租戶（創建新租戶默認是 MySQL 租戶）。 ~~~ obclient> CREATE TENANT IF NOT EXISTS test_tenant charset='utf8mb4', replica_num=3, zone_list=('zone1','zone2','zone3'), primary_zone='zone1;zone2,zone3', resource_pool_list=('pool1') ~~~ **示例 2**： 下述語句展示了創建租戶后，直接通過修改變量`ob_tcp_innvited_nodes`的值為`%`以便允許任何客戶端 IP 連接該租戶。如果不調整，默認租戶的連接方式為只允許本機的 IP 連接數據庫。 ~~~ obclient> CREATE TENANT IF NOT EXISTS test_tenant charset='utf8mb4', replica_num=3, zone_list=('zone1','zone2','zone3'), primary_zone='zone1;zone2,zone3', resource_pool_list=('pool1') SET ob_tcp_invited_nodes='%' ~~~ 示例說明如下： * `primary_zone`指該租戶的表的分區 Leader 所在的 Zone ，例如，`primary_ zone =' zone1; zone2, zone3'`表示該租戶的表的分區 Leader 在`zone1`上， 這時通過分號來分隔。 * `zone2`和`zone3`通過逗號分割，表示`zone2`和`zone3`是同一優先級，但是比`zone1`優先級低。 * `primary_zone`設置時，其值可以為`RANDOM`（必須大寫），表示隨機。 普通租戶的內存最小規格必須大于等于 5 GB，否則創建租戶失敗。如果希望建立租戶進行非常簡單的功能測試，可以修改參數`alter system __min_full_resource_pool_memory`的值為`1073741824`來允許以最小 1 GB 內存的規格創建租戶。