Documentation PostgreSQL 8.1.23 > Programmation serveur > Interface de programmation serveur > Fonctions d'interface > SPI_execute_plan | |
SPI_is_cursor_plan | SPI_execp |
SPI_execute_plan — exécute un plan préparé par SPI_prepare
int SPI_execute_plan(void * plan, Datum * values, const char * nulls, bool read_only, long count)
SPI_execute_plan exécute un plan préparé par SPI_prepare. read_only et count ont la même interprétation que dans SPI_execute.
plan d'exécution (retourné par SPI_prepare)
Un tableau des vraies valeurs des paramètres. Doit avoir la même longueur que le nombre d'arguments du plan.
Un tableau décrivant les paramètres nuls. Doit avoir la même longueur que le nombre d'arguments du plan. n indique une valeur NULL (l'entrée correspondante dans values sera ignorée) ; un espace indique une valeur non NULL (l'entrée correspondante dans values est valide).
Si nulls est NULL, alors SPI_executeplan part du principe qu'aucun paramètre n'est nul.
true pour une exécution en lecture seule
nombre maximum de lignes à traiter ou à renvoyer
La valeur de retour est la même que pour SPI_execute avec les résultats d'erreurs (négatif) possibles :
si plan est NULL ou count est inférieur à 0
si values est NULL et plan est préparé avec des paramètres
SPI_processed et SPI_tuptable sont positionnés comme dans SPI_execute en cas de réussite.