1996-07-09 08:22:35 +02:00
|
|
|
/*-------------------------------------------------------------------------
|
|
|
|
*
|
1999-02-14 00:22:53 +01:00
|
|
|
* dest.c
|
1999-01-27 01:36:28 +01:00
|
|
|
* support for various communication destinations - see include/tcop/dest.h
|
1996-07-09 08:22:35 +02:00
|
|
|
*
|
2001-01-24 20:43:33 +01:00
|
|
|
* Portions Copyright (c) 1996-2001, PostgreSQL Global Development Group
|
2000-01-26 06:58:53 +01:00
|
|
|
* Portions Copyright (c) 1994, Regents of the University of California
|
1996-07-09 08:22:35 +02:00
|
|
|
*
|
|
|
|
*
|
|
|
|
* IDENTIFICATION
|
2001-03-22 05:01:46 +01:00
|
|
|
* $Header: /cvsroot/pgsql/src/backend/tcop/dest.c,v 1.43 2001/03/22 03:59:47 momjian Exp $
|
1996-07-09 08:22:35 +02:00
|
|
|
*
|
|
|
|
*-------------------------------------------------------------------------
|
|
|
|
*/
|
|
|
|
/*
|
1997-09-07 07:04:48 +02:00
|
|
|
* INTERFACE ROUTINES
|
|
|
|
* BeginCommand - prepare destination for tuples of the given type
|
1999-01-27 01:36:28 +01:00
|
|
|
* DestToFunction - identify per-tuple processing routines
|
1997-09-07 07:04:48 +02:00
|
|
|
* EndCommand - tell destination that no more tuples will arrive
|
1998-05-07 01:51:16 +02:00
|
|
|
* NullCommand - tell dest that an empty query string was recognized
|
|
|
|
* ReadyForQuery - tell dest that we are ready for a new query
|
1997-09-07 07:04:48 +02:00
|
|
|
*
|
|
|
|
* NOTES
|
|
|
|
* These routines do the appropriate work before and after
|
|
|
|
* tuples are returned by a query to keep the backend and the
|
|
|
|
* "destination" portals synchronized.
|
1996-07-09 08:22:35 +02:00
|
|
|
*
|
1999-01-27 01:36:28 +01:00
|
|
|
* There is a second level of initialization/cleanup performed by the
|
|
|
|
* setup/cleanup routines identified by DestToFunction. This could
|
|
|
|
* probably be merged with the work done by BeginCommand/EndCommand,
|
|
|
|
* but as of right now BeginCommand/EndCommand are used in a rather
|
|
|
|
* unstructured way --- some places call Begin without End, some vice
|
|
|
|
* versa --- so I think I'll just leave 'em alone for now. tgl 1/99.
|
|
|
|
*
|
1996-07-09 08:22:35 +02:00
|
|
|
*/
|
1997-01-10 21:19:49 +01:00
|
|
|
|
1996-07-09 08:22:35 +02:00
|
|
|
#include "postgres.h"
|
|
|
|
|
1999-07-16 07:00:38 +02:00
|
|
|
#include "access/printtup.h"
|
1998-01-26 02:42:53 +01:00
|
|
|
#include "libpq/libpq.h"
|
1999-04-25 05:19:27 +02:00
|
|
|
#include "libpq/pqformat.h"
|
1996-07-09 08:22:35 +02:00
|
|
|
|
|
|
|
|
1997-09-08 04:41:22 +02:00
|
|
|
static char CommandInfo[32] = {0};
|
1997-08-19 23:40:56 +02:00
|
|
|
|
1996-07-09 08:22:35 +02:00
|
|
|
/* ----------------
|
1999-01-27 01:36:28 +01:00
|
|
|
* dummy DestReceiver functions
|
1996-07-09 08:22:35 +02:00
|
|
|
* ----------------
|
|
|
|
*/
|
1997-01-08 09:39:10 +01:00
|
|
|
static void
|
1999-05-26 00:43:53 +02:00
|
|
|
donothingReceive(HeapTuple tuple, TupleDesc typeinfo, DestReceiver *self)
|
1996-07-09 08:22:35 +02:00
|
|
|
{
|
|
|
|
}
|
|
|
|
|
1999-01-27 01:36:28 +01:00
|
|
|
static void
|
1999-05-26 00:43:53 +02:00
|
|
|
donothingSetup(DestReceiver *self, TupleDesc typeinfo)
|
1999-01-27 01:36:28 +01:00
|
|
|
{
|
|
|
|
}
|
1997-08-29 11:06:27 +02:00
|
|
|
|
1999-01-27 01:36:28 +01:00
|
|
|
static void
|
1999-05-26 00:43:53 +02:00
|
|
|
donothingCleanup(DestReceiver *self)
|
1996-07-09 08:22:35 +02:00
|
|
|
{
|
1999-01-27 01:36:28 +01:00
|
|
|
}
|
|
|
|
|
|
|
|
/* ----------------
|
|
|
|
* static DestReceiver structs for dest types needing no local state
|
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
static DestReceiver donothingDR = {
|
|
|
|
donothingReceive, donothingSetup, donothingCleanup
|
|
|
|
};
|
|
|
|
static DestReceiver debugtupDR = {
|
|
|
|
debugtup, donothingSetup, donothingCleanup
|
|
|
|
};
|
|
|
|
static DestReceiver spi_printtupDR = {
|
|
|
|
spi_printtup, donothingSetup, donothingCleanup
|
|
|
|
};
|
|
|
|
|
|
|
|
/* ----------------
|
|
|
|
* BeginCommand - prepare destination for tuples of the given type
|
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
BeginCommand(char *pname,
|
|
|
|
int operation,
|
|
|
|
TupleDesc tupdesc,
|
|
|
|
bool isIntoRel,
|
|
|
|
bool isIntoPortal,
|
|
|
|
char *tag,
|
|
|
|
CommandDest dest)
|
|
|
|
{
|
|
|
|
Form_pg_attribute *attrs = tupdesc->attrs;
|
|
|
|
int natts = tupdesc->natts;
|
|
|
|
int i;
|
|
|
|
|
1997-09-07 07:04:48 +02:00
|
|
|
switch (dest)
|
|
|
|
{
|
1999-01-27 01:36:28 +01:00
|
|
|
case Remote:
|
|
|
|
case RemoteInternal:
|
|
|
|
/* ----------------
|
2000-07-08 05:04:41 +02:00
|
|
|
* if this is a "retrieve into portal" query, done
|
1999-01-27 01:36:28 +01:00
|
|
|
* because nothing needs to be sent to the fe.
|
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
CommandInfo[0] = '\0';
|
|
|
|
if (isIntoPortal)
|
|
|
|
break;
|
|
|
|
|
|
|
|
/* ----------------
|
|
|
|
* if portal name not specified for remote query,
|
|
|
|
* use the "blank" portal.
|
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
if (pname == NULL)
|
|
|
|
pname = "blank";
|
|
|
|
|
|
|
|
/* ----------------
|
|
|
|
* send fe info on tuples we're about to send
|
|
|
|
* ----------------
|
|
|
|
*/
|
1999-04-25 23:50:58 +02:00
|
|
|
pq_puttextmessage('P', pname);
|
1999-01-27 01:36:28 +01:00
|
|
|
|
|
|
|
/* ----------------
|
|
|
|
* if this is a retrieve, then we send back the tuple
|
|
|
|
* descriptor of the tuples. "retrieve into" is an
|
|
|
|
* exception because no tuples are returned in that case.
|
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
if (operation == CMD_SELECT && !isIntoRel)
|
|
|
|
{
|
1999-04-25 05:19:27 +02:00
|
|
|
StringInfoData buf;
|
1999-05-25 18:15:34 +02:00
|
|
|
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_beginmessage(&buf);
|
1999-05-25 18:15:34 +02:00
|
|
|
pq_sendbyte(&buf, 'T'); /* tuple descriptor message type */
|
|
|
|
pq_sendint(&buf, natts, 2); /* # of attributes in
|
|
|
|
* tuples */
|
1999-01-27 01:36:28 +01:00
|
|
|
|
|
|
|
for (i = 0; i < natts; ++i)
|
|
|
|
{
|
1999-11-08 00:08:36 +01:00
|
|
|
pq_sendstring(&buf, NameStr(attrs[i]->attname));
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_sendint(&buf, (int) attrs[i]->atttypid,
|
|
|
|
sizeof(attrs[i]->atttypid));
|
|
|
|
pq_sendint(&buf, attrs[i]->attlen,
|
|
|
|
sizeof(attrs[i]->attlen));
|
1999-01-27 01:36:28 +01:00
|
|
|
if (PG_PROTOCOL_MAJOR(FrontendProtocol) >= 2)
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_sendint(&buf, attrs[i]->atttypmod,
|
|
|
|
sizeof(attrs[i]->atttypmod));
|
1999-01-27 01:36:28 +01:00
|
|
|
}
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_endmessage(&buf);
|
1999-01-27 01:36:28 +01:00
|
|
|
}
|
1997-09-08 04:41:22 +02:00
|
|
|
break;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1999-01-27 01:36:28 +01:00
|
|
|
case Debug:
|
|
|
|
/* ----------------
|
|
|
|
* show the return type of the tuples
|
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
if (pname == NULL)
|
|
|
|
pname = "blank";
|
|
|
|
|
|
|
|
showatts(pname, tupdesc);
|
|
|
|
break;
|
|
|
|
|
|
|
|
case None:
|
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/* ----------------
|
|
|
|
* DestToFunction - return appropriate receiver function set for dest
|
|
|
|
* ----------------
|
|
|
|
*/
|
1999-05-25 18:15:34 +02:00
|
|
|
DestReceiver *
|
1999-01-27 01:36:28 +01:00
|
|
|
DestToFunction(CommandDest dest)
|
|
|
|
{
|
|
|
|
switch (dest)
|
|
|
|
{
|
2001-03-22 05:01:46 +01:00
|
|
|
case Remote:
|
2000-12-01 23:10:31 +01:00
|
|
|
return printtup_create_DR(false);
|
1999-01-27 01:36:28 +01:00
|
|
|
|
|
|
|
case RemoteInternal:
|
2000-12-01 23:10:31 +01:00
|
|
|
return printtup_create_DR(true);
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1997-09-08 04:41:22 +02:00
|
|
|
case Debug:
|
1999-05-25 18:15:34 +02:00
|
|
|
return &debugtupDR;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1997-09-08 04:41:22 +02:00
|
|
|
case SPI:
|
1999-05-25 18:15:34 +02:00
|
|
|
return &spi_printtupDR;
|
1997-09-07 07:04:48 +02:00
|
|
|
|
1997-09-08 04:41:22 +02:00
|
|
|
case None:
|
|
|
|
default:
|
1999-05-25 18:15:34 +02:00
|
|
|
return &donothingDR;
|
1997-09-07 07:04:48 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* never gets here, but DECstation lint appears to be stupid...
|
|
|
|
*/
|
|
|
|
|
1999-05-25 18:15:34 +02:00
|
|
|
return &donothingDR;
|
1996-07-09 08:22:35 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/* ----------------
|
1997-09-07 07:04:48 +02:00
|
|
|
* EndCommand - tell destination that no more tuples will arrive
|
1996-07-09 08:22:35 +02:00
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
EndCommand(char *commandTag, CommandDest dest)
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
char buf[64];
|
1997-09-07 07:04:48 +02:00
|
|
|
|
|
|
|
switch (dest)
|
|
|
|
{
|
1997-09-08 04:41:22 +02:00
|
|
|
case Remote:
|
1999-01-27 01:36:28 +01:00
|
|
|
case RemoteInternal:
|
1997-09-08 04:41:22 +02:00
|
|
|
/* ----------------
|
|
|
|
* tell the fe that the query is over
|
|
|
|
* ----------------
|
|
|
|
*/
|
1999-04-25 05:19:27 +02:00
|
|
|
sprintf(buf, "%s%s", commandTag, CommandInfo);
|
1999-04-25 23:50:58 +02:00
|
|
|
pq_puttextmessage('C', buf);
|
1999-01-27 01:36:28 +01:00
|
|
|
CommandInfo[0] = '\0';
|
1997-09-08 04:41:22 +02:00
|
|
|
break;
|
|
|
|
|
|
|
|
case Debug:
|
|
|
|
case None:
|
|
|
|
default:
|
|
|
|
break;
|
1997-09-07 07:04:48 +02:00
|
|
|
}
|
1996-07-09 08:22:35 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/*
|
|
|
|
* These are necessary to sync communications between fe/be processes doing
|
|
|
|
* COPY rel TO stdout
|
1997-09-07 07:04:48 +02:00
|
|
|
*
|
|
|
|
* or
|
1996-07-09 08:22:35 +02:00
|
|
|
*
|
|
|
|
* COPY rel FROM stdin
|
|
|
|
*
|
1998-05-07 01:51:16 +02:00
|
|
|
* NOTE: the message code letters are changed at protocol version 2.0
|
|
|
|
* to eliminate possible confusion with data tuple messages.
|
1996-07-09 08:22:35 +02:00
|
|
|
*/
|
|
|
|
void
|
1996-11-10 04:06:38 +01:00
|
|
|
SendCopyBegin(void)
|
1996-07-09 08:22:35 +02:00
|
|
|
{
|
1998-05-07 01:51:16 +02:00
|
|
|
if (PG_PROTOCOL_MAJOR(FrontendProtocol) >= 2)
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_putbytes("H", 1); /* new way */
|
1998-05-07 01:51:16 +02:00
|
|
|
else
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_putbytes("B", 1); /* old way */
|
1996-07-09 08:22:35 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
void
|
1996-11-10 04:06:38 +01:00
|
|
|
ReceiveCopyBegin(void)
|
1996-07-09 08:22:35 +02:00
|
|
|
{
|
1998-05-07 01:51:16 +02:00
|
|
|
if (PG_PROTOCOL_MAJOR(FrontendProtocol) >= 2)
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_putbytes("G", 1); /* new way */
|
1998-05-07 01:51:16 +02:00
|
|
|
else
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_putbytes("D", 1); /* old way */
|
1998-05-07 01:51:16 +02:00
|
|
|
/* We *must* flush here to ensure FE knows it can send. */
|
1997-09-07 07:04:48 +02:00
|
|
|
pq_flush();
|
1996-07-09 08:22:35 +02:00
|
|
|
}
|
|
|
|
|
|
|
|
/* ----------------
|
1998-05-07 01:51:16 +02:00
|
|
|
* NullCommand - tell dest that an empty query string was recognized
|
1997-09-07 07:04:48 +02:00
|
|
|
*
|
1998-05-07 01:51:16 +02:00
|
|
|
* In FE/BE protocol version 1.0, this hack is necessary to support
|
|
|
|
* libpq's crufty way of determining whether a multiple-command
|
|
|
|
* query string is done. In protocol 2.0 it's probably not really
|
|
|
|
* necessary to distinguish empty queries anymore, but we still do it
|
|
|
|
* for backwards compatibility with 1.0.
|
1996-07-09 08:22:35 +02:00
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
NullCommand(CommandDest dest)
|
|
|
|
{
|
1997-09-07 07:04:48 +02:00
|
|
|
switch (dest)
|
|
|
|
{
|
1999-05-25 18:15:34 +02:00
|
|
|
case RemoteInternal:
|
|
|
|
case Remote:
|
1999-01-27 01:36:28 +01:00
|
|
|
/* ----------------
|
|
|
|
* tell the fe that we saw an empty query string
|
|
|
|
* ----------------
|
|
|
|
*/
|
1999-05-25 18:15:34 +02:00
|
|
|
pq_putbytes("I", 2);/* note we send I and \0 */
|
1998-05-07 01:51:16 +02:00
|
|
|
break;
|
|
|
|
|
|
|
|
case Debug:
|
|
|
|
case None:
|
|
|
|
default:
|
|
|
|
break;
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
/* ----------------
|
|
|
|
* ReadyForQuery - tell dest that we are ready for a new query
|
|
|
|
*
|
|
|
|
* The ReadyForQuery message is sent in protocol versions 2.0 and up
|
|
|
|
* so that the FE can tell when we are done processing a query string.
|
|
|
|
*
|
|
|
|
* Note that by flushing the stdio buffer here, we can avoid doing it
|
|
|
|
* most other places and thus reduce the number of separate packets sent.
|
|
|
|
* ----------------
|
|
|
|
*/
|
|
|
|
void
|
|
|
|
ReadyForQuery(CommandDest dest)
|
|
|
|
{
|
1997-09-07 07:04:48 +02:00
|
|
|
switch (dest)
|
|
|
|
{
|
1999-05-25 18:15:34 +02:00
|
|
|
case RemoteInternal:
|
|
|
|
case Remote:
|
1999-01-27 01:36:28 +01:00
|
|
|
if (PG_PROTOCOL_MAJOR(FrontendProtocol) >= 2)
|
1999-04-25 05:19:27 +02:00
|
|
|
pq_putbytes("Z", 1);
|
1999-01-27 01:36:28 +01:00
|
|
|
/* Flush output at end of cycle in any case. */
|
|
|
|
pq_flush();
|
1997-09-08 04:41:22 +02:00
|
|
|
break;
|
|
|
|
|
|
|
|
case Debug:
|
|
|
|
case None:
|
|
|
|
default:
|
|
|
|
break;
|
1996-07-09 08:22:35 +02:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
void
|
1997-09-07 07:04:48 +02:00
|
|
|
UpdateCommandInfo(int operation, Oid lastoid, uint32 tuples)
|
1996-07-09 08:22:35 +02:00
|
|
|
{
|
1997-09-07 07:04:48 +02:00
|
|
|
switch (operation)
|
|
|
|
{
|
1999-05-25 18:15:34 +02:00
|
|
|
case CMD_INSERT:
|
1997-09-08 04:41:22 +02:00
|
|
|
if (tuples > 1)
|
|
|
|
lastoid = InvalidOid;
|
|
|
|
sprintf(CommandInfo, " %u %u", lastoid, tuples);
|
|
|
|
break;
|
|
|
|
case CMD_DELETE:
|
|
|
|
case CMD_UPDATE:
|
|
|
|
sprintf(CommandInfo, " %u", tuples);
|
|
|
|
break;
|
|
|
|
default:
|
1999-01-27 01:36:28 +01:00
|
|
|
CommandInfo[0] = '\0';
|
|
|
|
break;
|
1997-09-07 07:04:48 +02:00
|
|
|
}
|
1996-07-09 08:22:35 +02:00
|
|
|
}
|