Restore the data of an ApsaraDB RDS for PostgreSQL instance to a self-managed PostgreSQL instance by using backup files - ApsaraDB RDS

Pour extraire des données d'ApsaraDB RDS for PostgreSQL, par exemple afin de mettre hors service une instance, d'archiver des données ou de synchroniser un environnement de développement, téléchargez une sauvegarde instantanée (snapshot) au format CSV ou SQL. Restaurez-la ensuite sur une instance PostgreSQL auto-gérée à l'aide du script Python fourni.

Choisir une méthode de restauration

Vérifiez que cette méthode correspond à votre situation avant de commencer :

Méthode	Idéale pour	Guide
Fichier CSV ou SQL (ce guide)	Restauration complète d'un snapshot depuis une instance sur disque cloud	Cette page
Sauvegarde logique avec pg_restore	Restauration partielle, comme celle d'une seule table	Restaurer des données à partir d'un fichier de sauvegarde logique
Data Transmission Service (DTS)	Réduction des interventions manuelles et synchronisation continue	Migrer des données depuis une base de données PostgreSQL

Pour obtenir une vue d'ensemble de toutes les options de restauration, consultez la rubrique Présentation des méthodes de restauration des données.

Prérequis

Avant de commencer, assurez-vous que :

Votre instance RDS utilise des disques cloud. Cette méthode s'applique uniquement aux instances sur disque cloud.
Python 3 est installé sur la machine cible :
```
python3 --version
```
L'instance PostgreSQL auto-gérée cible ne contient aucune base de données portant le même nom que celle que vous importez. Si tel est le cas, l'importation échouera. Supprimez ou renommez la base de données conflictuelle avant de poursuivre.

Les étapes ci-dessous prennent pour exemple un environnement CentOS 7.8 64 bits. Si votre système d'exploitation diffère, adaptez les commandes en conséquence.

Restaurer les données à partir d'un fichier de sauvegarde

Connectez-vous à la console ApsaraDB RDS et téléchargez le fichier de sauvegarde de votre instance au format CSV ou SQL. Pour plus d'instructions, consultez la rubrique Télécharger des fichiers de sauvegarde.
Décompressez le package téléchargé :
```
tar -zxvf <package-name>.tar.gz -C <target-directory>
```
Par exemple, pour décompresser backup.tar.gz dans le répertoire /home/ecs-test-user :
```
tar -zxvf backup.tar.gz -C /home/ecs-test-user
```
(Facultatif) Vérifiez que les fichiers ont bien été extraits dans le répertoire cible :
```
ls -al /home/ecs-test-user
```
Téléchargez le script Python PostgreSQL (restore_from_downloads.py) sur la même machine.
Accordez les permissions d'exécution au script :
```
chmod +x ./restore_from_downloads.py
```

Exécutez le script pour restaurer les données sur l'instance PostgreSQL auto-gérée :

Paramètre	Description	Exemple
`<data-directory>`	Répertoire contenant les fichiers CSV ou SQL extraits	`/home/ecs-test-user`
`<host>`	Adresse hôte de l'instance PostgreSQL auto-gérée	`127.0.0.1`
`<port>`	Numéro de port	`5432`
`<username>`	Nom d'utilisateur du compte de base de données. Si le nom d'utilisateur contient des caractères spéciaux tels que `#` ou des espaces, encadrez-le de guillemets doubles (`"`).	`postgres`
`<password>`	Mot de passe du compte de base de données. Si le mot de passe contient des caractères spéciaux tels que `#` ou des espaces, encadrez-le de guillemets doubles (`"`).	`"#Tes********"`

python3 restore_from_downloads.py <data-directory> <host> <port> <username> <password>

Exemple :

python3 restore_from_downloads.py /home/ecs-test-user 127.0.0.1 5432 postgres "#Tes********"