应用程序开发教程-华为云

云数据库 GAUSSDB-基于Psycopg开发

基于Psycopg开发 Psycopg是一种用于执行SQL语句的PythonAPI，可以为 GaussDB数据库提供统一访问接口，应用程序可基于它进行数据操作。Psycopg2是对libpq的封装，主要使用C语言实现，既高效又安全。它具有客户端游标和服务器端游标、异步通信和通知、支持“COPY TO/COPY FROM”功能。支持多种类型Python开箱即用，适配 GaussDB 数据类型；通过灵活的对象适配系统，可以扩展和定制适配。Psycopg2兼容Unicode。 GaussDB数据库提供了对Psycopg2特性的支持，并且支持psycopg2通过SSL模式连接。表1 Psycopg支持平台操作系统平台 Python版本 EulerOS 2.5 ARM64位 x86_64位 3.8.5 EulerOS 2.9 ARM64位 x86_64位 3.7.4 EulerOS 2.10, Kylin v10, UnionTech20 ARM64位 x86_64位 3.7.9 EulerOS 2.11, Suse 12.5 ARM64位 x86_64位 3.9.11 psycopg2在编译过程中，会连接（link）GaussDB的openssl，GaussDB的openssl与操作系统自带的openssl可能不兼容。如果遇到不兼容现象，例如提示"version 'OPENSSL_1_1_1f' not found"，请使用环境变量LD_LIBRARY_PATH进行隔离，以避免混用操作系统自带的openssl与GaussDB依赖的openssl。例如，在执行某个调用psycopg2的应用软件client.py时，将环境变量显性赋予该应用软件： export LD_LIBRARY_PATH=/path/to/gaussdb/libs:$LD_LIBRARY_PATH python client.py 其中，/path/to/pyscopg2/lib表示GaussDB依赖的openssl库所在目录，需根据文件实际存储路径修改。开发流程 Psycopg包示例：常用操作 Psycopg接口参考父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-GaussDB应用程序开发教程概述:JDBC

JDBC JDBC（Java Database Connectivity，Java数据库连接）是用于执行SQL语句的Java API，可以为多种关系数据库提供统一访问接口。它允许Java应用程序通过SQL语句来执行数据库操作，包括查询、插入、更新和删除数据等。以下是JDBC的一些关键特点和用法：数据库连接管理：JDBC允许应用程序建立与数据库的连接，并管理这些连接的生命周期。 SQL执行：使用JDBC，可以执行SQL查询、更新、删除等操作。这通过在Java代码中构建SQL语句并将其发送到数据库来实现。事务管理：JDBC支持事务管理，可以通过JDBC API来启动、提交或回滚事务，确保数据库操作的一致性和完整性。异常处理： JDBC定义了一组异常类来处理数据库操作期间可能发生的各种异常情况，开发人员可以使用try-catch块来捕获和处理这些异常。批处理操作：JDBC提供了批处理功能，允许一次性执行多个SQL语句，从而提高数据库操作的效率。元数据访问：通过JDBC，可以获取数据库的元数据信息，如表结构、列名、数据类型等，从而动态地构建SQL查询或根据数据库结构进行操作。总的来说，JDBC提供了一个灵活且强大的桥梁，使Java应用程序能够与各种不同的数据库进行交互，从而实现数据的持久化和管理。GaussDB库提供了对JDBC 4.0特性的支持，需要使用JDK1.8版本编译程序代码，不支持JDBC桥接ODBC方式。基于JDBC开发详细教程请参见基于JDBC开发。

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-基于JDBC开发

基于JDBC开发 JDBC（Java Database Connectivity，java数据库连接）是一种用于执行SQL语句的Java API，可以为多种关系数据库提供统一访问接口，应用程序可基于它操作数据。 GaussDB库提供了对JDBC 4.0特性的支持，需要使用JDK1.8版本编译程序代码，不支持JDBC桥接ODBC方式。 JDBC包、驱动类和环境类开发流程加载驱动连接数据库连接数据库（以SSL方式）连接数据库（以UDS方式）执行SQL语句处理结果集关闭数据库连接日志管理示例：常用操作示例：重新执行应用SQL 示例：通过本地文件导入导出数据示例：从MYSQL进行数据迁移示例：逻辑复制代码示例示例：不同场景下连接数据库参数配置 JDBC接口参考 JDBC数据类型映射关系常见问题处理父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-开发规范

开发规范如果用户在APP的开发中，使用了连接池机制，那么需要遵循如下规范：如果在连接中设置了GUC参数，那么在将连接归还连接池之前，必须使用“SET SESSION AUTHORIZATION DEFAULT;RESET ALL;”将连接的状态清空。如果使用了临时表，那么在将连接归还连接池之前，必须将临时表删除。否则，连接池里面的连接就是有状态的，会对用户后续使用连接池进行操作的正确性带来影响。应用程序开发驱动兼容性说明如表1所示：表1 兼容性说明驱动兼容性说明 JDBC、ODBC、libpq、Psycopg 驱动前向兼容数据库，若需使用驱动与数据库同步增加的新特性，须升级数据库。在多线程环境下使用驱动： JDBC驱动程序不是线程安全的，不保证连接上的方法是同步的。由调用者来同步对驱动程序的调用。父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-开发规范

