数据类型映射
当ecpg应用程序在GaussDB服务器和C语言程序之间交换数据时(例如从服务器检索查询结果或者执行带有输入参数的SQL语句),必须在GaussDB数据类型与C语言宿主变量类型之间进行数据类型的转换与映射。
根据数据访问机制的不同,映射的数据类型主要分为两大类:
- 基础的GaussDB数据类型:如integer、smallint、text等,可以直接映射到C语言的原生基本数据类型(如int、short、char[]),由应用程序直接读取和写入。
- 特殊复杂GaussDB数据类型:如timestamp、numeric、date、interval等,由于C语言缺乏原生的精确数值或日期时间数据结构,此类数据无法直接通过常规赋值读取,必须通过ecpg提供的专用接口库函数(如pgtypeslib)进行访问和计算。具体请参见ecpg接口参考章节。
- 当前仅支持对于C语言的基本数据类型的使用或者组合,不支持C++语言中string数据类型用作宿主变量数据类型。
- 当前ecpg仅对SQL的常用数据类型提供内置映射关系,具体支持的类型对照与转换规则请参见表1。
| GaussDB数据类型 | 宿主变量数据类型 |
|---|---|
| smallint | short |
| integer | int |
| bigint | long long int |
| boolean | boolean |
| character(n), varchar(n), text | char[n+1], VARCHAR[n+1] |
| double precision | double |
| real | float |
| smallserial | short |
| serial | int |
| bigserial | long long int |
| oid | unsigned int |
| name | char[NAMEDATALEN] |
| date | date [a] 说明: [a]表示特殊数据类型,此类型可以通过访问特殊数据类型访问。 |
| timestamp | timestamp [a] |
| interval | interval [a] |
| decimal | decimal [a] |
| numeric | numeric [a] |