想咨询下autoPk的作用

[weihebu]

1.从文档中可以看到autoPk的相关描述，但还是不清楚这个参数的作用。有没有相关的配置demo，用来展示这个参数的实际作用的？
2.还想咨询下splitPk支持的数据库类型是哪些？

[wgzhao]

autoPk 的引入，是通过程序自动猜测可用于表拆分的字段，他首先会获取指定表中具有主键、单字段唯一索引索引的字段，如果有多个字段符合要求，则优先使用数字类型的字段，其次使用字符类型的字段。
其配置很简单，只需要在 任务配置文件中增加如下配置即可：

{
  "job": {
    "setting": {
      "speed": {
        "channel": 3,
        "bytes": -1
      }
    },
    "content": {
      "reader": {
        "name": "mysqlreader",
        "parameter": {
          "username": "root",
          "password": "root",
          "autoPk":"true",
          "column": [
            "*"
          ],
          "connection": {
            "table": [
              "addax_reader"
            ],
            "jdbcUrl": "jdbc:mysql://127.0.0.1:3306/test",
            "driver": "com.mysql.jdbc.Driver"
          }
        }
      },
      "writer": {
        "name": "streamwriter",
        "parameter": {
          "print": true
        }
      }
    }
  }
}

配置运行时，会有如下类似日志打印:

2025-04-13 23:17:11.036 [       job-0] INFO  CommonRdbmsReader$Job - The split key is not configured, try to guess the split key.
2025-04-13 23:17:11.059 [       job-0] INFO  CommonRdbmsReader$Job - Take the field id as split key

目前 autoPk 支持的数据库有：

• ClickHouse
• MySQL
• Oracle
• PostgreSQL
• SQL Server

这些在文档中有所体现

[weihebu]

也就是说设置了autoPk就不需要设置splitPk了是吧， "autoPk":"true" 相当于 "splitPk":"vou_id"?假设那张表的主键为vou_id的情况下。
autoPk文档中确实说明了，splitPk并没有详细指出，是否跟autoPk支持的一致？

[wgzhao]

是的，如果设置了 autoPk，可以不设置 splitPk。如果一张表 vou_id 是主键，那设置 autoPk 也会选择出 vou_id 作为切分字段，如果有更好的选择则例外。
如果两者同时设置了，则程序直接取 splitPk 的值，而忽略 autoPk 配置。

[weihebu]

关于splitPk支持的数据库类型以及支持的具体类型，我之所以问的这么细，是因为datax那边的文档是有细微区别的。
对于oracle而言，支持整形、字符串型数据切分。mysql、postgresql、ClickHouse、SQL Server仅支持整形数据切分。
我不知道addax是不是有所不同，所以才详细问问。
datax文档如下：
https://github.com/alibaba/DataX/blob/master/postgresqlreader/doc/postgresqlreader.md
https://github.com/alibaba/DataX/blob/master/oraclereader/doc/oraclereader.md

[wgzhao]

是的，splitPk 的配置支持做了一些改进，增加了多类型的支持