PostgreSQLLa base de données la plus sophistiquée au monde.
Documentation PostgreSQL 15.9 » Programmation serveur » Modules d'archivage » Fonctions de support d'un module d'archivage

51.2. Fonctions de support d'un module d'archivage

Les fonctions de support d'archivage définissent le comportement d'archivage proprement dit du module. Le serveur les appellera suivant les besoins pour traiter chaque fichier segment WAL individuellement.

51.2.1. Fonction de vérification

La fonction de support check_configured_cb est appelée pour déterminer si le module est pleinement configuré et prêt à traiter des fichiers segment WAL (par exemple, si ses paramètres de configuration sont définis avec des valeurs valides). Si la fonction check_configured_cb n'est pas définie, le serveur présumera que le module est configuré.

typedef bool (*ArchiveCheckConfiguredCB) (void);

Si true est renvoyé, le serveur procédera à l'archivage en appelant la fonction archive_file_cb. Si false est renvoyé, l'archivage ne sera pas effectué, et l'archiver émettra le message suivant dans les traces du serveur :

WARNING:  archive_mode enabled, yet archiving is not configured

Dans ce dernier cas, le serveur appellera périodiquement cette fonction, et l'archivage ne sera effectué que lorsque le booléen true sera renvoyé.

51.2.2. Fonction d'archivage

La fonction archive_file_cb est appelée pour archiver un fichier segment WAL individuel.

typedef bool (*ArchiveFileCB) (const char *file, const char *path);

Si la valeur true est renvoyée, le serveur procédera comme si le fichier était archivé avec succès, ce qui peut inclure de recycler ou supprimer le fichier segment WAL original. Si la valeur false est renvoyée, le serveur conservera le fichier segment WAL original et réessayera de l'archiver plus tard. file contiendra juste le nom du fichier du segment WAL à archiver, alors que path contiendra le chemin complet du fichier segment WAL (nom du fichier inclus).

51.2.3. Fonction d'arrêt

La fonction shutdown_cb est appelée quand le processus archiver s'arrête (par exemple, après une erreur) ou si la valeur de archive_library change. Si la fonction shutdown_cb n'est pas définie, aucune action spécifique ne sera entreprise lors de ces situations.

typedef void (*ArchiveShutdownCB) (void);