小小狠招:巧妙使用HANA数据库的jdbc driver

2024-03-31 13:36

本文主要是介绍小小狠招:巧妙使用HANA数据库的jdbc driver,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

SAP旗下的HANA数据库,实际上是分为两个系列进行发布,一种是基于本地部署的称之为HANA Platform。另一种是面向Cloud平台的,称之为HANA Cloud。

在实际使用当用,因为两者基本上共用同一代码库,除个别地方略有差异以外,我们可以共用它们的JDBC driver。

本文就简要介绍一下这个driver的几个非常有用的小技巧,你会感觉到,普普通通的jdbc驱动,也能做很多事情。

实例

获取hana cloud jdbc driver:

我们从:https://mvnrepository.com/artifact/com.sap.cloud.db.jdbc/ngdbc可以得到较新版本的hana JDBC。

也能看到包的定义:

<!-- https://mvnrepository.com/artifact/com.sap.cloud.db.jdbc/ngdbc -->
<dependency><groupId>com.sap.cloud.db.jdbc</groupId><artifactId>ngdbc</artifactId><version>2.20.11</version><type>pom</type>
</dependency>

顺着里边的说明,也可以看到:对应的帮助文档:

https://help.sap.com/docs/SAP_HANA_CLIENT/f1b440ded6144a54ada97ff95dac7adf/434e2962074540e18c802fd478de86d6.html

我们使用单个命令行,就可以下载得到该文件:

mvn dependency:get -DgroupId=com.sap.cloud.db.jdbc -DartifactId=ngdbc -Dversion=2.20.11 -Dtransitive=false
mvn dependency:copy -Dartifact=com.sap.cloud.db.jdbc:ngdbc:2.20.11 -DoutputDirectory=./

第一个命令会下载驱动到你的repository的相关子目录当中。第二个命令会将对应的文件重新复制到你指定的目录:-DoutputDirectory=./  最终会得到文件: ngdbc-2.20.11.jar

当然,你也可以直接从SAP官网上下载相应的完整的client包,它里边也包含有完整的JDBC驱动。

当作命令行连接HANA

java -jar ngdbc-2.20.11.jar -u SYSTEM,<password> -n <ip_address>:30215 -c "SELECT DATABASE_NAME,version FROM SYS.M_DATABASES" -w 50
| DATABASE_NAME                                      | VERSION                          |
-----------------------------------------------------------------------------------------
| HDB                                                | 2.00.070.00.1679989823           |
1 rows.
实例2: 查询数据库服务器上所有安装版本历史:
java -jar ngdbc-2.20.11.jar -u SYSTEM,<password> -n <ip_address>:30215 -c "SELECT * FROM SYS.M_DATABASE_HISTORY"| INSTALL_TIME                | VERSION                          |
------------------------------------------------------------------
| 2017-01-17 09:38:19.0000000 | 1.00.112.04.1467296086           |
| 2017-04-19 09:20:18.0000000 | 2.00.002.00.1490188421           |
| 2017-06-12 09:19:44.0000000 | 2.00.011.00.1493936640           |
| 2017-07-07 10:34:05.0000000 | 2.00.012.00.1498457145           |
| 2018-07-16 09:40:12.0000000 | 2.00.031.00.1528768600           |
| 2018-09-24 05:50:11.0000000 | 2.00.032.00.1533114046           |
| 2019-02-05 04:43:35.0000000 | 2.00.036.00.1547699771           |
| 2019-09-20 03:32:26.0000000 | 2.00.042.00.1564994110           |
| 2020-02-13 12:02:42.0000000 | 2.00.044.00.1571081837           |
| 2020-05-06 14:04:11.0000000 | 2.00.047.00.1586595995           |
| 2020-10-06 06:01:18.0000000 | 2.00.052.00.1599235305           |
| 2021-01-18 06:15:01.0000000 | 2.00.053.00.1605092543           |
| 2021-02-05 09:46:59.0000000 | 2.00.054.00.1611906357           |
| 2021-05-19 10:25:57.0000000 | 2.00.055.00.1615413201           |
| 2021-09-10 02:38:40.0000000 | 2.00.057.00.1629894416           |
| 2021-10-18 10:39:57.0000000 | 2.00.058.00.1634122452           |
| 2021-11-22 03:29:50.0000000 | 2.00.059.00.1636704142           |
| 2022-02-16 11:20:29.0000000 | 2.00.061.00.1644229038           |
| 2022-05-24 06:05:26.0000000 | 2.00.062.00.1650891137           |
| 2022-10-12 03:49:19.0000000 | 2.00.064.00.1660047502           |
| 2022-11-23 04:35:13.0000000 | 2.00.065.00.1665753120           |
| 2023-01-27 05:55:29.0000000 | 2.00.066.00.1671096120           |
| 2023-05-18 06:08:25.0000000 | 2.00.070.00.1679989823           |

你只要在 -c 后边传入相应的命令行即可。有意思吧。这也算是一个简单的命令行客户端了。

