spi_modifytuple - 주어진 행의 선택된 필드를 교체하여 행을 만듭니다
Heappuple Spi_ModifyTuple (관계Rel, heaptuplerow, intNCOLS, int *Colnum, Datum *값, const char *nulls)
SPI_ModifyTuple선택한 열에 대한 새 값을 대체하여 원래 행의 열을 다른 위치에서 복사하여 새 행을 만듭니다. 입력 행이 수정되지 않았습니다. 새 행은 상위 집행자 컨텍스트에서 반환됩니다.
이 함수는 SPI에 연결된 상태에서만 사용할 수 있습니다. 그렇지 않으면 NULL을 반환하고 설정합니다SPI_RESULTtoSPI_ERROR_UNCONNECT.
관계Rel행의 행 디스크립터의 소스로만 사용됩니다. (행 디스크립터가 아닌 관계를 전달하는 것은 잘못입니다.)
heappupleRow수정 될 행
intncols변경할 열 수
int *Colnum길이 배열NCOLS, 변경할 열의 수를 포함하는 (열 번호 1에서 시작)
Datum *값길이 배열NCOLS, 지정된 열에 대한 새 값을 포함하는
const char *nulls길이 배열NCOLS, 어떤 새로운 값이 null인지 설명
ifnullsisNULLtheSPI_ModifyTuple새 값이 무효라고 가정합니다. 그렇지 않으면,의 각 항목nulls배열이' '해당 새 값이 Null이 아닌 경우'n'해당 새 값이 NULL 인 경우. (후자의 경우 해당의 실제 값값항목은 중요하지 않습니다.) 참고nulls텍스트 문자열이 아니라 배열 일뿐입니다. 필요하지 않습니다'\ 0'터미네이터.
수정 된 새 행, 상단 집행자 컨텍스트에 할당 된 새로운 행,NULL오류 (참조SPI_RESULT오류 표시)
on Error,SPI_RESULT다음과 같이 설정됩니다.
SPI_ERROR_ARGUMENTifRelisNULL또는 ifRowisNULL또는 ifNCOLS0 이하이거나 동일하거나 ifColnumisNULL또는 if값isNULL.
spi_error_noattributeifColnum유효하지 않은 열 번호가 포함row)
SPI_ERROR_UNCONNECTSPI가 활성화되지 않은 경우