struct HeapTupleData (Postgres Coderef)

코드 위치 (v17.1)

• File path: src/include/access/htup.h
• Line: 62

src/include/access/htup.h:62

• Link: struct HeapTupleData

Overview §

• 하나의 (logical) record 에 대한 (physical) version tuple (즉, HeapTupleHeaderData) chain 의 head 를 나타내는 자료구조이다.
• 얘는 disk 에 저장되지는 않는다. Buffer pool 에 올라오면 그때 생성된다는 것.

+------------------------+
| HeapTupleData (t_data) |
+-------------------|----+
                    |
  +-(first version)-+
  |
  |    +------------------------------+----------+
  +--> | HeapTupleHeaderData (t_ctid) | Data ... |
       +-------------------------|----+----------+
                                 |
    +-------(next version)-------+
    |
    |    +---------------------+----------+
    +--> | HeapTupleHeaderData | Data ... |
         +---------------------+----------+

• 그리고 이놈에 대한 pointer 를 typedef 해놓은게 HeapTuple 이다.

Field Ref §

• t_len: t_data 가 가리키는 놈의 byte length.
• t_self:#draft Tuple 이 속한 page 와 slot 정보인듯
• t_tableOid: Tuple 이 속한 table 의 object ID.
• t_data: HeapTupleHeaderData 를 가리키는 포인터.