最简单的,你可以直接针对jar不带任何参数,它会输出当前的时间戳(来自服务器的时间)。

java -jar ngdbc-2.20.11.jar -u SYSTEM,<password> -n <ip_address>:30215
| CURRENT_TIMESTAMP           |
-------------------------------
| 2024-03-28 21:08:48.0890000 |

完整的命令行格式是这样的:

java -jar ngdbc.jar -u <user,password>[-n <hostname:port>][-i <instance-number>][-d <database-name>][-o <connect-option>][-w <maximum-column-width>[-c <sql-command>]

一些重要的开关

其实,这里主要是强调:JDBC Tracing and Trace Options的用法。在你实际开发应用过程当中,添加适当的开关,能帮你快速定位问题。

1、直接在jdbc连接串中设置
jdbc:sap://localhost:30015/?autocommit=false&traceFile=traceFile.txt&traceOptions=CONNECTIONS,API,PACKET,TIMESTAMPS,ELAPSEDTIMES,FAILURE_ACTION_STDERR

这里就设置了很多跟踪选项:CONNECTIONS,API,PACKET,TIMESTAMPS,ELAPSEDTIMES,FAILURE_ACTION_STDERR

2、在命令行里头直接设置
  • 获取当前配置项

java -jar ngdbc-2.20.11.jar SHOWDriver version                               : 2.20.11-354e45de0dcbabd02f58c506ecf1138161ee4b1eSettings file name                           : ~/.sdb/jdbctracesettings.iniShared memory file name                      : ~/.sdb/jdbctrace.shmConfigurationTrace                                        : DisabledTrace file name                              : jdbctrace.prtTRACE CONNECTIONS                            : OnTRACE API                                    : OnTRACE PACKET                                 : OnTRACE DISTRIBUTION                           : OffTRACE STATISTICS                             : OffTRACE CLEANERS                               : OnTRACE DEBUG                                  : OffShow plain-text client-side encrypted values : DisabledShow timestamps                              : DisabledShow elapsed times                           : DisabledTrace file size                              : UnlimitedStop on error                                : DisabledTrace failure action                         : IgnorePerformance trace                            : DisabledPerformance trace file name                  : jdbcperformancetrace.prt
  • 直接设置选项举例

java -jar ngdbc-2.20.11.jar TRACE ON
//Driver version                               : 2.20.11-354e45de0dcbabd02f58c506ecf1138161ee4b1eSettings file name                           : /Users/i062873/.sdb/jdbctracesettings.iniShared memory file name                      : /Users/i062873/.sdb/jdbctrace.shmConfigurationTrace                                        : EnabledTrace file name                              : jdbctrace.prtTRACE CONNECTIONS                            : OnTRACE API                                    : OnTRACE PACKET                                 : OnTRACE DISTRIBUTION                           : OffTRACE STATISTICS                             : OffTRACE CLEANERS                               : OnTRACE DEBUG                                  : OffShow plain-text client-side encrypted values : DisabledShow timestamps                              : DisabledShow elapsed times                           : DisabledTrace file size                              : UnlimitedStop on error                                : DisabledTrace failure action                         : IgnorePerformance trace                            : DisabledPerformance trace file name                  : jdbcperformancetrace.prt

这样我样可以在相同路径下边的jdbctrace*.prt文件里头得到trace的内容:

    <Part PartKind=ResultSetID(13) PartAttributes=0(none) ArgumentCount=1 BigArgumentCount=0 BufferLength=8 BufferSize=29816><PartBuffer>0 | b5 97 c0 10 65 72 05 00                         | ....er..         |</PartBuffer></Part><Part PartKind=StatementContext(39) PartAttributes=0(none) ArgumentCount=4 BigArgumentCount=0 BufferLength=206 BufferSize=29792><PartBuffer>0 | 01 21 ac 00 01 00 00 00 00 00 00 00 68 17 c6 05 | .!..........h... |10 | 00 00 00 00 e2 46 b2 42 00 00 00 00 bc e5 53 3d | .....F.B......S= |20 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................ |30 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................ |40 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................ |50 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................ |60 | 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................ |70 | 00 00 00 00 00 00 00 00 00 00 00 00 00 15 13 02 | ................ |80 | e2 7f 00 00 00 00 00 00 00 00 00 00 00 00 00 00 | ................ |90 | 00 00 40 b0 01 00 00 00 00 00 00 00 00 00 00 00 | ..@............. |a0 | 00 00 00 00 76 80 34 5c 08 d7 24 00 9d 0a 96 ad | ....v.4\..$..... |b0 | 02 04 03 03 00 00 00 00 00 00 07 04 bd 01 00 00 | ................ |c0 | 00 00 00 00 08 04 20 bb 00 00 00 00 00 00       | ...... .......   |
.....

这些TRACE的内容非常有用。尤其是在遇到你认为是BUG的时候,可以将这些TRACE文件作为佐证,提供给SAP官方,便于他们去修复问题。

由于这是一个基于操作系统用户级的设置。当你设置完使用完之后,可以再将其恢复到原来的状态:

java -jar ngdbc-2.20.11.jar TRACE OFF
3、启动图形方式进行设置

既然有命令行方式,那同时也就有了GUI方式。我们用-g选项就可以启动。

java -jar ngdbc-2.20.11.jar -g

图片

image-20240329072459665

所有可以配置的参数项,一目了然。

1)有enable tracing的,下边可以指定trace文件,trace级别,以及时间戳大小,是否明文显示。

