1XBSTREAM(1) Percona XtraBackup XBSTREAM(1)
2
3
4
6 xbstream - Percona xbstream Documentation
7
8 To support simultaneous compression and streaming, a new custom stream‐
9 ing format called xbstream was introduced to Percona XtraBackup in
10 addition to the TAR format. That was required to overcome some limita‐
11 tions of traditional archive formats such as tar, cpio and others which
12 did not allow streaming dynamically generated files, for example dynam‐
13 ically compressed files. Other advantages of xbstream over traditional
14 streaming/archive format include ability to stream multiple files con‐
15 currently (so it is possible to use streaming in the xbstream format
16 together with the --parallel option) and more compact data storage.
17
18 This utility has a tar-like interface:
19
20 · with the '-x' option it extracts files from the stream read from
21 its standard input to the current directory unless specified oth‐
22 erwise with the '-C' option.
23
24 · with the '-c' option it streams files specified on the command
25 line to its standard output.
26
27 The utility also tries to minimize its impact on the OS page cache by
28 using the appropriate posix_fadvise() calls when available.
29
30 When compression is enabled with xtrabackup all data is being com‐
31 pressed, including the transaction log file and meta data files, using
32 the specified compression algorithm. The only currently supported algo‐
33 rithm is 'quicklz'. The resulting files have the qpress archive format,
34 i.e. every *.qp file produced by xtrabackup is essentially a one-file
35 qpress archive and can be extracted and uncompressed by the qpress file
36 archiver. This means that there is no need to uncompress entire backup
37 to restore a single table as with tar.gz.
38
39 Files can be decompressed using the qpress tool that can be downloaded
40 from here. Qpress supports multi-threaded decompression.
41
43 Percona LLC and/or its affiliates
44
46 2009-2016, Percona LLC and/or its affiliates
47
48
49
50
512.3.5 Feb 13, 2019 XBSTREAM(1)