• Robert Haas's avatar
    Glue layer to connect the executor to the shm_mq mechanism. · 4a4e6893
    Robert Haas authored
    The shm_mq mechanism was built to send error (and notice) messages and
    tuples between backends.  However, shm_mq itself only deals in raw
    bytes.  Since commit 2bd9e412, we have
    had infrastructure for one message to redirect protocol messages to a
    queue and for another backend to parse them and do useful things with
    them.  This commit introduces a somewhat analogous facility for tuples
    by adding a new type of DestReceiver, DestTupleQueue, which writes
    each tuple generated by a query into a shm_mq, and a new
    TupleQueueFunnel facility which reads raw tuples out of the queue and
    reconstructs the HeapTuple format expected by the executor.
    
    The TupleQueueFunnel abstraction supports reading from multiple tuple
    streams at the same time, but only in round-robin fashion.  Someone
    could imaginably want other policies, but this should be good enough
    to meet our short-term needs related to parallel query, and we can
    always extend it later.
    
    This also makes one minor addition to the shm_mq API that didn'
    seem worth breaking out as a separate patch.
    
    Extracted from Amit Kapila's parallel sequential scan patch.  This
    code was originally written by me, and then it was revised by Amit,
    and then it was revised some more by me.
    4a4e6893
tqueue.h 1.02 KB