金仓数据库KingbaseES客户端编程接口指南-Python（2. 概述）

2. 概述

• python数据库驱动说明

• KingbaseES兼容版本信息

• ksycopg2连接KingbaseES数据库配置

• 检查安装情况

2.1. python数据库驱动说明

ksycopg2是Python编程语言的KingbaseES数据库适配器。它的主要特点是Python DB API 2.0 规范的完整实现和线程安全。

ksycopg2 主要在C程序中作为libpq包装器实现，因此既高效又安全。它具有客户端和服务端游标，支持异步通信和通知、复制。

Python DBAPI 2.0的官方文档可以访问 PEP 249 – Python Database API Specification v2.0 | peps.python.org 。

2.2. KingbaseES兼容版本信息

目前提供的ksycopg2支持情况如下表所示：

表 2.2.6 ksycopg2支持情况

Python版本	系统架构	说明
Python2.7	Linux amd64	仅提供64位支持
	Linux aarch64	仅提供64位支持
	Linux mips64le	仅提供64位支持
	Windows	提供32和64位支持， 32位需要VC9运行时， 64位需要VC12运行时
Python3.5	Linux amd64	仅提供64位支持
	Linux aarch64	仅提供64位支持
	Linux mips64le	尚不支持该版本
	Windows	提供32和64位支持， 都需要VC12运行时

Windows中如果没有安装对应的Python版本时，在导入ksycopg2模块时会有以下报错：

ImportError: DLL load failed: 找不到指定的模块。

2.3. ksycopg2连接KingbaseES数据库配置

首先，需要安装Python，且配置kingbase数据库。

将对应Python版本的ksycopg2驱动解压后，把ksycopg2文件夹放在Python的模块路径中，如 “D:\Python27\Lib\site-packages” 或 “/usr/lib/python35/dist-packages”。

如果不确定Python模块路径，可以在命令行中执行以下语句：

import sys
sys.path

即可查看Python搜索模块的路径，如图所示，从中选一个路径放入其中即可。