PostgreSQLLa base de données la plus sophistiquée au monde.

Documentation PostgreSQL 9.0.23 > Programmation serveur > Interface de programmation serveur > Fonctions d'interface > SPI_prepare_cursor
PrécédentSPI_prepare SPI_prepare_paramsSuivant

SPI_prepare_cursor

SPI_prepare_cursor — prépare un plan pour une commande, sans l'exécuter pour l'instant

Synopsis 

SPIPlanPtr SPI_prepare_cursor(const char * command, int nargs, Oid * argtypes, int cursorOptions)

Description

SPI_prepare_cursor est identique à SPI_prepare, sauf qu'il permet aussi la spécification du paramètre des « options du curseur » du planificateur. Il s'agit d'un champ de bits dont les valeurs sont indiquées dans nodes/parsenodes.h pour le champ options de DeclareCursorStmt. SPI_prepare utilise zéro pour les options du curseur.

Arguments

const char * command

chaîne commande

int nargs

nombre de paramètres en entrée ($1, $2, etc.)

Oid * argtypes

pointeur vers un tableau contenant l'OID des types de données des paramètres

int cursorOptions

champ de bits précisant les options du curseur ; zéro est le comportement par défaut

Valeur de retour

SPI_prepare_cursor a les mêmes conventions pour la valeur de retour que SPI_prepare.

Notes

Les bits utiles pour cursorOptions incluent CURSOR_OPT_SCROLL, CURSOR_OPT_NO_SCROLL et CURSOR_OPT_FAST_PLAN. Notez en particulier que CURSOR_OPT_HOLD est ignoré.