小小狠招:巧妙使用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

相关文章

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

C#中Guid类使用小结

《C#中Guid类使用小结》本文主要介绍了C#中Guid类用于生成和操作128位的唯一标识符,用于数据库主键及分布式系统,支持通过NewGuid、Parse等方法生成,感兴趣的可以了解一下... 目录前言一、什么是 Guid二、生成 Guid1. 使用 Guid.NewGuid() 方法2. 从字符串创建

Python使用python-can实现合并BLF文件

《Python使用python-can实现合并BLF文件》python-can库是Python生态中专注于CAN总线通信与数据处理的强大工具,本文将使用python-can为BLF文件合并提供高效灵活... 目录一、python-can 库:CAN 数据处理的利器二、BLF 文件合并核心代码解析1. 基础合

Python使用OpenCV实现获取视频时长的小工具

《Python使用OpenCV实现获取视频时长的小工具》在处理视频数据时,获取视频的时长是一项常见且基础的需求,本文将详细介绍如何使用Python和OpenCV获取视频时长,并对每一行代码进行深入解析... 目录一、代码实现二、代码解析1. 导入 OpenCV 库2. 定义获取视频时长的函数3. 打开视频文

Spring IoC 容器的使用详解(最新整理)

《SpringIoC容器的使用详解(最新整理)》文章介绍了Spring框架中的应用分层思想与IoC容器原理,通过分层解耦业务逻辑、数据访问等模块,IoC容器利用@Component注解管理Bean... 目录1. 应用分层2. IoC 的介绍3. IoC 容器的使用3.1. bean 的存储3.2. 方法注

Python内置函数之classmethod函数使用详解

《Python内置函数之classmethod函数使用详解》:本文主要介绍Python内置函数之classmethod函数使用方式,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地... 目录1. 类方法定义与基本语法2. 类方法 vs 实例方法 vs 静态方法3. 核心特性与用法(1编程客

Linux中压缩、网络传输与系统监控工具的使用完整指南

《Linux中压缩、网络传输与系统监控工具的使用完整指南》在Linux系统管理中,压缩与传输工具是数据备份和远程协作的桥梁,而系统监控工具则是保障服务器稳定运行的眼睛,下面小编就来和大家详细介绍一下它... 目录引言一、压缩与解压:数据存储与传输的优化核心1. zip/unzip:通用压缩格式的便捷操作2.

使用Python实现可恢复式多线程下载器

《使用Python实现可恢复式多线程下载器》在数字时代,大文件下载已成为日常操作,本文将手把手教你用Python打造专业级下载器,实现断点续传,多线程加速,速度限制等功能,感兴趣的小伙伴可以了解下... 目录一、智能续传:从崩溃边缘抢救进度二、多线程加速:榨干网络带宽三、速度控制:做网络的好邻居四、终端交互

Python中注释使用方法举例详解

《Python中注释使用方法举例详解》在Python编程语言中注释是必不可少的一部分,它有助于提高代码的可读性和维护性,:本文主要介绍Python中注释使用方法的相关资料,需要的朋友可以参考下... 目录一、前言二、什么是注释?示例:三、单行注释语法:以 China编程# 开头,后面的内容为注释内容示例:示例:四