开发规范如果用户在APP的开发过程中，使用了连接池机制，那么需要遵循如下规范：如果在连接中设置了GUC参数，那么在将连接归还连接池之前，必须使用“SET SESSION AUTHORIZATION DEFAULT;RESET ALL;”将连接的状态清空。如果使用了临时表，那么在将连接归还连接池之前，必须将临时表删除。否则，连接池里面的连接就是有状态的，会对用户后续使用连接池进行操作的正确性带来影响。应用程序开发驱动兼容性说明如表1所示：表1 兼容性说明驱动兼容性说明 JDBC、Go 驱动前向兼容数据库，若需使用驱动与数据库同步增加的新特性，须升级数据库。 ODBC、libpq、Psycopg、ecpg 驱动须与数据库版本配套。 behavior_compat_options='proc_outparam_override' 重载参数仅在A兼容模式可用。原则上，兼容性参数应在创建数据库后就设置，不应在使用过程中来回切换。涉及使用以下场景的特性需要配合将JDBC驱动升级到503.1及以上的配套版本：开启s2兼容性参数，设置sessiontimezone的合法性校验。在多线程环境下使用驱动： JDBC驱动程序是非线程安全的，无法保证连接上的方法同步。由调用者来同步对驱动程序的调用。父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-基于Psycopg开发

基于Psycopg开发 Psycopg是一种用于执行SQL语句的PythonAPI，可以为GaussDB数据库提供统一访问接口，应用程序可基于它进行数据操作。Psycopg2是对libpq的封装，主要使用C语言实现，既高效又安全。它具有客户端游标和服务器端游标、异步通信和通知、支持“COPY TO/COPY FROM”功能。支持多种类型Python开箱即用，适配GaussDB数据类型。通过灵活的对象适配系统，可以扩展和定制适配。Psycopg2兼容Unicode。 GaussDB数据库提供了对Psycopg2特性的支持，并且支持psycopg2通过SSL模式连接。表1 Psycopg支持平台操作系统平台 Python版本 EulerOS 2.5 ARM64位 x86_64位 3.8.5 EulerOS 2.9 ARM64位 x86_64位 3.7.4 EulerOS 2.10、Kylin v10、UnionTech20 ARM64位 x86_64位 3.7.9 EulerOS 2.11、Suse 12.5 ARM64位 x86_64位 3.9.11 psycopg2在编译过程中，会连接（link）GaussDB的openssl，GaussDB的openssl与操作系统自带的openssl可能不兼容。如果遇到不兼容现象，例如提示"version 'OPENSSL_1_1_1f' not found"，请使用环境变量LD_LIBRARY_PATH进行隔离，以避免混用操作系统自带的openssl与GaussDB依赖的openssl。例如，在执行某个调用psycopg2的应用软件client.py时，将环境变量显性赋予该应用软件： export LD_LIBRARY_PATH=/path/to/gaussdb/libs:$LD_LIBRARY_PATH python client.py 其中，/path/to/pyscopg2/lib 表示GaussDB依赖的openssl库所在目录，需根据文件实际存储路径修改。开发流程开发步骤示例：常用操作 Psycopg接口参考父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-获取驱动包:获取驱动包

获取驱动包根据不同版本的实例，下载不同版本的发布包，如表1所示。表1 驱动包下载列表版本下载地址 V2.0-8.x 驱动包驱动包校验包为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下：上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。执行如下命令，校验软件包完整性。 cat GaussDB_driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-基于Psycopg开发

基于Psycopg开发 Psycopg是一种用于执行SQL语句的PythonAPI，可以为GaussDB数据库提供统一访问接口，应用程序可基于它进行数据操作。Psycopg2是对libpq的封装，主要使用C语言实现，既高效又安全。它具有客户端游标和服务器端游标、异步通信和通知、支持“COPY TO/COPY FROM”功能。支持多种类型Python开箱即用，适配GaussDB数据类型。通过灵活的对象适配系统，可以扩展和定制适配。Psycopg2兼容Unicode。 GaussDB数据库提供了对Psycopg2特性的支持，并且支持psycopg2通过SSL模式连接。表1 Psycopg支持平台操作系统平台 Python版本 EulerOS V2.0SP5 ARM64位 x86_64位 3.8.5 EulerOS V2.0SP9 ARM64位 x86_64位 3.7.4 EulerOS V2.0SP10、Kylin v10、UnionTech20 ARM64位 x86_64位 3.7.9 EulerOS V2.0SP11、Suse 12.5 ARM64位 x86_64位 3.9.11 Huawei Cloud EulerOS 2.0 ARM64位 x86_64位 3.9.9 psycopg2在编译过程中，会连接（link）GaussDB的openssl，GaussDB的openssl与操作系统自带的openssl可能不兼容。如果遇到不兼容现象，例如提示"version 'OPENSSL_1_1_1f' not found"，请使用环境变量LD_LIBRARY_PATH进行隔离，以避免混用操作系统自带的openssl与GaussDB依赖的openssl。例如，在执行某个调用psycopg2的应用软件client.py时，将环境变量显性赋予该应用软件： export LD_LIBRARY_PATH=/path/to/gaussdb/libs:$LD_LIBRARY_PATH python client.py 其中，/path/to/pyscopg2/lib 表示GaussDB依赖的openssl库所在目录，需根据文件实际存储路径修改。开发流程 Psycopg包示例：常用操作 Psycopg接口参考父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-开发规范

