#YashanDB JDBC简介与能力概览
Java数据库连接(JDBC,Java Database Connectivity)是Java语言访问关系型数据库的标准应用程序接口(API,Application Programming Interface)。JDBC为Java应用程序提供统一的数据库访问方式,应用程序通过数据库厂商提供的JDBC驱动连接并操作数据库。
# YashanDB JDBC驱动简介
YashanDB JDBC驱动实现了JDBC标准中的常用接口。Java应用程序可以使用标准JDBC和SQL连接并操作YashanDB。
YashanDB JDBC驱动主要提供以下接口:
| 接口 | 说明 |
|---|---|
| Connection | 表示JDBC客户端与数据库之间的连接。 |
| DatabaseMetaData | 获取数据库的综合信息。 |
| Statement | 向数据库发送SQL语句并获取执行结果。 |
| PreparedStatement | 执行预编译SQL语句。 |
| ParameterMetaData | 获取PreparedStatement中绑定参数的类型和属性信息。 |
| CallableStatement | 调用PL对象。 |
| ResultSet | 表示SQL查询返回的结果集。 |
| ResultSetMetaData | 获取结果集中列的类型和属性信息。 |
| Driver | 提供JDBC驱动接口。 |
| DataSource、PooledConnection和ConnectionPoolDataSource | 提供数据源、池化连接和连接池数据源。 |
| Blob、Clob和NClob | 操作大对象数据。 |
| Array、Struct、SQLData、SQLInput和SQLOutput | 访问和映射用户自定义类型(UDT,User-Defined Type)数据。 |
| XADataSource、XAConnection、XAResource和Xid | 建立和管理XA分布式事务。 |
| YasConnection、YasDebugCallableStatement、DebugBreakpoint、DebugFrame和DebugVar | 提供Debug扩展接口,用于调试存储过程,包括创建调试会话、管理断点以及查看调用栈和变量。 |
各接口及方法的具体支持情况请参考JDBC接口支持汇总。
# 主要功能
YashanDB JDBC驱动提供以下主要功能:
- 支持Java数据类型与YashanDB数据类型之间的转换。具体映射关系请参考JDBC数据类型映射关系。
- 在高可用主备部署中自动识别并连接主库。
- 在共享集群、分布式集群和存算一体分布式集群部署中自动识别并连接负载较小的节点。
- 提供连接超时、Socket超时和SQL执行超时等超时机制。
- 提供透明应用程序故障转移(TAF,Transparent Application Failover)功能。当前连接节点发生故障后,客户端可以重新连接到已配置的其他节点。具体配置请参考配置TAF。
YashanDB产品安装包中配套提供JDBC驱动JAR文件。驱动安装方法请参考安装JDBC驱动。完成安装后,可以参考快速入门连接并操作YashanDB。

