Scroll to navigation

MYDUMPER(1) mydumper MYDUMPER(1)

NAME

mydumper - multi-threaded MySQL dumping

SYNOPSIS

mydumper [OPTIONS]

DESCRIPTION

mydumper is a tool used for backing up MySQL database servers much faster than the mysqldump tool distributed with MySQL. It also has the capability to retrieve the binary logs from the remote server at the same time as the dump itself. The advantages of mydumper are:

  • Parallelism (hence, speed) and performance (avoids expensive character set conversion routines, efficient code overall)
  • Easier to manage output (separate files for tables, dump metadata, etc, easy to view/parse data)
  • Consistency - maintains snapshot across all threads, provides accurate master and slave log positions, etc
  • Manageability - supports PCRE for specifying database and tables inclusions and exclusions



OPTIONS

The mydumper tool has several available options:

Show help text

Use the given option file. If the file does not exist or is otherwise inaccessible, no failure occurs

Hostname of MySQL server to connect to (default localhost)

MySQL username with the correct privileges to execute the dump

The corresponding password for the MySQL user

The port for the MySQL connection.

NOTE:

For localhost TCP connections use 127.0.0.1 for --host.



The UNIX domain socket file to use for the connection

Database to dump

A comma separated list of tables to dump

The number of threads to use for dumping data, default is 4

NOTE:

Other threads are used in mydumper, this option does not control these



Output directory name, default is export-YYYYMMDD-HHMMSS

The maximum size for an insert statement before breaking into a new statement, default 1,000,000 bytes

Split table into chunks of this many rows, default unlimited

Compress the output files

Use client protocol compression for connections to the MySQL server

Create empty dump files if there is no data to dump

A regular expression to match against database and table

File containing a list of database.table entries to skip, one per line; the skipped entries have precedence over patterns specified by the regex option

Comma separated list of storage engines to ignore

Do not dump schemas with the data

Do not dump table data

Dump triggers

Dump events

Dump stored procedures and functions

Do not dump views

Timeout for long query execution in seconds, default 60

Kill long running queries instead of aborting the dump

Show the program version and exit

The verbosity of messages. 0 = silent, 1 = errors, 2 = warnings, 3 = info. Default is 2.

Get the binlogs from the server as well as the dump files (You need to compile with -DWITH_BINLOG=ON)

Enable daemon mode

Interval between each dump snapshot (in minutes), requires --daemon, default 60 (minutes)

A file to log mydumper output to instead of console output. Useful for daemon mode.

Do not execute the temporary shared read lock.

WARNING:

This will cause inconsistent backups.



Do not use Percona Backup Locks

--[skip-]tz-utc
SET TIME_ZONE=’+00:00’ at top of dump to allow dumping of TIMESTAMP data when a server has data in different time zones or data is being moved between servers with different time zones, defaults to on use –skip-tz-utc to disable.

Minimize locking time on InnoDB tables grabbing a LOCK TABLE … READ on all non-innodb tables.

Split tables into chunks of this output file size. This value is in MB

Not increment error count and Warning instead of Critical in case of table doesn’t exist

Use savepoints to reduce metadata locking issues, needs SUPER privilege

Use complete INSERT statements that include column names.

AUTHOR

Andrew Hutchings

COPYRIGHT

2024, Andrew Hutchings

March 10, 2024 0.10.0