Exporter un fichier DMP

Cette page explique comment utiliser l'outil pg_dump pour exporter une base de données AlloyDB vers un fichier DMP d'archive au format personnalisé que vous pourrez importer ultérieurement à l'aide de l'outil pg_restore.

La procédure d'exportation implique les tâches suivantes:

  1. Créez un bucket Cloud Storage pour stocker le fichier DMP.

  2. Préparez un hôte client pour effectuer l'opération d'exportation.

  3. Exportez la base de données vers le fichier DMP.

  4. Nettoyez les ressources créées pour effectuer la procédure.

Avant de commencer

  • Vous devez disposer du rôle IAM de base "Propriétaire" (roles/owner) ou "Éditeur" (roles/editor) dans le projet Google Cloud que vous utilisez, ou des rôles IAM prédéfinis suivants :
    • Administrateur AlloyDB (roles/alloydb.admin) ou Lecteur AlloyDB (roles/alloydb.viewer)
    • Administrateur de l'espace de stockage (roles/storage.admin)
    • Administrateur d'instances Compute (v1) (roles/compute.instanceAdmin.v1)

Créer un bucket Cloud Storage

Créez un bucket de stockage régional pour le stockage standard dans le projet et la région où se trouve votre base de données AlloyDB.

Préparer un hôte client

Pour préparer un hôte client à effectuer l'opération d'exportation, vous devez créer une VM Compute Engine pouvant se connecter à l'instance principale AlloyDB où se trouve votre base de données, puis installer l'outil pg_dump et la Google Cloud CLI sur cette VM.

  1. Suivez les instructions de la section Connecter un client psql à une instance pour créer une VM Compute Engine avec la connectivité appropriée et l'outil pg_dump installé. Lorsque vous suivez ces instructions, assurez-vous d'allouer suffisamment d'espace de stockage local à la VM Compute Engine pour accueillir le fichier DMP que vous allez créer.

  2. Installez gcloud CLI pour fournir un accès en ligne de commande afin de créer le fichier DMP dans le bucket Cloud Storage.

Exporter la base de données

Pour exporter la base de données vers un fichier DMP, vous devez obtenir l'adresse IP de l'instance principale AlloyDB où se trouve votre base de données, puis utiliser l'outil pg_dump.

  1. Obtenez l'adresse IP de l'instance principale AlloyDB où se trouve votre base de données en affichant ses détails.
  2. Connectez-vous en SSH à la VM Compute Engine.

    Console

    1. Dans la console Google Cloud, accédez à la page Instances de VM.

      Accéder à la page Instances de VM

    2. Dans la liste des instances de machine virtuelle, cliquez sur SSH sur la ligne de l'instance que vous avez créée.

      bouton SSH en regard du nom de l'instance.

    gcloud

    Utilisez la commande gcloud compute ssh pour vous connecter à l'instance que vous avez créée.

    gcloud compute ssh --project=PROJECT_ID --zone=ZONE VM_NAME

    Remplacez les éléments suivants :

    • PROJECT_ID: identifiant du projet contenant l'instance.
    • ZONE: nom de la zone dans laquelle se trouve l'instance.
    • VM_NAME : nom de l'instance
  3. Exportez la base de données vers un fichier DMP: 
    pg_dump -h IP_ADDRESS -U postgres -F custom \
  DB_NAME > DMP_FILE_NAME

    Vous êtes invité à saisir le mot de passe de l'utilisateur postgres.

    • IP_ADDRESS : adresse IP de l'instance principale.
    • -F custom: définit le format du fichier DMP sur une archive au format personnalisé que vous pourrez importer ultérieurement à l'aide de l'outil pg_restore.
    • DB_NAME: nom de la base de données que vous souhaitez exporter.
    • DMP_FILE_NAME: indiquez un nom de fichier pour le fichier DMP à créer sur le système de fichiers local de l'hôte client.

    L'exemple ci-dessus montre une commande pg_dump simple. Pour en savoir plus sur la large gamme d'options compatibles avec la commande, consultez la documentation PostgreSQL.

  4. Copiez le fichier DMP dans le bucket Cloud Storage que vous avez créé précédemment: 
    gcloud storage cp DMP_FILE_NAME gs://BUCKET_NAME

Effectuer un nettoyage des ressources

Une fois le fichier DMP exporté, vous pouvez supprimer la VM Compute Engine que vous avez utilisée lors de la procédure d'exportation.

Étape suivante