[TOC] # 表級副本的使用 租戶級副本變更操作，請參見[Locality 管理](https://open.oceanbase.com/docs/community/oceanbase-database/V3.1.0/locality-management-overview)章節。 表級副本主要通過建表時指定 Locality 屬性或者`ALTER TABLE`語句指定 Locality 屬性，示例語句如下所示： ~~~ CREATE TABLE table_name (...) locality='XXX,XXX,XXX'; ALTER TABLE table_name SET locality='XXX,XXX,XXX'; ~~~ ## 表級 Locality 操作范圍 默認表級 Locality 為空的表，通過變更租戶 Locality 可批量調整租戶下所有表的副本分布。Locality 不為空的表，可通過表級 Locality 變更來調整目標表的副本分布，即表級 Locality 的變更對象為表 Locality 不為空的表。 ## 操作方式和變更進度查詢 表級 Locality 的操作方式與租戶級 Locality 相同，僅支持每次一個 Zone 上的 Locality 變更。并且變更后的表 Locality 仍然要滿足與當前租戶 Locality 的匹配限制。表級 Locality 的變更流程也與租戶級 Locality 相同，但變更對象僅限于對單個目標表。變更執行后，可登錄系統租戶運行下述 SQL 語句以查詢變更進度： ~~~ obclient> SELECt gmt_create, gmt_modified, tenant_id, table_name, job_type, job_status FROM __all_rootservice_job WHERE job_type LIKE '%LOCALITY%' ORDER BY job_id DESC; ~~~ **說明** 租戶級 Locality 變更也可使用上述語句進行查詢，返回結果中的`tenant id`和`table_name`列中會顯示變更對象的具體值。對于表級 Locality 的變更，返回結果中的`tenant_id`為 NULL。 ## 操作注意事項 * 對表級 Locality 非空的不同目標表，Locality 變更操作可以同時進行。 * 對表級 Locality 非空的表執行 Locality 變更后，在變更未完成時不允許該表所屬的租戶發生 Locality 變更，即此時通過`ALTER TENANT`語句發起的租戶 Locality 變更會失敗。 * 對表級 Locality 非空的表，如需在 Zone 或 Region 中調整 readonly 或 memonly 等 non\_paxos 類型副本（即不參與投票的副本）的數量時，需要直接修改租戶的 Locality 屬性列來實現。增減 non\_paxos 副本的任務會直接交由 Rootservice 的負載均衡線程完成。 * 對表級 Locality 為空的表，如果需要在 Zone 和 Region 內增加 non\_paxos 類型副本時，可通過`ALTER TABLE`修改此表。例如，`tenant Locality=F@z1,F@z2,F@z3`中有一個 Locality 為空的表，通過`ALTER TABLE`修改為`Locality=F@z1,F@z2,R@z3`后該表的 Locality 不再為空。同樣增減 non\_paxos 副本的任務也是直接交由 Rootservice 的負載均衡線程完成。 * 不支持將 Locality 非空的表修改為空。 * sys 租戶系統表的 Locality 都必須與 sys 租戶的 Locality 保持一致，即系統表的 Locality 始終為空，不支持修改系統表中表級的 Locality 修改。 * 在為整個租戶的所有表增加、減少或修改 Locality 時需要執行如下兩步操作： 1. 對租戶 Locality 做變更。 2. 對租戶下所有不為空的表 Locality 做變更。 在完成第一步租戶 Locality 的變更后必須人工進行第二步表 Locality 的變更，如果越過第二步進行下一輪的租戶 Locality 變更，將產生不可預知的錯誤。 ## 示例 假設集群在杭州有三個機房分別為 hz1@Hangzhou、hz2@Hangzhou 和 hz3@Hangzhou。且租戶的默認三個全功能 Locality 分別設定為 F@hz1、F@hz2 和 F@hz3。 當需要定義一個表，且要求其只讀副本部署在集群中所有 OBServer 節點上時，可以通過下述的 SQL 語句進行創建： ~~~ CREATE TABLE table_name (...) locality = 'F@hz1, F@hz2, F@hz3, R{all_server}@hz1, R{all_server}@hz2, R{all_server}@hz3'; ~~~ 也可通過下述的`ALTER TABLE`語句進行修改： ~~~ ALTER TABLE table_name set locality = 'F@hz1, F@hz2, F@hz3, R{all_server}@hz1, R{all_server}@hz2, R{all_server}@hz3'; ~~~ 執行后等待`__all_rootservice_job`表中對應任務記錄狀態變為**SUCCESS**，即說明創建或修改完成。 **注意** 表級 Locality 的變更與租戶級 Locality 變更具有如下制約關系： * 在舊的一輪租戶級 Locality 沒有完成變更時，新一輪的租戶級 Locality 變更不允許被執行。 * 當租戶下 Locality 不為空的表的變更沒有完成時，租戶級 Locality 變更不允許執行。 * 當租戶在目標 Zone 的 Locality 變更沒有發起時，Locality 不為空的表在目標 Zone 的 Locality 變更不允許執行。 綜上所述，租戶級 Locality 變更不允許同時發起多輪變更，租戶和表的 Locality 變更前需要先完成未完成的變更