MaxCompute JDBC 2.0 beta中的一些变更说明

注：MaxCompute原名ODPS，是阿里云自研的大数据计算平台，文中出现的MaxCompute与ODPS都指代同一平台，不做区分

MaxCompute JDBC 2.0 beta 出于易用性的考虑，对配置相关的部分进行了一些变更，大致如下：

• 添加了对日志配置的支持

新增了配置参数 log_conf_file 用一指定一个本地的配置文件来对日志功能进行定义。该日志功能利用了Java日志框架logback，所以指定的配置文件必须是一个与logback相兼容的配置文件。具体的配置方式见《手把手教你完成ODPS JDBC自定义日志配置》

• 同化了URL及PROP参数名

之前JDBC的配置参数可以通过URL参数的方式传递，也可以在编程时通过Property的方式传递，且两种方式的参数Key是不同的，如下所示：

URL keyProperty KeyDescriptionendpointend_pointthe endpoint of the ODPS clusterprojectproject_namethe current ODPS projectaccessIdaccess_idthe id to access the ODPS serviceaccessKeyaccess_keythe authentication keylogviewlogview_hostthe host domain of the log view appeared in the log historylifecyclelifecyclethe lifecycle of the temp table using in querycharsetcharsetthe charset of the stringloglevellog_levelthe level of debug infomartion debug/info/fatal

为了便于记忆和使用，目前变更为在这两种方式中，以上两种Key将通用不作区分，且在两种Key同时存在的情况下，优先使用Property Key的入参。同时，如果在URL和Property中都传入同一参数（不区分Key的形式），将优先使用以Property方式传入的参数

• 支持在JDBC URL中传入配置文件

之前在JDBC的URL串中传入参数时，存在一个麻烦的地方，即个别参数可能存在特殊字符。例如，有个别的access_key的末尾是以=结束的，这对URL参数的解析造成了干扰，唯一能做的就是需要用户提前对这些参数的值进行url encoding.

为了避免这种情况发生，目前支持在URL串上直接传入配置文件，如下：

jdbc:odps:http://10.101.xx.xx/api?odps_config=/Users/emerson/odps_config.ini

我们支持在URL上传入 odps_config 作为指定本地配置文件路径的参数。其中odps_config.ini的内容如下，就是简单的键值对：

 project_name=odps_dev access_id=63wd3dpztlmb5ocdkj94pxmm access_key=xxxxxxxxx= log_conf_file=/Users/emerson/logback.xml ...

这些参数的Key与之前URL或Property的方式一致，且含有特殊字符的值也无须转义。

这里需要注意的是， odps_config 参数只支持以URL参数的方式传入，不支持Property的方式传入。一旦传递了该配置文件，将忽略所有通过URL或Property传入的参数。

另一点需要注意的是即使你在配置文件中指定了end_point，MaxCompute JDBC仍将使用JDBC URL串中的地址作为end_point，即http://10.101.xx.xx/api。

欢迎加入MaxCompute钉钉群讨论

原文链接：

http://click.aliyun.com/m/14027/