预发布版本文档。 PostgreSQL 19beta4 为测试版本,最终发布内容可能有所不同。
SPI_register_relation
SPI_register_relation — 让临时命名关系可在 SPI 查询中按名称使用
大纲
int SPI_register_relation(EphemeralNamedRelation enr)
描述
SPI_register_relation 使一个带有相关信息的临时命名关系对通过当前 SPI 连接规划和执行的查询可用。
参数
EphemeralNamedRelationenr临时命名关系的注册表项
返回值
如果该命令的执行成功,则将返回下列(非负)值:
SPI_OK_REL_REGISTER该关系已成功按名称注册
出错时,返回以下负值之一:
SPI_ERROR_ARGUMENTenr为NULL,或其name字段为NULLSPI_ERROR_UNCONNECTED如果从一个未连接的 C 函数中调用
SPI_ERROR_REL_DUPLICATEenr的name字段指定的名称已经为该连接注册