[TOC] # CREATE TENANT ## 描述 該語句用來創建租戶。 ## 格式 ~~~ CREATE TENANT [IF NOT EXISTS] tenantname [tenant_characteristic_list] [opt_set_sys_var] tenant_characteristic_list: tenant_characteristic [, tenant_characteristic...] tenant_characteristic: COMMENT 'string' |{CHARACTER SET | CHARSET} [=] charsetname |COLLATE [=] collationname |REPLICA_NUM [=] num |ZONE_LIST [=] (zone [, zone…]) |PRIMARY_ZONE [=] zone |DEFAULT TABLEGROUP [=] {NULL | tablegroup} |RESOURCE_POOL_LIST [=](poolname [, poolname…]) |LOGONLY_REPLICA_NUM [=] num |LOCALITY [=] 'locality description' opt_set_sys_var: { SET | SET VARIABLES | VARIABLES } system_var_name = expr [,system_var_name = expr] ... ~~~ ## 參數解釋 <table data-tag="table" id="table-ehx-j39-ryh" class="table"><colgroup width="360" span="1" data-tag="col" id="col-5p0-qn4-cl6" colwidth="1*" colnum="1" colname="col1" style="width:50%" class="col"></colgroup><colgroup width="360" span="1" data-tag="col" id="col-lh9-qcs-xdc" colwidth="1*" colnum="2" colname="col2" style="width:50%" class="col"></colgroup><thead id="thead-6ol-y3f-ae0" class="thead"><tr id="tr-305-cu1-6no"><th id="td-g77-8na-pm2"><p id="p-jg9-8l6-x3s"><b>參數</b></p></th><th id="td-sn6-d8f-qcg"><p id="p-kw8-hj6-p5g"><b>描述</b></p></th></tr></thead><tbody data-tag="tbody" id="tbody-4tw-ir6-o5f" class="tbody"><tr data-tag="tr" id="tr-s11-mi2-thf" class="tr"><td data-tag="td" id="td-z2x-aze-fye" class="td"><p id="p-rn1-taz-yiw">tenant_name</p></td><td data-tag="td" id="td-c6m-2z4-0cu" class="td"><p data-tag="p" id="p-m39-80g-omi" class="p">指定租戶名。最長64個字節，只能有大小寫英文字母，數字和下劃線，而且必須以字母或下劃線開頭，并且不能是OceanBase的關鍵字。</p></td></tr><tr data-tag="tr" id="tr-3hb-8u4-myu" class="tr"><td data-tag="td" id="td-waw-w9v-nqe" class="td"><p data-tag="p" id="p-h5r-8o9-5x7" class="p">IF NOT EXISTS</p></td><td data-tag="td" id="td-gzq-hmt-06c" class="td"><p data-tag="p" id="p-uq9-4up-4go" class="p">如果要創建的租戶名已存在，并且沒有指定IF NOT EXISTS，則會報錯。</p></td></tr><tr data-tag="tr" id="tr-l42-12l-in5" class="tr"><td data-tag="td" id="td-mna-2wp-1wx" class="td"><p id="p-58d-m4a-59r">RESOURCE_POOL_LIST</p></td><td data-tag="td" id="td-ln7-vua-swf" class="td"><p data-tag="p" id="p-xpd-jwo-nwi" class="p">資源池列表，為創建租戶時的必填項，暫時只支持一個 RESOURCE POOL。</p></td></tr><tr data-tag="tr" id="tr-b0l-8re-3xf" class="tr"><td data-tag="td" id="td-wf2-vjz-06j" class="td"><p data-tag="p" id="p-nt2-h87-dla" class="p">DEFAULT TABLEGROUP</p></td><td data-tag="td" id="td-pbn-5b7-lyi" class="td"><p id="p-6lh-z3s-pxl">設置租戶默認表組信息，NULL 表示取消默認表組。如果不指定，默認為 NULL。</p></td></tr><tr data-tag="tr" id="tr-pet-vxt-osa" class="tr"><td data-tag="td" id="td-jv0-514-lmd" class="td"><p id="p-5ti-kdr-gac">COMMENT</p></td><td data-tag="td" id="td-g3f-nfi-a40" class="td"><p data-tag="p" id="p-a0a-pjw-b0u" class="p">修改注釋。</p></td></tr><tr data-tag="tr" id="tr-6sj-cpn-0qi" class="tr"><td data-tag="td" id="td-tjc-i6w-v59" class="td"><p id="p-vzk-k92-64f">CHARACTER SET | CHARSET</p></td><td data-tag="td" id="td-t1k-zwu-15h" class="td"><p data-tag="p" id="p-vfj-ndf-4b1" class="p">修改租戶的字符集。</p></td></tr><tr data-tag="tr" id="tr-ln1-hee-8d7" class="tr"><td data-tag="td" id="td-ct0-l3z-kd2" class="td"><p id="p-ezp-k3i-tce">COLLATE</p></td><td data-tag="td" id="td-ayz-xre-s6k" class="td"><p data-tag="p" id="p-jrz-6lv-i43" class="p">指定校對規則。</p></td></tr><tr data-tag="tr" id="tr-e5c-9pa-frp" class="tr"><td data-tag="td" id="td-5wo-lve-nyd" class="td"><p id="p-qqk-3mg-06u">REPLICA_NUM</p></td><td data-tag="td" id="td-uya-wnd-nbd" class="td"><p data-tag="p" id="p-a7g-iek-axr" class="p">指定副本數。</p></td></tr><tr data-tag="tr" id="tr-h6i-aoc-ile" class="tr"><td data-tag="td" id="td-mwj-980-kfg" class="td"><p id="p-d9q-ddy-gq0">ZONE_LIST</p></td><td data-tag="td" id="td-kk6-8gp-q25" class="td"><p data-tag="p" id="p-la3-8la-mh8" class="p">指定要修改的Zone列表。</p></td></tr><tr data-tag="tr" id="tr-lzv-2b7-i8o" class="tr"><td data-tag="td" id="td-e7q-6x6-tuz" class="td"><p id="p-43e-eg7-6mk">PRIMARY_ZONE</p></td><td data-tag="td" id="td-obm-678-uny" class="td"><p data-tag="p" id="p-ox4-byv-kzd" class="p">指定主Zone。</p></td></tr><tr data-tag="tr" id="tr-p1u-vc5-0gj" class="tr"><td data-tag="td" id="td-e5z-llz-j8h" class="td"><p id="p-mc8-0z7-xcf">LOGONLY_REPLICA_NUM</p></td><td data-tag="td" id="td-2rn-4rt-8un" class="td"><p data-tag="p" id="p-gif-oop-dnn" class="p">指定日志副本數。</p></td></tr><tr data-tag="tr" id="tr-8xv-j9z-w2o" class="tr"><td data-tag="td" id="td-oo9-cr4-p92" class="td"><p id="p-kr1-zip-20p">LOCALITY</p></td><td data-tag="td" id="td-gfk-w06-d5q" class="td"><p id="p-okx-feo-t6w">描述副本在Zone間的分布情況，如：F@z1,F@z2,F@z3,R@z4 表示z1, z2, z3為全功能副本，z4為只讀副本。</p></td></tr><tr data-tag="tr" id="tr-xks-o1l-io4" class="tr"><td data-tag="td" id="td-a9j-kdy-2s1" class="td"><p id="p-9ni-f4x-sm8">system_var_name</p></td><td data-tag="td" id="td-op9-78g-paj" class="td"><p data-tag="p" id="p-sn9-r36-pua" class="p">指定租戶系統變量值。其中 ob_compatibility_mode 系統變量用于指定租戶的兼容模式(MySQL/Oracle)，只能在創建時指定；如果不指定 ob_compatibility_mode ，默認兼容模式為MySQL。</p></td></tr></tbody></table> ## 示例 * 創建租戶。 ~~~ CREATE TENANT IF NOT EXISTS t1 charset='utf8mb4', replica_num=1, zone_list=('zone1'), primary_zone='zone1', resource_pool_list=('pool1'); ~~~ * 創建oracle兼容模式租戶 ~~~ CREATE TENANT IF NOT EXISTS t1 zone_list=('zone1'), primary_zone='zone1', resource_pool_list=('pool1') SET ob_compatibility_mode='oracle'; ~~~ ## 注意事項 只有用root用戶連接到根租戶（root@ROOT）才能執行 CREATE TENANT 去創建租戶。