31、RTA 参考指南：功能、语法与错误处理

RTA 参考指南：功能、语法与错误处理

1. 核心子例程介绍

在与 PostgreSQL 客户端交互的过程中，有几个核心的子例程发挥着关键作用。

1.1 dbcommand() 子例程

dbcommand()子例程是应用程序与 RTA 之间的桥梁。其主要工作流程如下：
- 应用程序接收来自 PostgreSQL 客户端的 TCP 连接，并将编码后的 SQL 请求字节流通过dbcommand()传递给 RTA。
-dbcommand()将字节流写入输入缓冲区，等待对 SQL 命令进行解析。
- 如果输入缓冲区包含完整的命令，该命令将被执行，nin变量会减去已消耗的字节数，同时返回RTA_SUCCESS。
- 如果输入缓冲区中的命令不完整，将返回RTA_NOCMD，且不会从输入缓冲区中移除任何字节。
- 命令执行后，结果会被编码为 PostgreSQL 协议并放入输出缓冲区out。调用子例程时，nout表示输出缓冲区的可用字节数；返回时，nout会减去放入输出缓冲区的响应大小。若输出缓冲区空间不足，将生成错误消息。

其原型如下：

int dbcommand(char *cmd, int *nin, char *out, int *n