SPI_connect_ext — connecter une fonction C au gestionnaire SPI
int SPI_connect(void)
int SPI_connect_ext(int options)
SPI_connect ouvre une connexion au gestionnaire SPI
lors de l'appel d'une fonction C. Vous devez appeler cette fonction si vous
voulez lancer des commandes au travers du SPI. Certaines fonctions SPI
utilitaires peuvent être appelées à partir de fonctions C non connectées.
SPI_connect_ext fait la même chose mais dispose d'un argument
permettant de passer les options. Actuellement, les valeurs possibles des options
sont :
SPI_OPT_NONATOMIC
Configure la connexion SPI comme non atomique,
ce qui signifie que les appels de contrôle de transaction,
(SPI_commit, SPI_rollback)
sont autorisés. Dans le cas
contraire, un appel à ces fonctions renverra immédiatement une erreur.
SPI_connect() est équivalent à
SPI_connect_ext(0).
SPI_OK_CONNECTen cas de succès
Le fait que ces fonctions renvoient int et non pas
void est historique. Tous les échecs sont renvoyés via les
fonctions ereport et elog. (Dans
les versions précédant PostgreSQL v10, certains
échecs, mais pas tous, sont renvoyés avec une valeur résultat de
SPI_ERROR_CONNECT.)