Documentation PostgreSQL 15.15 » Annexes » Modules supplémentaires fournis » basebackup_to_shell

Précédent | Niveau supérieur | Suivant
F.4. auto_explain | Sommaire | F.6. basic_archive

## F.5. basebackup_to_shell

`basebackup_to_shell` ajoute une méthode de sauvegarde personnalisée nommée `shell`. Elle permet de lancer `pg_basebackup --target=shell` ou, selon la configuration du module, `pg_basebackup --target=shell:`CHAINE_DETAILS``, ce qui provoquera l'exécution sur le serveur, pour chaque archive tar générée par la sauvegarde, d'une commande choisie par l'administrateur. La commande recevra le contenu de l'archive sur son entrée standard.

Ce module est d'abord un exemple de la manière de créer de nouvelles cibles de sauvegarde par un module d'extension ; mais, dans certains scénarios, il peut avoir son utilité propre. Pour fonctionner, ce module doit être chargé via shared_preload_libraries ou local_preload_libraries.

### F.5.1. Paramètres de configuration

`basebackup_to_shell.command` (`string`)

  La commande à exécuter par le serveur, pour chaque archive générée par le processus de sauvegarde. Si `%f` apparaît dans la chaîne de la commande, il sera remplacé par le nom de l'archive (par exemple `base.tar`). Si `%d` apparaît, il sera remplacé par la cible précisée par l'utilisateur. Une cible est requise si `%d` apparaît dans la chaîne, et interdite sinon. Pour des raisons de sécurité, elle ne peut contenir que des caractères alphanumériques. Si `%%` apparaît dans la chaîne, il sera remplacé par un seul `%`. Une erreur est levée si un `%` apparaît suivi d'un autre caractère que ceux ci-dessus, ou en bout de chaîne.

`basebackup_to_shell.required_role` (`string`)

  Le rôle nécessaire pour utiliser la cible `shell`. S'il n'est pas précisé, n'importe quel utilisateur de réplication peut utiliser cette cible de sauvegarde.

### F.5.2. Auteur

Robert Haas `<rhaas@postgresql.org>`