开发规范如果用户在APP的开发过程中，使用了连接池机制，那么需要遵循如下规范：如果在连接中设置了GUC参数，那么在将连接归还连接池之前，必须使用“SET SESSION AUTHORIZATION DEFAULT;RESET ALL;”将连接的状态清空。如果使用了临时表，那么在将连接归还连接池之前，必须将临时表删除。否则，连接池里面的连接就是有状态的，会对用户后续使用连接池进行操作的正确性带来影响。应用程序开发驱动兼容性说明如表1所示：表1 兼容性说明驱动兼容性说明 JDBC、Go 驱动前向兼容数据库，若需使用驱动与数据库同步增加的新特性，须升级数据库。 ODBC、libpq、Psycopg、ecpg 驱动须与数据库版本配套。 behavior_compat_options='proc_outparam_override' 重载参数仅在A兼容模式可用。原则上，兼容性参数应在创建数据库后就设置，不应在使用过程中来回切换。涉及使用以下场景的特性需要配合将JDBC驱动升级到503.1及以上的配套版本：开启s2兼容性参数，设置sessiontimezone的合法性校验。在多线程环境下使用驱动： JDBC驱动程序是非线程安全的，无法保证连接上的方法同步。由调用者来同步对驱动程序的调用。父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-开发规范

开发规范如果用户在APP的开发过程中，使用了连接池机制，那么需要遵循如下规范：如果在连接中设置了GUC参数，那么在将连接归还连接池之前，必须使用“SET SESSION AUTHORIZATION DEFAULT;RESET ALL;”将连接的状态清空。如果使用了临时表，那么在将连接归还连接池之前，必须将临时表删除。否则，连接池里面的连接就是有状态的，会对用户后续使用连接池进行操作的正确性带来影响。应用程序开发驱动兼容性说明如表1所示。表1 兼容性说明驱动兼容性说明 JDBC、Go、ODBC、libpq、Psycopg、ecpg 驱动前向兼容数据库，若需使用驱动与数据库同步增加的新特性，须升级数据库。 behavior_compat_options='proc_outparam_override' 重载参数仅在A兼容模式可用。原则上，兼容性参数应在创建数据库后就设置，不应在使用过程中来回切换。涉及使用以下场景的特性需要配合将JDBC驱动升级到503.1.0及以上的配套版本。全密态内存解密逃生通道。通过JDBC使用record、array、tableof嵌套自定义类型。开启s2兼容性参数，设置sessiontimezone的合法性校验。在多线程环境下使用驱动： JDBC驱动程序线程不是安全的，无法保证连接上的方法同步。由调用者同步对驱动程序的调用。父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GAUSSDB-开发规范

开发规范如果用户在APP的开发过程中，使用了连接池机制，那么需要遵循如下规范：如果在连接中设置了GUC参数，那么在将连接归还连接池之前，必须使用“SET SESSION AUTHORIZATION DEFAULT;RESET ALL;”将连接的状态清空。如果使用了临时表，那么在将连接归还连接池之前，必须将临时表删除。否则，连接池里面的连接就是有状态的，会对用户后续使用连接池进行操作的正确性带来影响。应用程序开发驱动兼容性说明如表1所示：表1 兼容性说明驱动兼容性说明 JDBC、Go、ODBC、libpq、Psycopg、ecpg 驱动前向兼容数据库，若需使用驱动与数据库同步增加的新特性，须升级数据库。原则上，兼容性参数应在创建数据库后就设置，不应在使用过程中来回切换。涉及使用以下场景的特性需要配合将JDBC驱动升级到503.1.0及以上的配套版本：开启s2兼容性参数，设置sessiontimezone的合法性校验。在多线程环境下使用驱动： JDBC驱动程序线程不是安全的，无法保证连接上的方法同步。由调用者来同步对驱动程序的调用。父主题：应用程序开发教程

云数据库 GAUSSDB 应用程序开发教程

云数据库 GaussDB-驱动包获取:获取驱动包

获取驱动包根据不同版本的实例，下载不同版本的发布包，如表1所示。表1 驱动包下载列表版本下载地址 3.x 驱动包驱动包校验包 2.x 驱动包驱动包校验包为了防止软件包在传递过程或存储期间被恶意篡改，下载软件包时需下载对应的校验包对软件包进行校验，校验方法如下：上传软件包和软件包校验包到虚拟机（Linux操作系统）的同一目录下。执行如下命令，校验软件包完整性。 cat GaussDB_driver.zip.sha256 | sha256sum --check 如果回显OK，则校验通过。 GaussDB_driver.zip: OK

云数据库 GaussDB 应用程序开发教程

云服务器内容精选

应用程序开发教程

7*24

备案

专业服务

退订

建议反馈

售前咨询热线