更新时间:2026-10-21 GMT+08:00
分享

数据类型映射

当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。
表1 GaussDB数据类型和C变量类型之间的映射

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]

相关文档