← Back to branch summary

~ubuntu-branches/ubuntu/wily/mysql-5.6/wily

« back to all changes in this revision

Viewing changes to man/mysqldump.1

  • Committer: Package Import Robot
  • Author(s): Marc Deslauriers
  • Date: 2015-04-16 20:07:10 UTC
  • mto: (1.3.9 vivid-proposed)
  • mto: This revision was merged to the branch mainline in revision 11.
  • Revision ID: package-import@ubuntu.com-20150416200710-pcrsa022082zj46k
Tags: upstream-5.6.24
Import upstream version 5.6.24

Show diffs side-by-side

added added

removed removed

Lines of Context:
man/mysqldump.1
2
2
.\"     Title: \fBmysqldump\fR
3
3
.\"    Author: [FIXME: author] [see http://docbook.sf.net/el/author]
4
4
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
5
 
.\"      Date: 01/16/2015
 
5
.\"      Date: 03/25/2015
6
6
.\"    Manual: MySQL Database System
7
7
.\"    Source: MySQL 5.6
8
8
.\"  Language: English
9
9
.\"
10
 
.TH "\FBMYSQLDUMP\FR" "1" "01/16/2015" "MySQL 5\&.6" "MySQL Database System"
 
10
.TH "\FBMYSQLDUMP\FR" "1" "03/25/2015" "MySQL 5\&.6" "MySQL Database System"
11
11
.\" -----------------------------------------------------------------
12
12
.\" * Define some portability stuff
13
13
.\" -----------------------------------------------------------------
69
69
statements that change the database collation\&. These may be used when dumping stored programs to preserve their character encodings\&. To reload a dump file containing such statements, the
70
70
ALTER
71
71
privilege for the affected database is required\&.
 
72
.if n \{\
 
73
.sp
 
74
.\}
 
75
.RS 4
 
76
.it 1 an-trap
 
77
.nr an-no-space-flag 1
 
78
.nr an-break-flag 1
 
79
.br
 
80
.ps +1
 
81
\fBNote\fR
 
82
.ps -1
 
83
.br
 
84
.PP
 
85
A dump made using PowerShell on Windows with output redirection creates a file that has UTF\-16 encoding:
 
86
.sp
 
87
.if n \{\
 
88
.RS 4
 
89
.\}
 
90
.nf
 
91
mysqldump [options] > dump\&.sql
 
92
.fi
 
93
.if n \{\
 
94
.RE
 
95
.\}
 
96
.PP
 
97
However, UTF\-16 is not permitted as a connection character set (see
 
98
Section\ \&10.1.4, \(lqConnection Character Sets and Collations\(rq), so the dump file will not load correctly\&. To work around this issue, use the
 
99
\fB\-\-result\-file\fR
 
100
option, which creates the output in ASCII format:
 
101
.sp
 
102
.if n \{\
 
103
.RS 4
 
104
.\}
 
105
.nf
 
106
mysqldump [options] \-\-result\-file=dump\&.sql
 
107
.fi
 
108
.if n \{\
 
109
.RE
 
110
.\}
 
111
.sp .5v
 
112
.RE
72
113
Performance and Scalability Considerations.PP
73
114
mysqldump
74
115
advantages include the convenience and flexibility of viewing or even editing the output before restoring\&. You can clone databases for development and DBA work, or produce slight variations of an existing database for testing\&. It is not intended as a fast or scalable solution for backing up substantial amounts of data\&. With large data sizes, even if the backup step takes a reasonable time, restoring the data can be very slow because replaying the SQL statements involves disk I/O for insertion, index creation, and so on\&.
98
139
backups with minimal disruption; it can also back up tables from
99
140
MyISAM
100
141
and other storage engines; and it provides a number of convenient options to accommodate different backup scenarios\&. See
101
 
Section\ \&25.2, \(lqMySQL Enterprise Backup\(rq\&.
 
142
Section\ \&25.2, \(lqMySQL Enterprise Backup Overview\(rq\&.
102
143
.RE
103
144
.sp
104
145
.RS 4
228
269
.\" default-auth option: mysqldump
229
270
\fB\-\-default\-auth=\fR\fB\fIplugin\fR\fR
230
271
.sp
231
 
The client\-side authentication plugin to use\&. See
 
272
A hint about the client\-side authentication plugin to use\&. See
232
273
Section\ \&6.3.7, \(lqPluggable Authentication\(rq\&.
233
274
.RE
234
275
.sp
1786
1827
\fB\-\-events\fR,
1787
1828
\fB\-E\fR
1788
1829
.sp
1789
 
Include Event Scheduler events for the dumped databases in the output\&.
 
1830
Include Event Scheduler events for the dumped databases in the output\&. This option requires the
 
1831
EVENT
 
1832
privileges for those databases\&.
1790
1833
.RE
1791
1834
.sp
1792
1835
.RS 4