381 lines
22 KiB
Plaintext
381 lines
22 KiB
Plaintext
|
mariadb-dump Ver 10.19 Distrib 10.11.4-MariaDB, for debian-linux-gnu (x86_64)
|
|||
|
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.
|
|||
|
|
|||
|
Dumping structure and contents of MariaDB databases and tables.
|
|||
|
Usage: mariadb-dump [OPTIONS] database [tables]
|
|||
|
OR mariadb-dump [OPTIONS] --databases DB1 [DB2 DB3...]
|
|||
|
OR mariadb-dump [OPTIONS] --all-databases
|
|||
|
OR mariadb-dump [OPTIONS] --system=[SYSTEMOPTIONS]]
|
|||
|
|
|||
|
Default options are read from the following files in the given order:
|
|||
|
/etc/my.cnf /etc/mysql/my.cnf ~/.my.cnf
|
|||
|
The following groups are read: mysqldump mariadb-dump client client-server client-mariadb
|
|||
|
The following options may be given as the first argument:
|
|||
|
--print-defaults Print the program argument list and exit.
|
|||
|
--no-defaults Don't read default options from any option file.
|
|||
|
The following specify which files/extra groups are read (specified before remaining options):
|
|||
|
--defaults-file=# Only read default options from the given file #.
|
|||
|
--defaults-extra-file=# Read this file after the global files are read.
|
|||
|
--defaults-group-suffix=# Additionally read default groups with # appended as a suffix.
|
|||
|
|
|||
|
-A, --all-databases Dump all the databases. This will be same as --databases
|
|||
|
with all databases selected.
|
|||
|
-Y, --all-tablespaces
|
|||
|
Dump all the tablespaces.
|
|||
|
-y, --no-tablespaces
|
|||
|
Do not dump any tablespace information.
|
|||
|
--add-drop-database Add a DROP DATABASE before each create.
|
|||
|
--add-drop-table Add a DROP TABLE before each create.
|
|||
|
(Defaults to on; use --skip-add-drop-table to disable.)
|
|||
|
--add-drop-trigger Add a DROP TRIGGER before each create.
|
|||
|
--add-locks Add locks around INSERT statements.
|
|||
|
(Defaults to on; use --skip-add-locks to disable.)
|
|||
|
--allow-keywords Allow creation of column names that are keywords.
|
|||
|
--apply-slave-statements
|
|||
|
Adds 'STOP SLAVE' prior to 'CHANGE MASTER' and 'START
|
|||
|
SLAVE' to bottom of dump.
|
|||
|
--as-of=name Dump system versioned table(s) as of specified timestamp.
|
|||
|
Argument is interpreted according to the --tz-utc
|
|||
|
setting. Table structures are always dumped as of current
|
|||
|
timestamp.
|
|||
|
--character-sets-dir=name
|
|||
|
Directory for character set files.
|
|||
|
-i, --comments Write additional information.
|
|||
|
(Defaults to on; use --skip-comments to disable.)
|
|||
|
--compatible=name Change the dump to be compatible with a given mode. By
|
|||
|
default tables are dumped in a format optimized for
|
|||
|
MariaDB. Legal modes are: ansi, mysql323, mysql40,
|
|||
|
postgresql, oracle, mssql, db2, maxdb, no_key_options,
|
|||
|
no_table_options, no_field_options. One can use several
|
|||
|
modes separated by commas. Note: Requires MariaDB server
|
|||
|
version 4.1.0 or higher. This option is ignored with
|
|||
|
earlier server versions.
|
|||
|
--compact Give less verbose output (useful for debugging). Disables
|
|||
|
structure comments and header/footer constructs. Enables
|
|||
|
options --skip-add-drop-table --skip-add-locks
|
|||
|
--skip-comments --skip-disable-keys --skip-set-charset.
|
|||
|
-c, --complete-insert
|
|||
|
Use complete insert statements.
|
|||
|
-C, --compress Use compression in server/client protocol.
|
|||
|
--copy-s3-tables If 'no' S3 tables will be ignored, otherwise S3 tables
|
|||
|
will be copied as Aria tables and then altered to S3
|
|||
|
-a, --create-options
|
|||
|
Include all MariaDB specific create options.
|
|||
|
(Defaults to on; use --skip-create-options to disable.)
|
|||
|
-B, --databases Dump several databases. Note the difference in usage; in
|
|||
|
this case no tables are given. All name arguments are
|
|||
|
regarded as database names. 'USE db_name;' will be
|
|||
|
included in the output.
|
|||
|
-#, --debug[=#] This is a non-debug version. Catch this and exit.
|
|||
|
--debug-check Check memory and open file usage at exit.
|
|||
|
--debug-info Print some debug info at exit.
|
|||
|
--default-character-set=name
|
|||
|
Set the default character set.
|
|||
|
--delayed-insert Insert rows with INSERT DELAYED.
|
|||
|
--delete-master-logs
|
|||
|
Delete logs on master after backup. This automatically
|
|||
|
enables --master-data.
|
|||
|
-K, --disable-keys '/*!40000 ALTER TABLE tb_name DISABLE KEYS */; and
|
|||
|
'/*!40000 ALTER TABLE tb_name ENABLE KEYS */; will be put
|
|||
|
in the output.
|
|||
|
(Defaults to on; use --skip-disable-keys to disable.)
|
|||
|
--dump-date Put a dump date to the end of the output.
|
|||
|
(Defaults to on; use --skip-dump-date to disable.)
|
|||
|
-H, --dump-history Dump system-versioned tables with history (only for
|
|||
|
timestamp based versioning)
|
|||
|
--dump-slave[=#] This causes the binary log position and filename of the
|
|||
|
master to be appended to the dumped data output. Setting
|
|||
|
the value to 1, will printit as a CHANGE MASTER command
|
|||
|
in the dumped data output; if equal to 2, that command
|
|||
|
will be prefixed with a comment symbol. This option will
|
|||
|
turn --lock-all-tables on, unless --single-transaction is
|
|||
|
specified too (in which case a global read lock is only
|
|||
|
taken a short time at the beginning of the dump - don't
|
|||
|
forget to read about --single-transaction below). In all
|
|||
|
cases any action on logs will happen at the exact moment
|
|||
|
of the dump.Option automatically turns --lock-tables off.
|
|||
|
-E, --events Dump events.
|
|||
|
-e, --extended-insert
|
|||
|
Use multiple-row INSERT syntax that include several
|
|||
|
VALUES lists.
|
|||
|
(Defaults to on; use --skip-extended-insert to disable.)
|
|||
|
--fields-terminated-by=name
|
|||
|
Fields in the output file are terminated by the given
|
|||
|
string.
|
|||
|
--fields-enclosed-by=name
|
|||
|
Fields in the output file are enclosed by the given
|
|||
|
character.
|
|||
|
--fields-optionally-enclosed-by=name
|
|||
|
Fields in the output file are optionally enclosed by the
|
|||
|
given character.
|
|||
|
--fields-escaped-by=name
|
|||
|
Fields in the output file are escaped by the given
|
|||
|
character.
|
|||
|
-F, --flush-logs Flush logs file in server before starting dump. Note that
|
|||
|
if you dump many databases at once (using the option
|
|||
|
--databases= or --all-databases), the logs will be
|
|||
|
flushed for each database dumped. The exception is when
|
|||
|
using --lock-all-tables or --master-data: in this case
|
|||
|
the logs will be flushed only once, corresponding to the
|
|||
|
moment all tables are locked. So if you want your dump
|
|||
|
and the log flush to happen at the same exact moment you
|
|||
|
should use --lock-all-tables or --master-data with
|
|||
|
--flush-logs.
|
|||
|
--flush-privileges Emit a FLUSH PRIVILEGES statement after dumping the mysql
|
|||
|
database. This option should be used any time the dump
|
|||
|
contains the mysql database and any other database that
|
|||
|
depends on the data in the mysql database for proper
|
|||
|
restore.
|
|||
|
-f, --force Continue even if we get an SQL error.
|
|||
|
--gtid Used together with --master-data=1 or --dump-slave=1.When
|
|||
|
enabled, the output from those options will set the GTID
|
|||
|
position instead of the binlog file and offset; the
|
|||
|
file/offset will appear only as a comment. When disabled,
|
|||
|
the GTID position will still appear in the output, but
|
|||
|
only commented.
|
|||
|
--header Used together with --tab. When enabled, adds header with
|
|||
|
column names to the top of output txt files.
|
|||
|
-?, --help Display this help message and exit.
|
|||
|
--hex-blob Dump binary strings (BINARY, VARBINARY, BLOB) in
|
|||
|
hexadecimal format.
|
|||
|
-h, --host=name Connect to host.
|
|||
|
--ignore-database=name
|
|||
|
Do not dump the specified database. To specify more than
|
|||
|
one database to ignore, use the directive multiple times,
|
|||
|
once for each database. Only takes effect when used
|
|||
|
together with --all-databases|-A
|
|||
|
--ignore-table-data=name
|
|||
|
Do not dump the specified table data. To specify more
|
|||
|
than one table to ignore, use the directive multiple
|
|||
|
times, once for each table. Each table must be specified
|
|||
|
with both database and table names, e.g.,
|
|||
|
--ignore-table-data=database.table.
|
|||
|
--ignore-table=name Do not dump the specified table. To specify more than one
|
|||
|
table to ignore, use the directive multiple times, once
|
|||
|
for each table. Each table must be specified with both
|
|||
|
database and table names, e.g.,
|
|||
|
--ignore-table=database.table.
|
|||
|
--include-master-host-port
|
|||
|
Adds 'MASTER_HOST=<host>, MASTER_PORT=<port>' to 'CHANGE
|
|||
|
MASTER TO..' in dump produced with --dump-slave.
|
|||
|
--insert-ignore Insert rows with INSERT IGNORE.
|
|||
|
--lines-terminated-by=name
|
|||
|
Lines in the output file are terminated by the given
|
|||
|
string.
|
|||
|
-x, --lock-all-tables
|
|||
|
Locks all tables across all databases. This is achieved
|
|||
|
by taking a global read lock for the duration of the
|
|||
|
whole dump. Automatically turns --single-transaction and
|
|||
|
--lock-tables off.
|
|||
|
-l, --lock-tables Lock all tables for read.
|
|||
|
(Defaults to on; use --skip-lock-tables to disable.)
|
|||
|
--log-error=name Append warnings and errors to given file.
|
|||
|
--log-queries When restoring the dump, the server will, if logging
|
|||
|
turned on, log the queries to the general and slow query
|
|||
|
log.
|
|||
|
(Defaults to on; use --skip-log-queries to disable.)
|
|||
|
--master-data[=#] This causes the binary log position and filename to be
|
|||
|
appended to the output. If equal to 1, will print it as a
|
|||
|
CHANGE MASTER command; if equal to 2, that command will
|
|||
|
be prefixed with a comment symbol. This option will turn
|
|||
|
--lock-all-tables on, unless --single-transaction is
|
|||
|
specified too (on servers before MariaDB 5.3 this will
|
|||
|
still take a global read lock for a short time at the
|
|||
|
beginning of the dump; don't forget to read about
|
|||
|
--single-transaction below). In all cases, any action on
|
|||
|
logs will happen at the exact moment of the dump. Option
|
|||
|
automatically turns --lock-tables off.
|
|||
|
--max-allowed-packet=#
|
|||
|
The maximum packet length to send to or receive from
|
|||
|
server.
|
|||
|
--max-statement-time=#
|
|||
|
Max statement execution time. If unset, overrides server
|
|||
|
default with 0.
|
|||
|
--net-buffer-length=#
|
|||
|
The buffer size for TCP/IP and socket communication.
|
|||
|
--no-autocommit Wrap tables with autocommit/commit statements.
|
|||
|
-n, --no-create-db Suppress the CREATE DATABASE ... IF EXISTS statement that
|
|||
|
normally is output for each dumped database if
|
|||
|
--all-databases or --databases is given.
|
|||
|
-t, --no-create-info
|
|||
|
Don't write table creation info.
|
|||
|
-d, --no-data No row information.
|
|||
|
--no-data-med No row information for engines that Manage External Data
|
|||
|
(MRG_MyISAM, MRG_ISAM, CONNECT, OQGRAPH, SPIDER, VP,
|
|||
|
FEDERATED).
|
|||
|
(Defaults to on; use --skip-no-data-med to disable.)
|
|||
|
-N, --no-set-names Same as --skip-set-charset.
|
|||
|
--opt Same as --add-drop-table, --add-locks, --create-options,
|
|||
|
--quick, --extended-insert, --lock-tables, --set-charset,
|
|||
|
and --disable-keys. Enabled by default, disable with
|
|||
|
--skip-opt.
|
|||
|
--order-by-primary Sorts each table's rows by primary key, or first unique
|
|||
|
key, if such a key exists. Useful when dumping a MyISAM
|
|||
|
table to be loaded into an InnoDB table, but will make
|
|||
|
the dump itself take considerably longer.
|
|||
|
--order-by-size Dump tables in the order of their size, smaller first.
|
|||
|
Useful when using --single-transaction on tables which
|
|||
|
get truncated often. Dumping smaller tables first reduces
|
|||
|
chances of often truncated tables to get altered before
|
|||
|
being dumped.
|
|||
|
-p, --password[=name]
|
|||
|
Password to use when connecting to server. If password is
|
|||
|
not given it's solicited on the tty.
|
|||
|
-P, --port=# Port number to use for connection.
|
|||
|
--protocol=name The protocol to use for connection (tcp, socket, pipe).
|
|||
|
-q, --quick Don't buffer query, dump directly to stdout.
|
|||
|
(Defaults to on; use --skip-quick to disable.)
|
|||
|
-Q, --quote-names Quote table and column names with backticks (`).
|
|||
|
(Defaults to on; use --skip-quote-names to disable.)
|
|||
|
--replace Use REPLACE INTO instead of INSERT INTO.
|
|||
|
-r, --result-file=name
|
|||
|
Direct output to a given file. This option should be used
|
|||
|
in systems (e.g., DOS, Windows) that use carriage-return
|
|||
|
linefeed pairs (\r\n) to separate text lines. This option
|
|||
|
ensures that only a single newline is used.
|
|||
|
-R, --routines Dump stored routines (functions and procedures).
|
|||
|
--set-charset Add 'SET NAMES default_character_set' to the output.
|
|||
|
(Defaults to on; use --skip-set-charset to disable.)
|
|||
|
--single-transaction
|
|||
|
Creates a consistent snapshot by dumping all tables in a
|
|||
|
single transaction. Works ONLY for tables stored in
|
|||
|
storage engines which support multiversioning (currently
|
|||
|
only InnoDB does); the dump is NOT guaranteed to be
|
|||
|
consistent for other storage engines. While a
|
|||
|
--single-transaction dump is in process, to ensure a
|
|||
|
valid dump file (correct table contents and binary log
|
|||
|
position), no other connection should use the following
|
|||
|
statements: ALTER TABLE, DROP TABLE, RENAME TABLE,
|
|||
|
TRUNCATE TABLE, as consistent snapshot is not isolated
|
|||
|
from them. Option automatically turns off --lock-tables.
|
|||
|
--skip-opt Disable --opt. Disables --add-drop-table, --add-locks,
|
|||
|
--create-options, --quick, --extended-insert,
|
|||
|
--lock-tables, --set-charset, and --disable-keys.
|
|||
|
-S, --socket=name The socket file to use for connection.
|
|||
|
--ssl Enable SSL for connection (automatically enabled with
|
|||
|
other flags).
|
|||
|
(Defaults to on; use --skip-ssl to disable.)
|
|||
|
--ssl-ca=name CA file in PEM format (check OpenSSL docs, implies
|
|||
|
--ssl).
|
|||
|
--ssl-capath=name CA directory (check OpenSSL docs, implies --ssl).
|
|||
|
--ssl-cert=name X509 cert in PEM format (implies --ssl).
|
|||
|
--ssl-cipher=name SSL cipher to use (implies --ssl).
|
|||
|
--ssl-key=name X509 key in PEM format (implies --ssl).
|
|||
|
--ssl-crl=name Certificate revocation list (implies --ssl).
|
|||
|
--ssl-crlpath=name Certificate revocation list path (implies --ssl).
|
|||
|
--tls-version=name TLS protocol version for secure connection.
|
|||
|
--ssl-verify-server-cert
|
|||
|
Verify server's "Common Name" in its cert against
|
|||
|
hostname used when connecting. This option is disabled by
|
|||
|
default.
|
|||
|
--system=name Dump system tables as portable SQL. Any combination of:
|
|||
|
all, users, plugins, udfs, servers, stats, timezones
|
|||
|
-T, --tab=name Create tab-separated textfile for each table to given
|
|||
|
path. (Create .sql and .txt files.) NOTE: This only works
|
|||
|
if mysqldump is run on the same machine as the mysqld
|
|||
|
server.
|
|||
|
--tables Overrides option --databases (-B).
|
|||
|
--triggers Dump triggers for each dumped table.
|
|||
|
(Defaults to on; use --skip-triggers to disable.)
|
|||
|
--tz-utc Set connection time zone to UTC before commencing the
|
|||
|
dump and add SET TIME_ZONE=´+00:00´ to the top of the
|
|||
|
dump file.
|
|||
|
(Defaults to on; use --skip-tz-utc to disable.)
|
|||
|
-u, --user=name User for login if not current user.
|
|||
|
-v, --verbose Print info about the various stages.
|
|||
|
-V, --version Output version information and exit.
|
|||
|
-w, --where=name Dump only selected records. Quotes are mandatory.
|
|||
|
-X, --xml Dump a database as well formed XML.
|
|||
|
--plugin-dir=name Directory for client-side plugins.
|
|||
|
--default-auth=name Default authentication client-side plugin to use.
|
|||
|
|
|||
|
Variables (--variable-name=value)
|
|||
|
and boolean options {FALSE|TRUE} Value (after reading options)
|
|||
|
--------------------------------- ----------------------------------------
|
|||
|
all-databases FALSE
|
|||
|
all-tablespaces FALSE
|
|||
|
no-tablespaces FALSE
|
|||
|
add-drop-database FALSE
|
|||
|
add-drop-table TRUE
|
|||
|
add-drop-trigger FALSE
|
|||
|
add-locks TRUE
|
|||
|
allow-keywords FALSE
|
|||
|
apply-slave-statements FALSE
|
|||
|
as-of (No default value)
|
|||
|
character-sets-dir (No default value)
|
|||
|
comments TRUE
|
|||
|
compatible (No default value)
|
|||
|
compact FALSE
|
|||
|
complete-insert FALSE
|
|||
|
compress FALSE
|
|||
|
copy-s3-tables FALSE
|
|||
|
create-options TRUE
|
|||
|
databases FALSE
|
|||
|
debug-check FALSE
|
|||
|
debug-info FALSE
|
|||
|
default-character-set utf8mb4
|
|||
|
delayed-insert FALSE
|
|||
|
delete-master-logs FALSE
|
|||
|
disable-keys TRUE
|
|||
|
dump-date TRUE
|
|||
|
dump-history FALSE
|
|||
|
dump-slave 0
|
|||
|
events FALSE
|
|||
|
extended-insert TRUE
|
|||
|
fields-terminated-by (No default value)
|
|||
|
fields-enclosed-by (No default value)
|
|||
|
fields-optionally-enclosed-by (No default value)
|
|||
|
fields-escaped-by (No default value)
|
|||
|
flush-logs FALSE
|
|||
|
flush-privileges FALSE
|
|||
|
force FALSE
|
|||
|
gtid FALSE
|
|||
|
header FALSE
|
|||
|
hex-blob FALSE
|
|||
|
host (No default value)
|
|||
|
include-master-host-port FALSE
|
|||
|
insert-ignore FALSE
|
|||
|
lines-terminated-by (No default value)
|
|||
|
lock-all-tables FALSE
|
|||
|
lock-tables TRUE
|
|||
|
log-error (No default value)
|
|||
|
log-queries TRUE
|
|||
|
master-data 0
|
|||
|
max-allowed-packet 16777216
|
|||
|
max-statement-time 0
|
|||
|
net-buffer-length 1046528
|
|||
|
no-autocommit FALSE
|
|||
|
no-create-db FALSE
|
|||
|
no-create-info FALSE
|
|||
|
no-data FALSE
|
|||
|
no-data-med TRUE
|
|||
|
order-by-primary FALSE
|
|||
|
order-by-size FALSE
|
|||
|
port 0
|
|||
|
quick TRUE
|
|||
|
quote-names TRUE
|
|||
|
replace FALSE
|
|||
|
routines FALSE
|
|||
|
set-charset TRUE
|
|||
|
single-transaction FALSE
|
|||
|
socket /run/mysqld/mysqld.sock
|
|||
|
ssl TRUE
|
|||
|
ssl-ca (No default value)
|
|||
|
ssl-capath (No default value)
|
|||
|
ssl-cert (No default value)
|
|||
|
ssl-cipher (No default value)
|
|||
|
ssl-key (No default value)
|
|||
|
ssl-crl (No default value)
|
|||
|
ssl-crlpath (No default value)
|
|||
|
tls-version (No default value)
|
|||
|
ssl-verify-server-cert FALSE
|
|||
|
system
|
|||
|
tab (No default value)
|
|||
|
triggers TRUE
|
|||
|
tz-utc TRUE
|
|||
|
user (No default value)
|
|||
|
verbose FALSE
|
|||
|
where (No default value)
|
|||
|
plugin-dir (No default value)
|
|||
|
default-auth (No default value)
|