1.2 schema.xml

1.2.1 相关文件

这部分与schema.dtd和schema.xml相关。

在2.18.12.0之后的版本中server.xml在文件头中添加了version属性，以供运维人员区分配置创建或修改的版本(xml配置version对照表)
verison字段不匹配时，启动和dryrun会给出NOTICE的提示，但不会影响功能

schema.dtd定义解析规则, 仅与开发相关。如有疑问，请参看xml_dtd_intro。

schema.xml包含具体的数据主机配置，数据节点配置， 数据库配置。

1.2.2 dataHost配置

• dataHost

• heartbeat

• writeHost

• readHost

举例如下:

<dataHost name="localhost1" maxCon="1000" minCon="10" balance="2" switchType="1" slaveThreshold="100"  [tempReadHostAvailable=""]>
          <heartbeat errorRetryCount="3" timeout ="5" >select user()</heartbeat>
          <writeHost host="hostM1" url="192.168.2.177:3307" user="root" password="root" usingDecrypt=""/>
                   <readHost host="hosts1" url="192.168.2.177:3309" user="root" password="root" weight="" usingDecrypt=""/>
                    ...
         </writeHost>
        ...
</dataHost>

1.2.3 dataNode配置

• dataNode

例如：

<dataNode name="dn1" dataHost="localhost1" database="db1" />

name, datahost, database均可用如下格式在单个配置中配置多个节点： xxx$n0-n1, xxx, 这种格式的意义为：xxxn0，... , xxxnm， ... ,xxxn1, xxx, 其中

n0 < nm < n1。

例如： 配置

<dataNode name="dn1$0-19" dataHost="localhost1$0-9" database="db1$0-1" />

等同于:

<dataNode name="dn10" dataHost="localhost10" database="db10" />
<dataNode name="dn11" dataHost="localhost10" database="db11" />
<dataNode name="dn12" dataHost="localhost11" database="db10" />
<dataNode name="dn13" dataHost="localhost11" database="db11" />
   ...
<dataNode name="dn119" dataHost="localhost19" database="db11" />

注意：如果是使用通配符的配置，那么dataNode(name)的通配符展开个数必须等于dataHost通配符展开个数与database通配符展开个数之积,上例中,name的个数为20,dataHost的个数为10,database的个数为2; 又例如

<dataNode name="dn,dn1$0-19,dnx" dataHost="localhost,localhost1$0-9" database="db1$0-1" />

中,name的个数为22,dataHost的个数为11,database的个数为2。

注意：自版本2.19.07.0开始，若出现两个不同的dataNode拥有同样的database以及dataHost，在配置检查的时候会报错(包括从通配符批量生成的dataNode)

1.2.4 schema配置

• schema

• table

• childTable

举例：

<schema name="TESTDB" [sqlMaxLimit="100"]  [dataNode="dn1"]>
        <table name="payed" [cacheKey="id"] [autoIncrement="true"] [needAddLimit=“true”] [type="global"]  [rule="auto-sharding-long"] dataNode="dn1,dn2"/>
        ...
        <table name="customer" [cacheKey="id"] [incrementColumn="id"] [autoIncrement="true"] [needAddLimit="true"] [type="global"]  [rule="auto-sharding-long"] dataNode="dn1,dn2">
                <childTable name="orders"  [cacheKey="id"] [autoIncrement="true"] [needAddLimit="true"] joinKey="customer_id" parentKey="id">
                         <childTable ...>
                                     ...
                                                 <childTable .../>
                                                 ...
                                    ...
                        </childTable>
             </childTable>
                ...
        </table>
        ...
</schema>

1.2.5 注意事项

标签dataHost的属性dbDriver，dbTyp，writeType已废弃。
标签schema的属性checkSQLschema已废弃。
一个物理表不能配置给多个逻辑表使用，否则使用后结果不可知，比如#862。

1.2.6 举例

下面是一个schema.xml的完整例子:

<?xml version="1.0"?>
<!DOCTYPE dble:schema SYSTEM "schema.dtd">
<dble:schema xmlns:dble="http://dble.cloud/" version="9.9.9.9">

    <schema name="TESTDB">
        <!-- auto sharding by id (long) -->
        <table name="travelrecord" dataNode="dn1,dn2" rule="sharding-by-hash2"/>

        <!-- global table is auto cloned to all defined data nodes ,so can join
            with any table whose sharding node is in the same data node -->
        <table name="company" cacheKey="ID" type="global" dataNode="dn1,dn2,dn3,dn4"/>
        <table name="goods" cacheKey="ID" type="global" dataNode="dn1,dn2"/>
        <!-- random sharding using mod sharind rule -->
        <table name="hotnews" cacheKey="ID" autoIncrement="true" dataNode="dn1,dn2,dn3,dn4" rule="sharding-by-mod"/>
        <table name="customer" cacheKey="ID" dataNode="dn1,dn2" rule="sharding-by-mod">
            <childTable name="orders" cacheKey="ID" joinKey="customer_id" parentKey="id">
                <childTable name="order_items" joinKey="order_id" parentKey="id"/>
            </childTable>
            <childTable name="customer_addr" cacheKey="ID" joinKey="customer_id" parentKey="id"/>
        </table>
    </schema>
    <!-- <dataNode name="dn1$0-743" dataHost="localhost1" database="db$0-743"/> -->
    <dataNode name="dn1" dataHost="localhost1" database="db1"/>
    <dataNode name="dn2" dataHost="localhost1" database="db2"/>
    <dataNode name="dn3" dataHost="localhost1" database="db3"/>
    <dataNode name="dn4" dataHost="localhost1" database="db4"/>
    <dataHost name="localhost1" maxCon="1000" minCon="10" balance="0" switchType="1" slaveThreshold="100">
        <heartbeat>select user()</heartbeat>
        <!-- can have multi write hosts -->
        <writeHost host="hostM1" url="localhost:3306" user="root" password="123456">
            <!-- can have multi read hosts -->
            <readHost host="hostS2" url="192.168.1.200:3306" user="root" password="xxx"/>
        </writeHost>
        <writeHost host="hostS1" url="localhost:3316" user="root" password="123456"/>
        <!-- <writeHost host="hostM2" url="localhost:3316" user="root" password="123456"/> -->
    </dataHost>
</dble:schema>

1.2.7 MySQL用户权限说明