2)是否启用关于性能的tracing,这个对于测量性能指标也非常重要。

总结

一个小小的jdbc驱动,HANA数据库为它提供的功能还是比较强悍的。在关键的时候,能起到非常大的作用。如果只是一些非常简单的连接性需求,甚至不需要任何第三方工具,直接使用简单的命令行就可以顺利完成。

这篇关于小小狠招:巧妙使用HANA数据库的jdbc driver的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/864465

相关文章

Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式

《Java通过驱动包(jar包)连接MySQL数据库的步骤总结及验证方式》本文详细介绍如何使用Java通过JDBC连接MySQL数据库,包括下载驱动、配置Eclipse环境、检测数据库连接等关键步骤,... 目录一、下载驱动包二、放jar包三、检测数据库连接JavaJava 如何使用 JDBC 连接 mys

SpringBoot线程池配置使用示例详解

《SpringBoot线程池配置使用示例详解》SpringBoot集成@Async注解,支持线程池参数配置(核心数、队列容量、拒绝策略等)及生命周期管理,结合监控与任务装饰器,提升异步处理效率与系统... 目录一、核心特性二、添加依赖三、参数详解四、配置线程池五、应用实践代码说明拒绝策略(Rejected

C++ Log4cpp跨平台日志库的使用小结

《C++Log4cpp跨平台日志库的使用小结》Log4cpp是c++类库,本文详细介绍了C++日志库log4cpp的使用方法,及设置日志输出格式和优先级,具有一定的参考价值,感兴趣的可以了解一下... 目录一、介绍1. log4cpp的日志方式2.设置日志输出的格式3. 设置日志的输出优先级二、Window

Ubuntu如何分配​​未使用的空间

《Ubuntu如何分配​​未使用的空间》Ubuntu磁盘空间不足,实际未分配空间8.2G因LVM卷组名称格式差异(双破折号误写)导致无法扩展,确认正确卷组名后,使用lvextend和resize2fs... 目录1:原因2:操作3:报错5:解决问题:确认卷组名称​6:再次操作7:验证扩展是否成功8:问题已解

Qt使用QSqlDatabase连接MySQL实现增删改查功能

《Qt使用QSqlDatabase连接MySQL实现增删改查功能》这篇文章主要为大家详细介绍了Qt如何使用QSqlDatabase连接MySQL实现增删改查功能,文中的示例代码讲解详细,感兴趣的小伙伴... 目录一、创建数据表二、连接mysql数据库三、封装成一个完整的轻量级 ORM 风格类3.1 表结构

使用Docker构建Python Flask程序的详细教程

《使用Docker构建PythonFlask程序的详细教程》在当今的软件开发领域,容器化技术正变得越来越流行,而Docker无疑是其中的佼佼者,本文我们就来聊聊如何使用Docker构建一个简单的Py... 目录引言一、准备工作二、创建 Flask 应用程序三、创建 dockerfile四、构建 Docker

Python使用vllm处理多模态数据的预处理技巧

《Python使用vllm处理多模态数据的预处理技巧》本文深入探讨了在Python环境下使用vLLM处理多模态数据的预处理技巧,我们将从基础概念出发,详细讲解文本、图像、音频等多模态数据的预处理方法,... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

Python使用pip工具实现包自动更新的多种方法

《Python使用pip工具实现包自动更新的多种方法》本文深入探讨了使用Python的pip工具实现包自动更新的各种方法和技术,我们将从基础概念开始,逐步介绍手动更新方法、自动化脚本编写、结合CI/C... 目录1. 背景介绍1.1 目的和范围1.2 预期读者1.3 文档结构概述1.4 术语表1.4.1 核

Conda与Python venv虚拟环境的区别与使用方法详解

《Conda与Pythonvenv虚拟环境的区别与使用方法详解》随着Python社区的成长,虚拟环境的概念和技术也在不断发展,:本文主要介绍Conda与Pythonvenv虚拟环境的区别与使用... 目录前言一、Conda 与 python venv 的核心区别1. Conda 的特点2. Python v

Spring Boot中WebSocket常用使用方法详解

《SpringBoot中WebSocket常用使用方法详解》本文从WebSocket的基础概念出发,详细介绍了SpringBoot集成WebSocket的步骤,并重点讲解了常用的使用方法,包括简单消... 目录一、WebSocket基础概念1.1 什么是WebSocket1.2 WebSocket与HTTP