VastbaseG100

基于openGauss内核开发的企业级关系型数据库。

Menu

PQputCopyData

功能描述

在COPY_IN状态里向服务器发送数据。

接口原型

int PQputCopyData(PGconn *conn,
                  const char *buffer,
                  int nbytes);

参数说明

参数 描述
conn 建立连接时返回的连接结构体指针,该指针用于标识某个特定连接。
buffer 向服务器发送的数据buffer。
nbytes 发送数据的字节数。

返回值

如果数据发送成功,结果是 1,如果因为发送企图会阻塞 (这种情况只有在连接是非阻塞模式时才有可能)而没有成功,那么是零, 或者是在发生错误的时候是 -1。(如果返回 -1,那么使用PQerrorMessage 检索细节。如果值是零,那么等待写准备好然后重试。)

其他

应用可以把COPY数据流分隔成任意合适的大小放到缓冲区里。在发送的时候, 缓冲区的边界没有什么特殊的语意。数据流的内容必须匹配COPY命令预期的数据格式。