From e92cb58ee9b18074263853b3e107efc70b443480 Mon Sep 17 00:00:00 2001 From: Mel Kiyama Date: Fri, 5 Jan 2018 15:30:10 -0800 Subject: [PATCH] docs: gpbackup update - metadata backed up into a single file, add incompatibility warning (#4257) PR for 5X_STABLE Will be ported to MAIN --- .../admin_guide/managing/backup-gpbackup.xml | 67 ++++++++++--------- 1 file changed, 36 insertions(+), 31 deletions(-) diff --git a/gpdb-doc/dita/admin_guide/managing/backup-gpbackup.xml b/gpdb-doc/dita/admin_guide/managing/backup-gpbackup.xml index 577a4263f9..a5cf73097a 100644 --- a/gpdb-doc/dita/admin_guide/managing/backup-gpbackup.xml +++ b/gpdb-doc/dita/admin_guide/managing/backup-gpbackup.xml @@ -6,11 +6,14 @@ gpbackup and gprestore are experimental utilities and are not intended for use in a production environment. Experimental features are subject to change without notice in future releases. + The utilities are experimental and might not be compatible between + releases. For example, backups from a previous release might be incompatible with the current + release utilities.

gpbackup and gprestore are new utilities that provide an improved way of creating and restoring backup sets for Greenplum Database. By default, gpbackup stores only the object metadata files and DDL files for a backup in the Greenplum Database master data directory. Greenplum Database segments use the - COPY .. ON SEGMENT command to store their data for backed-up tables in + COPY ... ON SEGMENT command to store their data for backed-up tables in compressed CSV data files, located in each segment's backups directory.

The backup metadata files contain all of the information that gprestore @@ -26,15 +29,15 @@ partitions.

Each gpbackup task uses a single transaction in Greenplum Database. During this transaction, metadata is backed up on the master host, and data for each table on each - segment host is written to CSV backup files using COPY .. ON SEGMENT commands - in parallel. The backup process acquires an ACCESS SHARE lock on each table - that is backed up.

+ segment host is written to CSV backup files using COPY ... ON SEGMENT + commands in parallel. The backup process acquires an ACCESS SHARE lock on + each table that is backed up.

Requirements and Limitations

You can use gpbackup and gprestore on Greenplum Database - systems that support the COPY .. ON SEGMENT command (Greenplum Database + systems that support the COPY ... ON SEGMENT command (Greenplum Database 5.1.0 and later, or 4.3.17.0 and later).

gpbackup and gprestore are experimental features in this release, and have the following limitations: