JDBC

最近更新时间:2025-12-04 12:05:51

我的收藏

适用场景

适用于企业业务系统通过 JDBC 方式获取指标计算结果的场景。例如在 CRM 看板中,需展示近30天各个销售小组的销售业绩和柱状图,则可通过 JDBC 协议,获取指标计算结果,入参指定指标为“近30天销售业绩”,维度为“销售小组”,即可获取各个销售小组近30天销售业绩数据,用以 CRM 看板中数据展示。
通过标准的 MySQL 客户端,您可以使用 SemQL 语法查询指标元数据和计算结果。WeData Metric MySQL Server 专为腾讯 WeData 平台的指标查询而设计,提供 MySQL 协议服务,响应 MySQL 客户端连接。

核心特性

MySQL 协议兼容:支持标准 MySQL 客户端连接
SemQL 语法支持:完全支持 WeData SemQL 查询语法
身份认证:使用“WeData-数据服务-我的应用”AKSK 进行身份验证
实时查询:直接查询 WeData 平台的最新数据

主机配置

域名:wedata-semantics.cloud.tencent.com
端口:9030

连接配置

参数
说明
示例
主机(必填)
服务器域名,参考 主机配置 服务器信息
wedata-semantics.cloud.tencent.com
端口(必填)
MySQL 服务端口,固定为9030
9030
用户名(必填)
用户名格式为:
应用密钥 ApiAppKey@${地域},其中 ApiAppKey 在数据服务-我的应用列表中获取,${地域}为指标所在项目对应的地域,在项目详情中获取
APIDf21*****D5LtJ


如上,则用户名为:
APIDf21*****D5LtJ@ap-guangzhou
密码(必填)
应用密钥 ApiAppSecret,在数据服务-我的应用中获取
${ApiAppSecret}

数据库(必填)
指标所在项目标记,在项目详情中获取


连接方式

mysql -h {主机} -P {端口} -u {用户名} -D {数据库} -p

实践教程

访问示例:
mysql -h wedata-semantics.cloud.tencent.com -P 9030 -uAPIDf21*****D5LtJ@ap-guangzhou -Dmetric_std -p

说明:
wedata-semantics.cloud.tencent.com 为服务域名。
9030为固定的服务端口。
APIDf21*****D5LtJ@ap-guangzhou:@符号前为数据服务 > 我的应用列表中的 ApiAppKey,@符号后为指标所在项目对应的地域,其中“地域”可选值请参见 地域列表。(详情请参见上文 连接配置 中的用户名/密码)
metric_std 指标所在项目的标志。

限制与注意事项

功能限制

可支持驱动版本:建议 ≥ 5.1

性能建议

单服务:单用户并发连接数不超过100。

故障排除

认证失败

报错信息:ERROR 1045 (28000): Access denied for user 'AKIDa*********lIj072' (using password: YES)
解决方案:检查应用密钥是否填写正确。

连接失败

报错信息:ERROR 2013 (HY000): Lost connection to MySQL server at 'reading initial communication packet', system error: 0
解决方案:网络连接异常,可 提交工单联系 WeData 团队协助处理。

技术支持

如遇到问题,请提供以下信息:
1. 客户端信息:客户端及其版本信息
2. 连接设置:完整的 MySQL 连接命令(隐藏敏感信息)
3. 错误信息:完整的错误消息
4. 查询语句:出现问题的 SQL 语句
5. 预期结果:期望得到的结果