表格存储提供了JDBC驱动用于使用SQL访问表格存储数据。本文介绍如何使用JDBC直连访问表格存储。
注意事项
目前支持使用SQL查询功能的地域有华东1(杭州)、华东2(上海)、华北2(北京)、华北3(张家口)、华北5(呼和浩特)、华北6(乌兰察布)、华南1(深圳)、西南1(成都)、中国香港、新加坡、印度尼西亚(雅加达)、德国(法兰克福)、沙特(利雅得)和美国(弗吉尼亚)。
前提条件
如果要使用RAM用户进行操作,请确保已创建RAM用户,并为RAM用户授予所有SQL操作权限,即在自定义权限策略中配置
"Action": "ots:SQL*"
。具体操作,请参见通过RAM Policy为RAM用户授权。已获取AccessKey(包括AccessKey ID和AccessKey Secret)。具体操作,请参见创建AccessKey。
使用流程
步骤一:安装JDBC驱动
您可以通过以下两种方式安装JDBC驱动。
下载表格存储JDBC驱动并导入到项目中。具体下载路径请参见表格存储JDBC驱动。
在Maven项目中加入依赖项
在Maven工程中使用表格存储JDBC驱动,只需在pom.xml中加入相应依赖即可。以5.17.0版本为例,在<dependencies>内加入如下内容:
<dependency> <groupId>com.aliyun.openservices</groupId> <artifactId>tablestore-jdbc</artifactId> <version>5.17.0</version> </dependency>
步骤二:使用JDBC直连
使用
Class.forName()
加载表格存储JDBC驱动。表格存储JDBC驱动名称为
com.alicloud.openservices.tablestore.jdbc.OTSDriver
。Class.forName("com.alicloud.openservices.tablestore.jdbc.OTSDriver");
使用JDBC连接表格存储实例。
String url = "jdbc:ots:https://myinstance.cn-hangzhou.ots.aliyuncs.com/myinstance"; String user = "************************"; String password = "********************************"; Connection conn = DriverManager.getConnection(url, user, password);
参数说明请参见下表。
参数
示例
说明
url
jdbc:ots:https://myinstance.cn-hangzhou.ots.aliyuncs.com/myinstance
表格存储JDBC的URL。格式为
jdbc:ots:schema://[accessKeyId:accessKeySecret@]endpoint/instanceName[?param1=value1&...¶mN=valueN]
。主要字段说明如下:schema(必选):表格存储JDBC驱动使用的协议,一般设置为https。
accessKeyId:accessKeySecret(可选):阿里云账号或者RAM用户的AccessKey ID和AccessKey Secret。
endpoint(必选):实例的服务地址。更多信息,请参见服务地址。
instanceName(必选):实例名称。
其他常用配置项的说明,请参见配置项。
user
************************
阿里云账号或者RAM用户的AccessKey ID。
password
********************************
阿里云账号或者RAM用户的AccessKey Secret。
您可以通过URL或者Properties方式传递AccessKey和配置项,此处以通过公网访问华东1(杭州)地域下myinstance实例为例介绍。
通过URL传递AccessKey和配置项
DriverManager.getConnection("jdbc:ots:https://************************:********************************@myinstance.cn-hangzhou.ots.aliyuncs.com/myinstance?enableRequestCompression=true");
通过Properties传递AccessKey和配置项
Properties info = new Properties(); info.setProperty("user", "************************"); info.setProperty("password", "********************************"); info.setProperty("enableRequestCompression", "true"); DriverManager.getConnection("jdbc:ots:https://myinstance.cn-hangzhou.ots.aliyuncs.com/myinstance", info);
执行SQL语句。
您可以使用createStatement或者prepareStatement方法创建SQL语句。
说明当前支持的SQL语句请参见SQL支持功能说明。
使用createStatement创建SQL语句
// 设置SQL语句,此处以查询test_table表中id列和name列的数据为例介绍,请根据实际需要设置。 String sql = "SELECT id,name FROM test_table"; Statement stmt = conn.createStatement(); ResultSet resultSet = stmt.executeQuery(sql); while (resultSet.next()) { String id = resultSet.getString("id"); String name = resultSet.getString("name"); System.out.println(id); System.out.println(name); } resultSet.close(); stmt.close();
使用prepareStatement创建SQL语句
// 设置SQL语句,此处以查询test_table表中pk为指定值的数据为例介绍,请根据实际需要设置。 String sql = "SELECT * FROM test_table WHERE pk = ?"; PreparedStatement stmt = connection.prepareStatement(sql); stmt.setLong(1, 1); ResultSet resultSet = stmt.executeQuery(); ResultSetMetaData metaData = resultSet.getMetaData(); while (resultSet.next()) { int columnCount = metaData.getColumnCount(); for (int i=0; i< columnCount;i++) { String columnName = metaData.getColumnName(i+1); String columnValue = resultSet.getString(columnName); System.out.println(columnName); System.out.println(columnValue); } } resultSet.close(); stmt.close();
完整示例
以下示例用于查询华东1(杭州)地域下myinstance实例中test_table的所有数据。
public class Demo {
public static void main(String[] args) throws SQLException, ClassNotFoundException {
Class.forName("com.alicloud.openservices.tablestore.jdbc.OTSDriver");
String url = "jdbc:ots:https://myinstance.cn-hangzhou.ots.aliyuncs.com/myinstance";
String user = "************************";
String password = "********************************";
Connection conn = DriverManager.getConnection(url, user, password);
String sql = "SELECT * FROM test_table";
Statement stmt = conn.createStatement();
ResultSet resultSet = stmt.executeQuery(sql);
ResultSetMetaData metaData = resultSet.getMetaData();
while (resultSet.next()) {
int columnCount = metaData.getColumnCount();
for (int i=0; i< columnCount;i++) {
String columnName = metaData.getColumnName(i+1);
String columnValue = resultSet.getString(columnName);
System.out.println(columnName);
System.out.println(columnValue);
}
}
resultSet.close();
stmt.close();
conn.close(); // 请务必关闭连接,否则程序无法退出。
}
}
配置项
表格存储JDBC驱动基于表格存储的Java SDK实现,通过JDBC您可以修改Java SDK的配置项。常用配置项的详细说明请参见下表。
耗时超过30秒的SQL请求会收到服务器的超时错误信息,如果希望设置更小的超时时间,请将syncClientWaitFutureTimeoutInMillis设置为小于30000毫秒的值。如果希望对每一个Statement设置单独的超时时间,请使用setQueryTimeout方法。
配置项 | 示例值 | 说明 |
enableRequestCompression | false | 是否压缩请求数据。取值范围如下:
|
enableResponseCompression | false | 是否压缩响应数据。取值范围如下:
|
ioThreadCount | 2 | HttpAsyncClient的IOReactor的线程数,默认与CPU核数相同。 |
maxConnections | 300 | 允许打开的最大HTTP连接数。 |
socketTimeoutInMillisecond | 30000 | Socket层传输数据的超时时间。单位为毫秒。0表示无限等待。 |
connectionTimeoutInMillisecond | 30000 | 建立连接的超时时间。单位为毫秒。0表示无限等待。 |
retryThreadCount | 1 | 用于执行错误重试的线程池中线程个数。 |
syncClientWaitFutureTimeoutInMillis | -1 | 异步等待的超时时间。单位为毫秒。 |
connectionRequestTimeoutInMillisecond | 60000 | 发送请求的超时时间。单位为毫秒。 |
retryStrategy | default | 重试策略,取值范围如下:
|
retryTimeout | 10 | 重试超时时间和时间单位。时间单位的取值范围如下:
|
retryTimeoutUnit | seconds |
数据类型转换
表格存储支持Integer(整型)、Double(浮点数)、String(字符串)、Binary(二进制)和Boolean(布尔值)五种数据类型。通过Java SDK使用JDBC直连表格存储时,JDBC驱动能够对Java类型和表格存储数据类型进行自动转换。
Java类型转换为表格存储数据类型
当使用PreparedStatement方法为SQL语句中的参数赋值时,Java中Byte、Short、Int、Long、BigDecimal、Float、Double、String、CharacterStream、Bytes、Boolean类型均能传递给表格存储SQL引擎。
PreparedStatement stmt = connection.prepareStatement("SELECT * FROM t WHERE pk = ?");
stmt.setLong(1, 1); // 支持的类型转换。
stmt.setURL(1, new URL("https://aliyun.com/")); // 不支持的类型转换,系统会抛出异常。
表格存储数据类型转换为Java类型
当使用ResultSet方法获取SQL返回结果时,表格存储数据类型自动转换为Java数据类型的注意事项请参见下表。
表格存储数据类型 | 转换原则说明 |
Integer |
|
Double | |
String |
|
Binary | |
Boolean |
|
Statement stmt = conn.createStatement();
ResultSet resultSet = stmt.executeQuery("SELECT count(*) FROM t");
while (resultSet.next()) {
resultSet.getLong(1); // 支持的类型转换。
resultSet.getCharacterStream(1); // 不支持的类型转换,系统会抛出异常。
}
表格存储数据类型和Java类型转换的支持情况请参见下表。
“✓”表示正常转换,“~”表示可能抛出异常,“×”表示无法转换。
类型转换 | Integer | Double | String | Binary | Boolean |
Byte | ~ | ~ | ~ | ~ | ✓ |
Short | ~ | ~ | ~ | ~ | ✓ |
Int | ~ | ~ | ~ | ~ | ✓ |
Long | ✓ | ~ | ~ | ~ | ✓ |
BigDecimal | ✓ | ✓ | ~ | ~ | ✓ |
Float | ✓ | ✓ | ~ | ~ | ✓ |
Double | ✓ | ✓ | ~ | ~ | ✓ |
String | ✓ | ✓ | ✓ | ✓ | ✓ |
CharacterStream | × | × | ✓ | ✓ | × |
Bytes | ✓ | ✓ | ✓ | ✓ | ✓ |
Boolean | ✓ | ✓ | ✓ | ✓ | ✓ |
相关文档
您还可以通过Hibernate、MyBatis等方式使用JDBC访问表格存储。具体操作,请参见通过Hibernate使用SQL查询数据和通过MyBatis使用SQL查询数据。
您还可以通过控制台、命令行工具、表格存储SDK、Go语言驱动等方式访问表格存储。具体操作,请参见通过控制台使用SQL查询、通过命令行工具使用SQL查询、通过SDK使用SQL查询、通过Go语言驱动使用SQL查询。
您还可以将Tablestore实例接入到DataWorks或DMS,然后使用SQL查询与分析Tablestore数据。更多信息,请参见接入到DataWorks和接入到DMS。
您还可以通过MaxCompute、Spark、Hive或者HadoopMR、函数计算、Flink、PrestoDB等计算引擎实现表中数据的计算与分析。具体操作,请参见计算与分析。
如果要以图表等形式可视化展示数据,您可以通过对接Grafana实现。更多信息,请参见对接Grafana。