All Products
Search
Document Center

Database Backup:Back up a PostgreSQL database by using logical backup

Last Updated:Jul 19, 2024

Database Backup (DBS) provides features such as single-table restoration, geo-redundancy, and long-term archiving for PostgreSQL databases. This topic describes how to back up a database in an ApsaraDB RDS for PostgreSQL instance, a database in a PolarDB for PostgreSQL cluster, or a database whose data source type is PostgreSQL by using logical backup.

Usage notes

  • Each DBS backup schedule can be used to back up only one PostgreSQL database by using logical backup. The PostgreSQL database can be a database in an ApsaraDB RDS for PostgreSQL instance, a database in a PolarDB for PostgreSQL cluster, or a database whose data source type is PostgreSQL. If you want to back up multiple PostgreSQL databases, you must purchase a DBS backup schedule for each database.

  • DBS does not support incremental backup for PostgreSQL databases.

Create a backup schedule

For more information, see Create a backup schedule.

Note
  • When you purchase a backup schedule, set the Data Source Type parameter to PostgreSQL and the Backup Method parameter to Logical Backup.

  • For information about the PostgreSQL versions that are supported by DBS logical backup, see Database engines and features.

Configure a backup schedule

  1. Log on to the Database Backup (DBS) console.

  2. In the left-side navigation pane, click Backup Schedules. In the top navigation bar, select a region.

  3. On the Backup Schedules page, find the ID of the backup schedule that you want to configure and click Configure Backup Schedule in the Actions column.

    image.png

  4. In the Configure Backup Source and Destination step of the Configure Backup Schedule wizard, configure the backup source and destination, and click Next in the lower-right corner of the page.

    image

    Table 1. Parameters

    Section

    Parameter

    Description

    N/A

    Schedule Name

    The name of the backup schedule. DBS automatically generates a backup schedule name. We recommend that you enter a descriptive name that is easy to identify. Backup schedule names do not need to be unique.

    Backup Source Information

    Backup Mode

    The method that is used to back up data. By default, the backup method that you selected when you purchased the backup schedule is used. In this example, Logical Backup is used.

    Database Location

    The location of the database instance that you want to back up. Valid values:

    Instance Region

    The region in which the source database instance resides.

    This parameter is displayed only if you set the Database Location parameter to RDS Instance, PolarDB, ECS-Hosted Database, or No public network IP: Port's self-built database (accessed through the database gateway).

    Database Type

    The type of the database that you want to back up. Default value: PostgreSQL or PolarDB for PostgreSQL.

    Database Name

    The name of the database that you want to back up.

    Important

    Each DBS backup schedule can be used to back up only one PostgreSQL database by using logical backup. If you want to back up multiple PostgreSQL databases, you must purchase a DBS backup schedule for each database.

    Database Account

    The username of the account that is used to connect to the database that you want to back up. The account must have permissions to back up the database. For more information, see Account permissions.

    Note

    For ApsaraDB RDS databases, read-only permissions are required for backup, and read and write permissions are required for backup and restoration.

    Password

    The password of the account that is used to connect to the database that you want to back up.

    After you enter the username and password of the database account, click Test Connection next to the password to check whether the information about the database that you want to back up is valid. If the specified parameters are valid, the Test Passed message is displayed. If the Test Failed message is displayed, click Check next to Test Failed. Modify the information about the database that you want to back up based on the check results.

    SSL Encryption

    The connection method that is used to transmit the backup data. This parameter is required if you want to back up a database in the ApsaraDB RDS for PostgreSQL instance. Valid values:

    • Non-encrypted

    • SSL-encrypted: SSL encrypts network connections at the transport layer to improve the security and integrity of data in transit. However, SSL increases the network connection response time.

      Note

      If you want to select SSL-encrypted, you must enable SSL encryption for the ApsaraDB RDS instance before you configure the backup schedule. For more information, see SSL encryption.

    Compliance warranty regarding cross-border data transfers

    Read the statement of compliance and select I have read and agree to the preceding compliance commitment.

    Backup Destination Information

    Backup Storage Type

    The type of storage that is used to store the backup data. Valid values:

    • DBS Storage (recommended): Backup data is stored in DBS without the need to create an Object Storage Service (OSS) bucket. You are charged based on the volume of your data that is stored in DBS. For more information about the billing method, see Storage fees.

    • OSS For User: You must create a bucket in the OSS console in advance. For more information, see Create buckets.

    Note
    • In this example, DBS Storage (recommended) is selected. If you select OSS For User, you must configure the OSS Bucket Name parameter. Only the Standard storage class is supported.

    • If the volume of data to be backed up is large, we recommend that you purchase subscription storage plans to offset fees. For more information, see Use storage plans. Storage plans are more cost-efficient than the pay-as-you-go billing method.

    Storage Encryption

    The method that is used to encrypt the stored data. Valid values:

    • Encrypted: recommended. DBS uses AES-256 to encrypt data.

      The server-side encryption feature is used in OSS. When you upload an object to OSS, OSS encrypts and stores the object. When you download the encrypted object from OSS, OSS decrypts the object and returns the decrypted object to you. For more information, see Server-side encryption.

    • Non-encrypted: The backup data is not encrypted.

  5. In the Edit Backup Objects step, find the database or table that you want to back up and add it to the Selected section. Then, click Next.

    Note
    • If you selected Logical Backup when you purchased a backup schedule, DBS allows you to use the backup schedule to back up the entire database or a single table in the database during full backups. You can click Select All in the lower-left corner of the page to back up the entire database. For more information about the granularity of logical backup, see Database engines and features.

    • If you selected Physical Backup when you purchased a backup schedule, you can use the backup schedule only to back up the entire database.

  6. In the Configure Backup Time step, configure the parameters that are described in the following table and click Next in the lower-right corner of the page.

    Parameter

    Description

    Full-scale Backup Frequency

    The frequency of the backup schedule. Valid values: Periodic Backup and Single Backup.

    Note

    If you select Periodic Backup, you must configure the Full Data Backup Recurrence and Start At parameters.

    Full Data Backup Recurrence

    The days of the week on which DBS runs the backup schedule. You can select one or more days of a week. Select at least one day of the week.

    Start At

    The start time of the backup. We recommend that you set a point in time within off-peak hours. Example: 01:00.

    Note

    If a previous full data backup is not finished at the start time of the next backup, DBS skips the next backup.

    Incremental Backup

    DBS does not support incremental backup for PostgreSQL databases.

    Maximum Concurrent Threads for Full Data Backup

    The maximum number of concurrent threads available for a full backup. You can set this parameter to adjust the backup speed. For example, you can reduce the number of backup threads to minimize impacts on the database.

    The maximum number of actual concurrent threads varies based on backup schedule specifications. For more information, see How do I change the maximum backup speed?

  7. In the Edit Lifecycle step, configure the lifecycle for a full data backup in the Configure Full Data Backup Lifecycle section.

  8. After the configurations are complete, click Precheck in the lower-right corner of the page.

  9. If the Precheck Passed message appears, click Start Task.

    Note
    • If the state of the backup schedule changes to Running, the backup schedule takes effect.

    • If an exception or error occurs when you start the backup schedule, troubleshoot the exception or error at the earliest opportunity. For more information, see How do I fix errors for an abnormal backup schedule in DBS? If your issue persists after you use the solution that is provided in the preceding topic, contact technical support in the DBS DingTalk group (ID: 35585947).

References

  • After a database is backed up, you can view the backup schedule or restore the database. For more information, see View a backup schedule and Restore a PostgreSQL database.

  • You can also call an API operation to create a backup schedule, or to create, configure, and then start a backup schedule. For more information, see CreateBackupPlan or CreateAndStartBackupPlan.

  • For more information about how to modify the backup source, backup objects, or backup policy such as the backup time and backup set retention time of a backup schedule, see Manage a backup plan.

  • For more information about fees that may be subsequently incurred by a backup schedule, see Billing FAQ.

  • You can pause a backup schedule that you do not need to reduce costs. For more information, see Pause or start a backup schedule.