Table des matiĂšres
SPI_prepare
SPI_prepare
true
si la requĂȘte prĂ©parĂ©e par
SPI_prepare
peut ĂȘtre utilisĂ© avec
SPI_cursor_open
SPI_prepare
SPI_prepare
SPI_prepare
SPI_prepare
SPI_execute
ou une
fonction semblableL'interface de programmation serveur (SPI) donne aux auteurs de fonctions C la capacité de lancer des commandes SQL au sein de leurs fonctions ou procédures. SPI est une série de fonctions d'interface simplifiant l'accÚs à l'analyseur, au planificateur et au lanceur. SPI fait aussi de la gestion de mémoire.
Les langages procĂ©duraux disponibles donnent plusieurs moyens de lancer des commandes SQL Ă partir de fonctions. La plupart est basĂ©e Ă partir de SPI. Cette documentation prĂ©sente donc Ă©galement un intĂ©rĂȘt pour les utilisateurs de ces langages.
Notez que si une commande appelĂ©e via SPI Ă©choue, alors le contrĂŽle ne sera pas rendu Ă votre fonction C. Au contraire, la transaction ou sous-transaction dans laquelle est exĂ©cutĂ©e votre fonction C sera annulĂ©e. (Ceci pourrait ĂȘtre surprenant Ă©tant donnĂ© que les fonctions SPI ont pour la plupart des conventions documentĂ©es de renvoi d'erreur. Ces conventions s'appliquent seulement pour les erreurs dĂ©tectĂ©es Ă l'intĂ©rieur des fonctions SPI.) Il est possible de rĂ©cupĂ©rer le contrĂŽle aprĂšs une erreur en Ă©tablissant votre propre sous-transaction englobant les appels SPI qui pourraient Ă©chouer.
Les fonctions SPI renvoient un résultat positif en cas de
succĂšs (soit par une valeur de retour entiĂšre, soit dans la variable
globale SPI_result
comme décrit ci-dessous). En cas
d'erreur, un résultat négatif ou NULL
sera retourné.
Les fichiers de code source qui utilisent SPI doivent inclure le fichier
d'en-tĂȘte executor/spi.h
.