使用JayDebeApi连接数据库

准备好基本的 GaussDB 开发环境，获取数据库连接参数，例如：

gsql -h ***.***.***.*** -p 20000 -U *** -W ****** -d test

参数说明：

-h：GaussDB服务器IP。

-p：GaussDB连接端口。

-U：连接用户名。

-W：用户密码。

-d：连接的DATABASE名。

1. 在计算机上安装Java JDK 8版本以及Python3版本，可以通过如下命令确认版本：

   java -version
   python --version
   pip --version

2. 如果服务器能连接到Python源（Python的软件包索引PyPI），可以通过pip命令安装JayDeBeApi：

   pip install jaydebeapi

   如果不能，可以通过下载离线安装包然后进行本地安装的方式安装JayDeBeApi。

根据不同版本的实例，下载不同版本的发布包，如表1所示。

为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下：

1. 上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。
2. 执行如下命令，校验软件包完整性。

   cat GaussDB_driver.zip.sha256 | sha256sum --check

   如果回显OK，则校验通过。

   GaussDB_driver.zip: OK

• 新建一个test_jaydebeapi.py文件，写入代码如下：

  #!/usr/bin/env python3.x
  # -*- coding: UTF-8 -*-
  encoding = "utf8"
  import jaydebeapi
  
  def test_jaydebeapi():
      #需要配置的参数
      url = 'jdbc:opengauss://***.***.***.***:20000/test'
      user = '***'
      password = '******'
      driver = 'com.huawei.opengauss.jdbc.Driver'
      jarFile = './opengaussjdbc.jar'
  
      conn = jaydebeapi.connect(driver, url, [user, password], jarFile)
      cur = conn.cursor()
  
      #创建表students
      sql = 'create table students (id int, name varchar(20))'
      cur.execute(sql)
  
      #往students表中插入三组数据
      sql = "insert into students values(1,'xiaoming'),(2,'xiaohong'),(3,'xiaolan')"
      cur.execute(sql)
  
      #查询students表中的所有数据
      sql = 'select * from students'
      cur.execute(sql)
      ans = cur.fetchall()
      print(ans)
  
      #更新students表中的数据
      sql = 'update students set name = \'xiaolv\' where id = 1'
      cur.execute(sql)
  
      #再次查询students表中的所有数据
      sql = 'select * from students'
      cur.execute(sql)
      ans = cur.fetchall()
      print(ans)
  
      #删除表students
      sql = 'drop table students'
      cur.execute(sql)
  
      cur.close()
      conn.close()
  
  test_jaydebeapi()

• 配置代码中的参数：

  #连接url，设置数据库服务器IP、端口、数据库名
  url = 'jdbc:opengauss://***.***.***.***:20000/test'
  #设置用户名
  user = '***'
  #设置密码
  password = '******'
  #JDBC驱动类路径
  driver = 'com.huawei.opengauss.jdbc.Driver'
  #JDBC驱动jar包路径（默认放在与test_jaydebeapi.py文件同目录下）
  jarFile = './opengaussjdbc.jar'

使用以下命令执行test_jaydebeapi.py文件：

python ./test_jaydebeapi.py

成功连接GaussDB数据库，并返回两次查询结果，如下所示：