<div id="docs-body">
 <div class="section">
  <div class="titlepage">
   <div>
    <div>
     <h3 class="title">
      <a name="mysqldump">
      </a>
      6.5.4 mysqldump — A Database Backup Program
     </h3>
    </div>
   </div>
  </div>
  <a class="indexterm" name="idm46045314765984">
  </a>
  <a class="indexterm" name="idm46045314765072">
  </a>
  <a class="indexterm" name="idm46045314763712">
  </a>
  <a class="indexterm" name="idm46045314762352">
  </a>
  <a class="indexterm" name="idm46045314760992">
  </a>
  <p>
   The
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   client utility performs
   <a class="link" href="glossary.html#glos_logical_backup" title="logical backup">
    logical backups
   </a>
   ,
        producing a set of SQL statements that can be executed to
        reproduce the original database object definitions and table
        data. It dumps one or more MySQL databases for backup or
        transfer to another SQL server. The
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   command can also generate output in CSV, other delimited text,
        or XML format.
  </p>
  <div class="tip" style="margin-left: 0.5in; margin-right: 0.5in;">
   <div class="admon-title">
    Tip
   </div>
   <p>
    Consider using the
    <a class="ulink" href="/doc/mysql-shell/8.4/en/mysql-shell-utilities-dump-instance-schema.html" target="_top">
     MySQL Shell dump utilities
    </a>
    , which provide parallel dumping with multiple threads, file compression, and progress information display, as well as cloud features such as Oracle Cloud Infrastructure Object Storage streaming, and MySQL HeatWave Service compatibility checks and modifications. Dumps can be easily imported into a MySQL Server instance or a MySQL HeatWave Service DB System using the
    <a class="ulink" href="/doc/mysql-shell/8.4/en/mysql-shell-utilities-load-dump.html" target="_top">
     MySQL Shell load dump utilities
    </a>
    . Installation instructions for MySQL Shell can be found
    <a class="ulink" href="/doc/mysql-shell/8.4/en/mysql-shell-install.html" target="_top">
     here
    </a>
    .
   </p>
  </div>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-performance" title="Performance and Scalability Considerations">
       Performance and Scalability Considerations
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-syntax" title="Invocation Syntax">
       Invocation Syntax
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-option-summary" title="Option Syntax - Alphabetical Summary">
       Option Syntax - Alphabetical Summary
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-connection-options" title="Connection Options">
       Connection Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-option-file-options" title="Option-File Options">
       Option-File Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-ddl-options" title="DDL Options">
       DDL Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-debug-options" title="Debug Options">
       Debug Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-help-options" title="Help Options">
       Help Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-i18n-options" title="Internationalization Options">
       Internationalization Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-replication-options" title="Replication Options">
       Replication Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-format-options" title="Format Options">
       Format Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-filter-options" title="Filtering Options">
       Filtering Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-performance-options" title="Performance Options">
       Performance Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-transaction-options" title="Transactional Options">
       Transactional Options
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-option-groups" title="Option Groups">
       Option Groups
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-option-examples" title="Examples">
       Examples
      </a>
     </p>
    </li>
    <li class="listitem">
     <p>
      <a class="xref" href="mysqldump.html#mysqldump-restrictions" title="Restrictions">
       Restrictions
      </a>
     </p>
    </li>
   </ul>
  </div>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   requires at least the
   <a class="link" href="privileges-provided.html#priv_select">
    <code class="literal">
     SELECT
    </code>
   </a>
   privilege for dumped
        tables,
   <a class="link" href="privileges-provided.html#priv_show-view">
    <code class="literal">
     SHOW VIEW
    </code>
   </a>
   for dumped
        views,
   <a class="link" href="privileges-provided.html#priv_trigger">
    <code class="literal">
     TRIGGER
    </code>
   </a>
   for dumped
        triggers,
   <a class="link" href="privileges-provided.html#priv_lock-tables">
    <code class="literal">
     LOCK TABLES
    </code>
   </a>
   if the
   <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
    <code class="option">
     --single-transaction
    </code>
   </a>
   option is
        not used,
   <a class="link" href="privileges-provided.html#priv_process">
    <code class="literal">
     PROCESS
    </code>
   </a>
   if the
   <a class="link" href="mysqldump.html#option_mysqldump_no-tablespaces">
    <code class="option">
     --no-tablespaces
    </code>
   </a>
   option is not used, and the
   <a class="link" href="privileges-provided.html#priv_reload">
    <code class="literal">
     RELOAD
    </code>
   </a>
   or
   <a class="link" href="privileges-provided.html#priv_flush-tables">
    <code class="literal">
     FLUSH_TABLES
    </code>
   </a>
   privilege with
   <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
    <code class="option">
     --single-transaction
    </code>
   </a>
   if both
   <a class="link" href="replication-options-gtids.html#sysvar_gtid_mode">
    <code class="literal">
     gtid_mode=ON
    </code>
   </a>
   and
   <a class="link" href="replication-options-gtids.html#sysvar_gtid_purged">
    <code class="literal">
     gtid_purged=ON|AUTO
    </code>
   </a>
   .
        Certain options might require other privileges as noted in the
        option descriptions.
  </p>
  <p>
   To reload a dump file, you must have the privileges required to
        execute the statements that it contains, such as the appropriate
   <code class="literal">
    CREATE
   </code>
   privileges for objects created by
        those statements.
  </p>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   output can include
   <a class="link" href="alter-database.html" title="15.1.2 ALTER DATABASE Statement">
    <code class="literal">
     ALTER DATABASE
    </code>
   </a>
   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
   <code class="literal">
    ALTER
   </code>
   privilege for the affected database is
        required.
  </p>
  <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
   <div class="admon-title">
    Note
   </div>
   <p>
    A dump made using PowerShell on Windows with output
          redirection creates a file that has UTF-16 encoding:
   </p>
   <div class="copytoclipboard-wrapper">
    <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa57488097"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token punctuation">[</span>options<span class="token punctuation">]</span> &gt; dump<span class="token punctuation">.</span>sql</code></pre>
   </div>
   <p>
    However, UTF-16 is not permitted as a connection character set
          (see
    <a class="xref" href="charset-connection.html#charset-connection-impermissible-client-charset" title="Impermissible Client Character Sets">
     Impermissible Client Character Sets
    </a>
    ),
          so the dump file cannot be loaded correctly. To work around
          this issue, use the
    <code class="option">
     --result-file
    </code>
    option,
          which creates the output in ASCII format:
   </p>
   <div class="copytoclipboard-wrapper">
    <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa20903536"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token punctuation">[</span>options<span class="token punctuation">]</span> <span class="token constant">--result-file</span><span class="token attr-value"><span class="token punctuation">=</span>dump.sql</span></code></pre>
   </div>
  </div>
  <p>
   It is not recommended to load a dump file when GTIDs are enabled
        on the server (
   <a class="link" href="replication-options-gtids.html#sysvar_gtid_mode">
    <code class="literal">
     gtid_mode=ON
    </code>
   </a>
   ),
        if your dump file includes system tables.
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   issues DML instructions for the
        system tables which use the non-transactional MyISAM storage
        engine, and this combination is not permitted when GTIDs are
        enabled.
  </p>
  <h4>
   <a name="mysqldump-performance">
   </a>
   Performance and Scalability Considerations
  </h4>
  <p>
   <code class="literal">
    mysqldump
   </code>
   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.
  </p>
  <p>
   For large-scale backup and restore, a
   <a class="link" href="glossary.html#glos_physical" title="physical">
    physical
   </a>
   backup is more
        appropriate, to copy the data files in their original format so
        that they can be restored quickly.
  </p>
  <p>
   If your tables are primarily
   <a class="link" href="innodb-storage-engine.html" title="Chapter 17 The InnoDB Storage Engine">
    <code class="literal">
     InnoDB
    </code>
   </a>
   tables, or if you have a mix of
   <code class="literal">
    InnoDB
   </code>
   and
   <a class="link" href="myisam-storage-engine.html" title="18.2 The MyISAM Storage Engine">
    <code class="literal">
     MyISAM
    </code>
   </a>
   tables, consider using
   <span class="command">
    <strong>
     mysqlbackup
    </strong>
   </span>
   , which is available as part of
        MySQL Enterprise. This tool provides high performance for
   <code class="literal">
    InnoDB
   </code>
   backups with minimal disruption; it
        can also back up tables from
   <code class="literal">
    MyISAM
   </code>
   and other
        storage engines; it also provides a number of convenient options
        to accommodate different backup scenarios. See
   <a class="xref" href="mysql-enterprise-backup.html" title="32.1 MySQL Enterprise Backup Overview">
    Section 32.1, “MySQL Enterprise Backup Overview”
   </a>
   .
  </p>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   can retrieve and dump table
        contents row by row, or it can retrieve the entire content from
        a table and buffer it in memory before dumping it. Buffering in
        memory can be a problem if you are dumping large tables. To dump
        tables row by row, use the
   <a class="link" href="mysqldump.html#option_mysqldump_quick">
    <code class="option">
     --quick
    </code>
   </a>
   option (or
   <a class="link" href="mysqldump.html#option_mysqldump_opt">
    <code class="option">
     --opt
    </code>
   </a>
   , which enables
   <a class="link" href="mysqldump.html#option_mysqldump_quick">
    <code class="option">
     --quick
    </code>
   </a>
   ). The
   <a class="link" href="mysqldump.html#option_mysqldump_opt">
    <code class="option">
     --opt
    </code>
   </a>
   option (and hence
   <a class="link" href="mysqldump.html#option_mysqldump_quick">
    <code class="option">
     --quick
    </code>
   </a>
   ) is enabled by
        default, so to enable memory buffering, use
   <a class="link" href="mysqldump.html#option_mysqldump_quick">
    <code class="option">
     --skip-quick
    </code>
   </a>
   .
  </p>
  <p>
   If you are using a recent version of
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   to generate a dump to be reloaded
        into a very old MySQL server, use the
   <a class="link" href="mysqldump.html#option_mysqldump_skip-opt">
    <code class="option">
     --skip-opt
    </code>
   </a>
   option instead of
        the
   <a class="link" href="mysqldump.html#option_mysqldump_opt">
    <code class="option">
     --opt
    </code>
   </a>
   or
   <a class="link" href="mysqldump.html#option_mysqldump_extended-insert">
    <code class="option">
     --extended-insert
    </code>
   </a>
   option.
  </p>
  <p>
   For additional information about
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   ,
        see
   <a class="xref" href="using-mysqldump.html" title="9.4 Using mysqldump for Backups">
    Section 9.4, “Using mysqldump for Backups”
   </a>
   .
  </p>
  <h4>
   <a name="mysqldump-syntax">
   </a>
   Invocation Syntax
  </h4>
  <p>
   There are in general three ways to use
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   —in order to dump a set of one
        or more tables, a set of one or more complete databases, or an
        entire MySQL server—as shown here:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting language-terminal"><div class="docs-select-all right" id="sa83684617"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token punctuation">[</span><em class="replaceable">options</em><span class="token punctuation">]</span> <em class="replaceable">db_name</em> <span class="token punctuation">[</span><em class="replaceable">tbl_name</em> <span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">]</span>
mysqldump <span class="token punctuation">[</span><em class="replaceable">options</em><span class="token punctuation">]</span> <span class="token property">--databases</span> <em class="replaceable">db_name</em> <span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span>
mysqldump <span class="token punctuation">[</span><em class="replaceable">options</em><span class="token punctuation">]</span> <span class="token property">--all-databases</span></code></pre>
  </div>
  <p>
   To dump entire databases, do not name any tables following
   <em class="replaceable">
    <code>
     db_name
    </code>
   </em>
   , or use the
   <a class="link" href="mysqldump.html#option_mysqldump_databases">
    <code class="option">
     --databases
    </code>
   </a>
   or
   <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
    <code class="option">
     --all-databases
    </code>
   </a>
   option.
  </p>
  <p>
   To see a list of the options your version of
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   supports, issue the command
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   <a class="link" href="mysqldump.html#option_mysqldump_help">
    <code class="option">
     --help
    </code>
   </a>
   .
  </p>
  <h4>
   <a name="mysqldump-option-summary">
   </a>
   Option Syntax - Alphabetical Summary
  </h4>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   supports the following options,
        which can be specified on the command line or in the
   <code class="literal">
    [mysqldump]
   </code>
   and
   <code class="literal">
    [client]
   </code>
   groups of an option file. For information about option files
        used by MySQL programs, see
   <a class="xref" href="option-files.html" title="6.2.2.2 Using Option Files">
    Section 6.2.2.2, “Using Option Files”
   </a>
   .
  </p>
  <div class="table">
   <a name="idm46045314657248">
   </a>
   <p class="title">
    <b>
     Table 6.13 mysqldump Options
    </b>
   </p>
   <div class="table-contents">
    <table frame="box" rules="all" summary="Command-line options available for mysqldump.">
     <colgroup>
      <col style="width: 35%"/>
      <col style="width: 64%"/>
     </colgroup>
     <thead>
      <tr>
       <th>
        Option Name
       </th>
       <th>
        Description
       </th>
      </tr>
     </thead>
     <tbody>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_add-drop-database">
         --add-drop-database
        </a>
       </td>
       <td>
        Add DROP DATABASE statement before each CREATE DATABASE statement
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_add-drop-table">
         --add-drop-table
        </a>
       </td>
       <td>
        Add DROP TABLE statement before each CREATE TABLE statement
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_add-drop-trigger">
         --add-drop-trigger
        </a>
       </td>
       <td>
        Add DROP TRIGGER statement before each CREATE TRIGGER statement
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_add-locks">
         --add-locks
        </a>
       </td>
       <td>
        Surround each table dump with LOCK TABLES and UNLOCK TABLES statements
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
         --all-databases
        </a>
       </td>
       <td>
        Dump all tables in all databases
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_allow-keywords">
         --allow-keywords
        </a>
       </td>
       <td>
        Allow creation of column names that are keywords
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_apply-replica-statements">
         --apply-replica-statements
        </a>
       </td>
       <td>
        Include STOP REPLICA prior to CHANGE REPLICATION SOURCE TO statement and START REPLICA at end of output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_apply-slave-statements">
         --apply-slave-statements
        </a>
       </td>
       <td>
        Include STOP SLAVE prior to CHANGE MASTER statement and START SLAVE at end of output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_bind-address">
         --bind-address
        </a>
       </td>
       <td>
        Use specified network interface to connect to MySQL Server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_character-sets-dir">
         --character-sets-dir
        </a>
       </td>
       <td>
        Directory where character sets are installed
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_column-statistics">
         --column-statistics
        </a>
       </td>
       <td>
        Write ANALYZE TABLE statements to generate statistics histograms
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_comments">
         --comments
        </a>
       </td>
       <td>
        Add comments to dump file
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_compact">
         --compact
        </a>
       </td>
       <td>
        Produce more compact output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_compatible">
         --compatible
        </a>
       </td>
       <td>
        Produce output that is more compatible with other database systems or with older MySQL servers
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_complete-insert">
         --complete-insert
        </a>
       </td>
       <td>
        Use complete INSERT statements that include column names
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_compress">
         --compress
        </a>
       </td>
       <td>
        Compress all information sent between client and server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_compression-algorithms">
         --compression-algorithms
        </a>
       </td>
       <td>
        Permitted compression algorithms for connections to server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_create-options">
         --create-options
        </a>
       </td>
       <td>
        Include all MySQL-specific table options in CREATE TABLE statements
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_databases">
         --databases
        </a>
       </td>
       <td>
        Interpret all name arguments as database names
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_debug">
         --debug
        </a>
       </td>
       <td>
        Write debugging log
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_debug-check">
         --debug-check
        </a>
       </td>
       <td>
        Print debugging information when program exits
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_debug-info">
         --debug-info
        </a>
       </td>
       <td>
        Print debugging information, memory, and CPU statistics when program exits
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_default-auth">
         --default-auth
        </a>
       </td>
       <td>
        Authentication plugin to use
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_default-character-set">
         --default-character-set
        </a>
       </td>
       <td>
        Specify default character set
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_defaults-extra-file">
         --defaults-extra-file
        </a>
       </td>
       <td>
        Read named option file in addition to usual option files
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_defaults-file">
         --defaults-file
        </a>
       </td>
       <td>
        Read only named option file
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_defaults-group-suffix">
         --defaults-group-suffix
        </a>
       </td>
       <td>
        Option group suffix value
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_delete-master-logs">
         --delete-master-logs
        </a>
       </td>
       <td>
        On a replication source server, delete the binary logs after performing the dump operation
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_delete-source-logs">
         --delete-source-logs
        </a>
       </td>
       <td>
        On a replication source server, delete the binary logs after performing the dump operation
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_disable-keys">
         --disable-keys
        </a>
       </td>
       <td>
        For each table, surround INSERT statements with statements to disable and enable keys
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_dump-date">
         --dump-date
        </a>
       </td>
       <td>
        Include dump date as "Dump completed on" comment if --comments is given
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_dump-replica">
         --dump-replica
        </a>
       </td>
       <td>
        Include CHANGE REPLICATION SOURCE TO statement that lists binary log coordinates of replica's source
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_dump-slave">
         --dump-slave
        </a>
       </td>
       <td>
        Include CHANGE MASTER statement that lists binary log coordinates of replica's source
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_enable-cleartext-plugin">
         --enable-cleartext-plugin
        </a>
       </td>
       <td>
        Enable cleartext authentication plugin
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_events">
         --events
        </a>
       </td>
       <td>
        Dump events from dumped databases
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_extended-insert">
         --extended-insert
        </a>
       </td>
       <td>
        Use multiple-row INSERT syntax
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_fields">
         --fields-enclosed-by
        </a>
       </td>
       <td>
        This option is used with the --tab option and has the same meaning as the corresponding clause for LOAD DATA
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_fields">
         --fields-escaped-by
        </a>
       </td>
       <td>
        This option is used with the --tab option and has the same meaning as the corresponding clause for LOAD DATA
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_fields">
         --fields-optionally-enclosed-by
        </a>
       </td>
       <td>
        This option is used with the --tab option and has the same meaning as the corresponding clause for LOAD DATA
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_fields">
         --fields-terminated-by
        </a>
       </td>
       <td>
        This option is used with the --tab option and has the same meaning as the corresponding clause for LOAD DATA
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_flush-logs">
         --flush-logs
        </a>
       </td>
       <td>
        Flush MySQL server log files before starting dump
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_flush-privileges">
         --flush-privileges
        </a>
       </td>
       <td>
        Emit a FLUSH PRIVILEGES statement after dumping mysql database
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_force">
         --force
        </a>
       </td>
       <td>
        Continue even if an SQL error occurs during a table dump
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_get-server-public-key">
         --get-server-public-key
        </a>
       </td>
       <td>
        Request RSA public key from server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_help">
         --help
        </a>
       </td>
       <td>
        Display help message and exit
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_hex-blob">
         --hex-blob
        </a>
       </td>
       <td>
        Dump binary columns using hexadecimal notation
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_host">
         --host
        </a>
       </td>
       <td>
        Host on which MySQL server is located
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ignore-error">
         --ignore-error
        </a>
       </td>
       <td>
        Ignore specified errors
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ignore-table">
         --ignore-table
        </a>
       </td>
       <td>
        Do not dump given table
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ignore-views">
         --ignore-views
        </a>
       </td>
       <td>
        Skip dumping table views
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_include-master-host-port">
         --include-master-host-port
        </a>
       </td>
       <td>
        Include MASTER_HOST/MASTER_PORT options in CHANGE MASTER statement produced with --dump-slave
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_include-source-host-port">
         --include-source-host-port
        </a>
       </td>
       <td>
        Include SOURCE_HOST and SOURCE_PORT options in CHANGE REPLICATION SOURCE TO statement produced with --dump-replica
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_init-command">
         --init-command
        </a>
       </td>
       <td>
        Single SQL statement to execute after connecting or re-connecting to MySQL server; resets existing defined commands
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_init-command-add">
         --init-command-add
        </a>
       </td>
       <td>
        Add an additional SQL statement to execute after connecting or re-connecting to MySQL server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_insert-ignore">
         --insert-ignore
        </a>
       </td>
       <td>
        Write INSERT IGNORE rather than INSERT statements
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_lines-terminated-by">
         --lines-terminated-by
        </a>
       </td>
       <td>
        This option is used with the --tab option and has the same meaning as the corresponding clause for LOAD DATA
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_lock-all-tables">
         --lock-all-tables
        </a>
       </td>
       <td>
        Lock all tables across all databases
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
         --lock-tables
        </a>
       </td>
       <td>
        Lock all tables before dumping them
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_log-error">
         --log-error
        </a>
       </td>
       <td>
        Append warnings and errors to named file
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_login-path">
         --login-path
        </a>
       </td>
       <td>
        Read login path options from .mylogin.cnf
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_master-data">
         --master-data
        </a>
       </td>
       <td>
        Write the binary log file name and position to the output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_max-allowed-packet">
         --max-allowed-packet
        </a>
       </td>
       <td>
        Maximum packet length to send to or receive from server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_mysqld-long-query-time">
         --mysqld-long-query-time
        </a>
       </td>
       <td>
        Session value for slow query threshold
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_net-buffer-length">
         --net-buffer-length
        </a>
       </td>
       <td>
        Buffer size for TCP/IP and socket communication
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_network-timeout">
         --network-timeout
        </a>
       </td>
       <td>
        Increase network timeouts to permit larger table dumps
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_no-autocommit">
         --no-autocommit
        </a>
       </td>
       <td>
        Enclose the INSERT statements for each dumped table within SET autocommit = 0 and COMMIT statements
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_no-create-db">
         --no-create-db
        </a>
       </td>
       <td>
        Do not write CREATE DATABASE statements
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_no-create-info">
         --no-create-info
        </a>
       </td>
       <td>
        Do not write CREATE TABLE statements that re-create each dumped table
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_no-data">
         --no-data
        </a>
       </td>
       <td>
        Do not dump table contents
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_no-defaults">
         --no-defaults
        </a>
       </td>
       <td>
        Read no option files
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_no-login-paths">
         --no-login-paths
        </a>
       </td>
       <td>
        Do not read login paths from the login path file
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_no-set-names">
         --no-set-names
        </a>
       </td>
       <td>
        Same as --skip-set-charset
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_no-tablespaces">
         --no-tablespaces
        </a>
       </td>
       <td>
        Do not write any CREATE LOGFILE GROUP or CREATE TABLESPACE statements in output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_opt">
         --opt
        </a>
       </td>
       <td>
        Shorthand for --add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_order-by-primary">
         --order-by-primary
        </a>
       </td>
       <td>
        Dump each table's rows sorted by its primary key, or by its first unique index
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_output-as-version">
         --output-as-version
        </a>
       </td>
       <td>
        Determines replica and event terminology used in dumps; for compatibility with older versions
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_password">
         --password
        </a>
       </td>
       <td>
        Password to use when connecting to server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_password1">
         --password1
        </a>
       </td>
       <td>
        First multifactor authentication password to use when connecting to server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_password2">
         --password2
        </a>
       </td>
       <td>
        Second multifactor authentication password to use when connecting to server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_password3">
         --password3
        </a>
       </td>
       <td>
        Third multifactor authentication password to use when connecting to server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_pipe">
         --pipe
        </a>
       </td>
       <td>
        Connect to server using named pipe (Windows only)
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_plugin-authentication-kerberos-client-mode">
         --plugin-authentication-kerberos-client-mode
        </a>
       </td>
       <td>
        Permit GSSAPI pluggable authentication through the MIT Kerberos library on Windows
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_plugin-dir">
         --plugin-dir
        </a>
       </td>
       <td>
        Directory where plugins are installed
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_port">
         --port
        </a>
       </td>
       <td>
        TCP/IP port number for connection
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_print-defaults">
         --print-defaults
        </a>
       </td>
       <td>
        Print default options
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_protocol">
         --protocol
        </a>
       </td>
       <td>
        Transport protocol to use
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_quick">
         --quick
        </a>
       </td>
       <td>
        Retrieve rows for a table from the server a row at a time
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_quote-names">
         --quote-names
        </a>
       </td>
       <td>
        Quote identifiers within backtick characters
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_replace">
         --replace
        </a>
       </td>
       <td>
        Write REPLACE statements rather than INSERT statements
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_result-file">
         --result-file
        </a>
       </td>
       <td>
        Direct output to a given file
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_routines">
         --routines
        </a>
       </td>
       <td>
        Dump stored routines (procedures and functions) from dumped databases
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_server-public-key-path">
         --server-public-key-path
        </a>
       </td>
       <td>
        Path name to file containing RSA public key
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_set-charset">
         --set-charset
        </a>
       </td>
       <td>
        Add SET NAMES default_character_set to output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_set-gtid-purged">
         --set-gtid-purged
        </a>
       </td>
       <td>
        Whether to add SET @@GLOBAL.GTID_PURGED to output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_shared-memory-base-name">
         --shared-memory-base-name
        </a>
       </td>
       <td>
        Shared-memory name for shared-memory connections (Windows only)
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_show-create-skip-secondary-engine">
         --show-create-skip-secondary-engine
        </a>
       </td>
       <td>
        Exclude SECONDARY ENGINE clause from CREATE TABLE statements
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
         --single-transaction
        </a>
       </td>
       <td>
        Issue a BEGIN SQL statement before dumping data from server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_add-drop-table">
         --skip-add-drop-table
        </a>
       </td>
       <td>
        Do not add a DROP TABLE statement before each CREATE TABLE statement
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_add-locks">
         --skip-add-locks
        </a>
       </td>
       <td>
        Do not add locks
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_skip-comments">
         --skip-comments
        </a>
       </td>
       <td>
        Do not add comments to dump file
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_compact">
         --skip-compact
        </a>
       </td>
       <td>
        Do not produce more compact output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_disable-keys">
         --skip-disable-keys
        </a>
       </td>
       <td>
        Do not disable keys
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_extended-insert">
         --skip-extended-insert
        </a>
       </td>
       <td>
        Turn off extended-insert
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_skip-generated-invisible-primary-key">
         --skip-generated-invisible-primary-key
        </a>
       </td>
       <td>
        Do not include generated invisible primary keys in dump file
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_skip-opt">
         --skip-opt
        </a>
       </td>
       <td>
        Turn off options set by --opt
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_quick">
         --skip-quick
        </a>
       </td>
       <td>
        Do not retrieve rows for a table from the server a row at a time
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_quote-names">
         --skip-quote-names
        </a>
       </td>
       <td>
        Do not quote identifiers
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_set-charset">
         --skip-set-charset
        </a>
       </td>
       <td>
        Do not write SET NAMES statement
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_triggers">
         --skip-triggers
        </a>
       </td>
       <td>
        Do not dump triggers
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_tz-utc">
         --skip-tz-utc
        </a>
       </td>
       <td>
        Turn off tz-utc
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_socket">
         --socket
        </a>
       </td>
       <td>
        Unix socket file or Windows named pipe to use
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_source-data">
         --source-data
        </a>
       </td>
       <td>
        Write the binary log file name and position to the output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-ca
        </a>
       </td>
       <td>
        File that contains list of trusted SSL Certificate Authorities
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-capath
        </a>
       </td>
       <td>
        Directory that contains trusted SSL Certificate Authority certificate files
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-cert
        </a>
       </td>
       <td>
        File that contains X.509 certificate
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-cipher
        </a>
       </td>
       <td>
        Permissible ciphers for connection encryption
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-crl
        </a>
       </td>
       <td>
        File that contains certificate revocation lists
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-crlpath
        </a>
       </td>
       <td>
        Directory that contains certificate revocation-list files
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl-fips-mode">
         --ssl-fips-mode
        </a>
       </td>
       <td>
        Whether to enable FIPS mode on client side
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-key
        </a>
       </td>
       <td>
        File that contains X.509 key
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-mode
        </a>
       </td>
       <td>
        Desired security state of connection to server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-session-data
        </a>
       </td>
       <td>
        File that contains SSL session data
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_ssl">
         --ssl-session-data-continue-on-failed-reuse
        </a>
       </td>
       <td>
        Whether to establish connections if session reuse fails
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_tab">
         --tab
        </a>
       </td>
       <td>
        Produce tab-separated data files
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_tables">
         --tables
        </a>
       </td>
       <td>
        Override --databases or -B option
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_tls-ciphersuites">
         --tls-ciphersuites
        </a>
       </td>
       <td>
        Permissible TLSv1.3 ciphersuites for encrypted connections
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_tls-sni-servername">
         --tls-sni-servername
        </a>
       </td>
       <td>
        Server name supplied by the client
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_tls-version">
         --tls-version
        </a>
       </td>
       <td>
        Permissible TLS protocols for encrypted connections
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_triggers">
         --triggers
        </a>
       </td>
       <td>
        Dump triggers for each dumped table
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_tz-utc">
         --tz-utc
        </a>
       </td>
       <td>
        Add SET TIME_ZONE='+00:00' to dump file
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_user">
         --user
        </a>
       </td>
       <td>
        MySQL user name to use when connecting to server
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_verbose">
         --verbose
        </a>
       </td>
       <td>
        Verbose mode
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_version">
         --version
        </a>
       </td>
       <td>
        Display version information and exit
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_where">
         --where
        </a>
       </td>
       <td>
        Dump only rows selected by given WHERE condition
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_xml">
         --xml
        </a>
       </td>
       <td>
        Produce XML output
       </td>
      </tr>
      <tr>
       <td>
        <a class="link" href="mysqldump.html#option_mysqldump_zstd-compression-level">
         --zstd-compression-level
        </a>
       </td>
       <td>
        Compression level for connections to server that use zstd compression
       </td>
      </tr>
     </tbody>
    </table>
   </div>
   <div class="table-contents">
    <table cellpadding="0" cellspacing="0" style="position: fixed; top: 0px; display: none; left: 401px; width: 739px;">
     <thead>
      <tr>
       <th style="width: 260.906px;">
        Option Name
       </th>
       <th style="width: 477.094px;">
        Description
       </th>
      </tr>
     </thead>
    </table>
   </div>
  </div>
  <br class="table-break"/>
  <h4>
   <a name="mysqldump-connection-options">
   </a>
   Connection Options
  </h4>
  <p>
   The
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   command logs into a MySQL
        server to extract information. The following options specify how
        to connect to the MySQL server, either on the same machine or a
        remote system.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_bind-address">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_bind-address">
       <code class="option">
        --bind-address=
        <em class="replaceable">
         <code>
          ip_address
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for bind-address">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --bind-address=ip_address
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314269280">
     </a>
     <a class="indexterm" name="idm46045314267792">
     </a>
     <p>
      On a computer having multiple network interfaces, use this
            option to select which interface to use for connecting to
            the MySQL server.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_compress">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_compress">
       <code class="option">
        --compress
       </code>
      </a>
      ,
      <code class="option">
       -C
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for compress">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --compress[={OFF|ON}]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Deprecated
         </th>
         <td>
          Yes
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           OFF
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314251088">
     </a>
     <a class="indexterm" name="idm46045314249600">
     </a>
     <p>
      Compress all information sent between the client and the
            server if possible. See
      <a class="xref" href="connection-compression-control.html" title="6.2.8 Connection Compression Control">
       Section 6.2.8, “Connection Compression Control”
      </a>
      .
     </p>
     <p>
      This option is deprecated. Expect it to be removed in a
            future version of MySQL. See
      <a class="xref" href="connection-compression-control.html#connection-compression-legacy-configuration" title="Configuring Legacy Connection Compression">
       Configuring Legacy Connection Compression
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_compression-algorithms">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_compression-algorithms">
       <code class="option">
        --compression-algorithms=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for compression-algorithms">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --compression-algorithms=value
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Set
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           uncompressed
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            zlib
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            zstd
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            uncompressed
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314228416">
     </a>
     <a class="indexterm" name="idm46045314226912">
     </a>
     <p>
      The permitted compression algorithms for connections to the
            server. The available algorithms are the same as for the
      <a class="link" href="server-system-variables.html#sysvar_protocol_compression_algorithms">
       <code class="literal">
        protocol_compression_algorithms
       </code>
      </a>
      system variable. The default value is
      <code class="literal">
       uncompressed
      </code>
      .
     </p>
     <p>
      For more information, see
      <a class="xref" href="connection-compression-control.html" title="6.2.8 Connection Compression Control">
       Section 6.2.8, “Connection Compression Control”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_default-auth">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_default-auth">
       <code class="option">
        --default-auth=
        <em class="replaceable">
         <code>
          plugin
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for default-auth">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --default-auth=plugin
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314211600">
     </a>
     <a class="indexterm" name="idm46045314210112">
     </a>
     <p>
      A hint about which client-side authentication plugin to use.
            See
      <a class="xref" href="pluggable-authentication.html" title="8.2.17 Pluggable Authentication">
       Section 8.2.17, “Pluggable Authentication”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_enable-cleartext-plugin">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_enable-cleartext-plugin">
       <code class="option">
        --enable-cleartext-plugin
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for enable-cleartext-plugin">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --enable-cleartext-plugin
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314195056">
     </a>
     <a class="indexterm" name="idm46045314193552">
     </a>
     <p>
      Enable the
      <code class="literal">
       mysql_clear_password
      </code>
      cleartext
            authentication plugin. (See
      <a class="xref" href="cleartext-pluggable-authentication.html" title="8.4.1.4 Client-Side Cleartext Pluggable Authentication">
       Section 8.4.1.4, “Client-Side Cleartext Pluggable Authentication”
      </a>
      .)
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_get-server-public-key">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_get-server-public-key">
       <code class="option">
        --get-server-public-key
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for get-server-public-key">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --get-server-public-key
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314180448">
     </a>
     <a class="indexterm" name="idm46045314178944">
     </a>
     <p>
      Request from the server the public key required for RSA key
            pair-based password exchange. This option applies to clients
            that authenticate with the
      <code class="literal">
       caching_sha2_password
      </code>
      authentication
            plugin. For that plugin, the server does not send the public
            key unless requested. This option is ignored for accounts
            that do not authenticate with that plugin. It is also
            ignored if RSA-based password exchange is not used, as is
            the case when the client connects to the server using a
            secure connection.
     </p>
     <p>
      If
      <a class="link" href="mysqldump.html#option_mysqldump_server-public-key-path">
       <code class="option">
        --server-public-key-path=
        <em class="replaceable">
         <code>
          file_name
         </code>
        </em>
       </code>
      </a>
      is given and specifies a valid public key file, it takes
            precedence over
      <a class="link" href="mysqldump.html#option_mysqldump_get-server-public-key">
       <code class="option">
        --get-server-public-key
       </code>
      </a>
      .
     </p>
     <p>
      For information about the
      <code class="literal">
       caching_sha2_password
      </code>
      plugin, see
      <a class="xref" href="caching-sha2-pluggable-authentication.html" title="8.4.1.2 Caching SHA-2 Pluggable Authentication">
       Section 8.4.1.2, “Caching SHA-2 Pluggable Authentication”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_host">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_host">
       <code class="option">
        --host=
        <em class="replaceable">
         <code>
          host_name
         </code>
        </em>
       </code>
      </a>
      ,
      <code class="option">
       -h
       <em class="replaceable">
        <code>
         host_name
        </code>
       </em>
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for host">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --host
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314162000">
     </a>
     <a class="indexterm" name="idm46045314160512">
     </a>
     <p>
      Dump data from the MySQL server on the given host. The
            default host is
      <code class="literal">
       localhost
      </code>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_login-path">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_login-path">
       <code class="option">
        --login-path=
        <em class="replaceable">
         <code>
          name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for login-path">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --login-path=name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314147760">
     </a>
     <a class="indexterm" name="idm46045314146272">
     </a>
     <p>
      Read options from the named login path in the
      <code class="filename">
       .mylogin.cnf
      </code>
      login path file. A
      <span class="quote">
       “
       <span class="quote">
        login path
       </span>
       ”
      </span>
      is an option group containing
            options that specify which MySQL server to connect to and
            which account to authenticate as. To create or modify a
            login path file, use the
      <a class="link" href="mysql-config-editor.html" title="6.6.7 mysql_config_editor — MySQL Configuration Utility">
       <span class="command">
        <strong>
         mysql_config_editor
        </strong>
       </span>
      </a>
      utility. See
      <a class="xref" href="mysql-config-editor.html" title="6.6.7 mysql_config_editor — MySQL Configuration Utility">
       Section 6.6.7, “mysql_config_editor — MySQL Configuration Utility”
      </a>
      .
     </p>
     <p>
      For additional information about this and other option-file
            options, see
      <a class="xref" href="option-file-options.html" title="6.2.2.3 Command-Line Options that Affect Option-File Handling">
       Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_no-login-paths">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_no-login-paths">
       <code class="option">
        --no-login-paths
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for no-login-paths">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --no-login-paths
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314132128">
     </a>
     <a class="indexterm" name="idm46045314130640">
     </a>
     <p>
      Skips reading options from the login path file.
     </p>
     <p>
      See
      <a class="link" href="mysqldump.html#option_mysqldump_login-path">
       <code class="option">
        --login-path
       </code>
      </a>
      for
            related information.
     </p>
     <p>
      For additional information about this and other option-file
            options, see
      <a class="xref" href="option-file-options.html" title="6.2.2.3 Command-Line Options that Affect Option-File Handling">
       Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_password">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_password">
       <code class="option">
        --password[=
        <em class="replaceable">
         <code>
          password
         </code>
        </em>
        ]
       </code>
      </a>
      ,
      <code class="option">
       -p[
       <em class="replaceable">
        <code>
         password
        </code>
       </em>
       ]
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for password">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --password[=password]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314115040">
     </a>
     <a class="indexterm" name="idm46045314113552">
     </a>
     <p>
      The password of the MySQL account used for connecting to the
            server. The password value is optional. If not given,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      prompts for one. If given,
            there must be
      <span class="emphasis">
       <em>
        no space
       </em>
      </span>
      between
      <a class="link" href="mysqldump.html#option_mysqldump_password">
       <code class="option">
        --password=
       </code>
      </a>
      or
      <code class="option">
       -p
      </code>
      and the password following it. If no
            password option is specified, the default is to send no
            password.
     </p>
     <p>
      Specifying a password on the command line should be
            considered insecure. To avoid giving the password on the
            command line, use an option file. See
      <a class="xref" href="password-security-user.html" title="8.1.2.1 End-User Guidelines for Password Security">
       Section 8.1.2.1, “End-User Guidelines for Password Security”
      </a>
      .
     </p>
     <p>
      To explicitly specify that there is no password and that
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      should not prompt for one, use
            the
      <a class="link" href="mysqldump.html#option_mysqldump_password">
       <code class="option">
        --skip-password
       </code>
      </a>
      option.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_password1">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_password1">
       <code class="option">
        --password1[=
        <em class="replaceable">
         <code>
          pass_val
         </code>
        </em>
        ]
       </code>
      </a>
     </p>
     <a class="indexterm" name="idm46045314101616">
     </a>
     <p>
      The password for multifactor authentication factor 1 of the
            MySQL account used for connecting to the server. The
            password value is optional. If not given,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      prompts for one. If given,
            there must be
      <span class="emphasis">
       <em>
        no space
       </em>
      </span>
      between
      <a class="link" href="mysqldump.html#option_mysqldump_password1">
       <code class="option">
        --password1=
       </code>
      </a>
      and the
            password following it. If no password option is specified,
            the default is to send no password.
     </p>
     <p>
      Specifying a password on the command line should be
            considered insecure. To avoid giving the password on the
            command line, use an option file. See
      <a class="xref" href="password-security-user.html" title="8.1.2.1 End-User Guidelines for Password Security">
       Section 8.1.2.1, “End-User Guidelines for Password Security”
      </a>
      .
     </p>
     <p>
      To explicitly specify that there is no password and that
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      should not prompt for one, use
            the
      <a class="link" href="mysqldump.html#option_mysqldump_password1">
       <code class="option">
        --skip-password1
       </code>
      </a>
      option.
     </p>
     <p>
      <a class="link" href="mysqldump.html#option_mysqldump_password1">
       <code class="option">
        --password1
       </code>
      </a>
      and
      <a class="link" href="mysqldump.html#option_mysqldump_password">
       <code class="option">
        --password
       </code>
      </a>
      are synonymous,
            as are
      <a class="link" href="mysqldump.html#option_mysqldump_password1">
       <code class="option">
        --skip-password1
       </code>
      </a>
      and
      <a class="link" href="mysqldump.html#option_mysqldump_password">
       <code class="option">
        --skip-password
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_password2">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_password2">
       <code class="option">
        --password2[=
        <em class="replaceable">
         <code>
          pass_val
         </code>
        </em>
        ]
       </code>
      </a>
     </p>
     <a class="indexterm" name="idm46045314086064">
     </a>
     <p>
      The password for multifactor authentication factor 2 of the
            MySQL account used for connecting to the server. The
            semantics of this option are similar to the semantics for
      <a class="link" href="mysqldump.html#option_mysqldump_password1">
       <code class="option">
        --password1
       </code>
      </a>
      ; see the
            description of that option for details.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_password3">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_password3">
       <code class="option">
        --password3[=
        <em class="replaceable">
         <code>
          pass_val
         </code>
        </em>
        ]
       </code>
      </a>
     </p>
     <a class="indexterm" name="idm46045314080704">
     </a>
     <p>
      The password for multifactor authentication factor 3 of the
            MySQL account used for connecting to the server. The
            semantics of this option are similar to the semantics for
      <a class="link" href="mysqldump.html#option_mysqldump_password1">
       <code class="option">
        --password1
       </code>
      </a>
      ; see the
            description of that option for details.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_pipe">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_pipe">
       <code class="option">
        --pipe
       </code>
      </a>
      ,
      <code class="option">
       -W
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for pipe">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --pipe
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314067904">
     </a>
     <a class="indexterm" name="idm46045314066416">
     </a>
     <p>
      On Windows, connect to the server using a named pipe. This
            option applies only if the server was started with the
      <a class="link" href="server-system-variables.html#sysvar_named_pipe">
       <code class="literal">
        named_pipe
       </code>
      </a>
      system variable
            enabled to support named-pipe connections. In addition, the
            user making the connection must be a member of the Windows
            group specified by the
      <a class="link" href="server-system-variables.html#sysvar_named_pipe_full_access_group">
       <code class="literal">
        named_pipe_full_access_group
       </code>
      </a>
      system variable.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_plugin-authentication-kerberos-client-mode">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_plugin-authentication-kerberos-client-mode">
       <code class="option">
        --plugin-authentication-kerberos-client-mode=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for plugin-authentication-kerberos-client-mode">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --plugin-authentication-kerberos-client-mode
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           SSPI
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <code class="literal">
           GSSAPI
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314046480">
     </a>
     <a class="indexterm" name="idm46045314044960">
     </a>
     <p>
      On Windows, the
      <code class="literal">
       authentication_kerberos_client
      </code>
      authentication plugin supports this plugin option. It
            provides two possible values that the client user can set at
            runtime:
      <code class="literal">
       SSPI
      </code>
      and
      <code class="literal">
       GSSAPI
      </code>
      .
     </p>
     <p>
      The default value for the client-side plugin option uses
            Security Support Provider Interface (SSPI), which is capable
            of acquiring credentials from the Windows in-memory cache.
            Alternatively, the client user can select a mode that
            supports Generic Security Service Application Program
            Interface (GSSAPI) through the MIT Kerberos library on
            Windows. GSSAPI is capable of acquiring cached credentials
            previously generated by using the
      <span class="command">
       <strong>
        kinit
       </strong>
      </span>
      command.
     </p>
     <p>
      For more information, see
      <a class="link" href="kerberos-pluggable-authentication.html#kerberos-usage-win-gssapi-client-commands">
       Commands
            for Windows Clients in GSSAPI Mode
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_plugin-dir">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_plugin-dir">
       <code class="option">
        --plugin-dir=
        <em class="replaceable">
         <code>
          dir_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for plugin-dir">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --plugin-dir=dir_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Directory name
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314027584">
     </a>
     <a class="indexterm" name="idm46045314026096">
     </a>
     <p>
      The directory in which to look for plugins. Specify this
            option if the
      <a class="link" href="mysqldump.html#option_mysqldump_default-auth">
       <code class="option">
        --default-auth
       </code>
      </a>
      option is
            used to specify an authentication plugin but
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      does not find it. See
      <a class="xref" href="pluggable-authentication.html" title="8.2.17 Pluggable Authentication">
       Section 8.2.17, “Pluggable Authentication”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_port">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_port">
       <code class="option">
        --port=
        <em class="replaceable">
         <code>
          port_num
         </code>
        </em>
       </code>
      </a>
      ,
      <code class="option">
       -P
       <em class="replaceable">
        <code>
         port_num
        </code>
       </em>
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for port">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --port=port_num
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Numeric
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           3306
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045314007968">
     </a>
     <a class="indexterm" name="idm46045314006480">
     </a>
     <p>
      For TCP/IP connections, the port number to use.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_protocol">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_protocol">
       <code class="option">
        --protocol={TCP|SOCKET|PIPE|MEMORY}
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for protocol">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --protocol=type
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           [see text]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            TCP
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            SOCKET
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            PIPE
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            MEMORY
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313986624">
     </a>
     <a class="indexterm" name="idm46045313985136">
     </a>
     <p>
      The transport protocol to use for connecting to the server.
            It is useful when the other connection parameters normally
            result in use of a protocol other than the one you want. For
            details on the permissible values, see
      <a class="xref" href="transport-protocols.html" title="6.2.7 Connection Transport Protocols">
       Section 6.2.7, “Connection Transport Protocols”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_server-public-key-path">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_server-public-key-path">
       <code class="option">
        --server-public-key-path=
        <em class="replaceable">
         <code>
          file_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for server-public-key-path">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --server-public-key-path=file_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          File name
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313972272">
     </a>
     <a class="indexterm" name="idm46045313970768">
     </a>
     <p>
      The path name to a file in PEM format containing a
            client-side copy of the public key required by the server
            for RSA key pair-based password exchange. This option
            applies to clients that authenticate with the
      <code class="literal">
       sha256_password
      </code>
      (deprecated) or
      <code class="literal">
       caching_sha2_password
      </code>
      authentication
            plugin. This option is ignored for accounts that do not
            authenticate with one of those plugins. It is also ignored
            if RSA-based password exchange is not used, as is the case
            when the client connects to the server using a secure
            connection.
     </p>
     <p>
      If
      <a class="link" href="mysqldump.html#option_mysqldump_server-public-key-path">
       <code class="option">
        --server-public-key-path=
        <em class="replaceable">
         <code>
          file_name
         </code>
        </em>
       </code>
      </a>
      is given and specifies a valid public key file, it takes
            precedence over
      <a class="link" href="mysqldump.html#option_mysqldump_get-server-public-key">
       <code class="option">
        --get-server-public-key
       </code>
      </a>
      .
     </p>
     <p>
      For
      <code class="literal">
       sha256_password
      </code>
      (deprecated), this
            option applies only if MySQL was built using OpenSSL.
     </p>
     <p>
      For information about the
      <code class="literal">
       sha256_password
      </code>
      and
      <code class="literal">
       caching_sha2_password
      </code>
      plugins, see
      <a class="xref" href="sha256-pluggable-authentication.html" title="8.4.1.3 SHA-256 Pluggable Authentication">
       Section 8.4.1.3, “SHA-256 Pluggable Authentication”
      </a>
      , and
      <a class="xref" href="caching-sha2-pluggable-authentication.html" title="8.4.1.2 Caching SHA-2 Pluggable Authentication">
       Section 8.4.1.2, “Caching SHA-2 Pluggable Authentication”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_socket">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_socket">
       <code class="option">
        --socket=
        <em class="replaceable">
         <code>
          path
         </code>
        </em>
       </code>
      </a>
      ,
      <code class="option">
       -S
       <em class="replaceable">
        <code>
         path
        </code>
       </em>
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for socket">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --socket={file_name|pipe_name}
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313948816">
     </a>
     <a class="indexterm" name="idm46045313947328">
     </a>
     <p>
      For connections to
      <code class="literal">
       localhost
      </code>
      , the Unix
            socket file to use, or, on Windows, the name of the named
            pipe to use.
     </p>
     <p>
      On Windows, this option applies only if the server was
            started with the
      <a class="link" href="server-system-variables.html#sysvar_named_pipe">
       <code class="literal">
        named_pipe
       </code>
      </a>
      system variable enabled to support named-pipe connections.
            In addition, the user making the connection must be a member
            of the Windows group specified by the
      <a class="link" href="server-system-variables.html#sysvar_named_pipe_full_access_group">
       <code class="literal">
        named_pipe_full_access_group
       </code>
      </a>
      system variable.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_ssl">
      </a>
      <code class="option">
       --ssl*
      </code>
     </p>
     <a class="indexterm" name="idm46045313939744">
     </a>
     <a class="indexterm" name="idm46045313938256">
     </a>
     <p>
      Options that begin with
      <code class="option">
       --ssl
      </code>
      specify
            whether to connect to the server using encryption and
            indicate where to find SSL keys and certificates. See
      <a class="xref" href="connection-options.html#encrypted-connection-options" title="Command Options for Encrypted Connections">
       Command Options for Encrypted Connections
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_ssl-fips-mode">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_ssl-fips-mode">
       <code class="option">
        --ssl-fips-mode={OFF|ON|STRICT}
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for ssl-fips-mode">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --ssl-fips-mode={OFF|ON|STRICT}
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Deprecated
         </th>
         <td>
          Yes
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Enumeration
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           OFF
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            OFF
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            ON
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            STRICT
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313916112">
     </a>
     <a class="indexterm" name="idm46045313914624">
     </a>
     <p>
      Controls whether to enable FIPS mode on the client side. The
      <a class="link" href="mysqldump.html#option_mysqldump_ssl-fips-mode">
       <code class="option">
        --ssl-fips-mode
       </code>
      </a>
      option
            differs from other
      <code class="option">
       --ssl-
       <em class="replaceable">
        <code>
         xxx
        </code>
       </em>
      </code>
      options in that it is not used to establish encrypted
            connections, but rather to affect which cryptographic
            operations to permit. See
      <a class="xref" href="fips-mode.html" title="8.8 FIPS Support">
       Section 8.8, “FIPS Support”
      </a>
      .
     </p>
     <p>
      These
      <a class="link" href="mysqldump.html#option_mysqldump_ssl-fips-mode">
       <code class="option">
        --ssl-fips-mode
       </code>
      </a>
      values are permitted:
     </p>
     <div class="itemizedlist">
      <ul class="itemizedlist" style="list-style-type: circle; ">
       <li class="listitem">
        <p>
         <code class="literal">
          OFF
         </code>
         : Disable FIPS mode.
        </p>
       </li>
       <li class="listitem">
        <p>
         <code class="literal">
          ON
         </code>
         : Enable FIPS mode.
        </p>
       </li>
       <li class="listitem">
        <p>
         <code class="literal">
          STRICT
         </code>
         : Enable
         <span class="quote">
          “
          <span class="quote">
           strict
          </span>
          ”
         </span>
         FIPS mode.
        </p>
       </li>
      </ul>
     </div>
     <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Note
      </div>
      <p>
       If the OpenSSL FIPS Object Module is not available, the
              only permitted value for
       <a class="link" href="mysqldump.html#option_mysqldump_ssl-fips-mode">
        <code class="option">
         --ssl-fips-mode
        </code>
       </a>
       is
       <code class="literal">
        OFF
       </code>
       . In this case, setting
       <a class="link" href="mysqldump.html#option_mysqldump_ssl-fips-mode">
        <code class="option">
         --ssl-fips-mode
        </code>
       </a>
       to
       <code class="literal">
        ON
       </code>
       or
       <code class="literal">
        STRICT
       </code>
       causes
              the client to produce a warning at startup and to operate
              in non-FIPS mode.
      </p>
     </div>
     <p>
      This option is deprecated. Expect it to be removed in a
            future version of MySQL.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_tls-ciphersuites">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_tls-ciphersuites">
       <code class="option">
        --tls-ciphersuites=
        <em class="replaceable">
         <code>
          ciphersuite_list
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for tls-ciphersuites">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --tls-ciphersuites=ciphersuite_list
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313887664">
     </a>
     <a class="indexterm" name="idm46045313886176">
     </a>
     <p>
      The permissible ciphersuites for encrypted connections that
            use TLSv1.3. The value is a list of one or more
            colon-separated ciphersuite names. The ciphersuites that can
            be named for this option depend on the SSL library used to
            compile MySQL. For details, see
      <a class="xref" href="encrypted-connection-protocols-ciphers.html" title="8.3.2 Encrypted Connection TLS Protocols and Ciphers">
       Section 8.3.2, “Encrypted Connection TLS Protocols and Ciphers”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_tls-sni-servername">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_tls-sni-servername">
       <code class="option">
        --tls-sni-servername=
        <em class="replaceable">
         <code>
          server_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for tls-sni-servername">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --tls-sni-servername=server_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313873184">
     </a>
     <a class="indexterm" name="idm46045313871680">
     </a>
     <p>
      When specified, the name is passed to the
      <code class="literal">
       libmysqlclient
      </code>
      C API library using the
      <code class="literal">
       MYSQL_OPT_TLS_SNI_SERVERNAME
      </code>
      option of
      <a class="ulink" href="/doc/c-api/8.4/en/mysql-options.html" target="_top">
       <code class="literal">
        mysql_options()
       </code>
      </a>
      . The server
            name is not case-sensitive. To show which server name the
            client specified for the current session, if any, check the
      <a class="link" href="server-status-variables.html#statvar_Tls_sni_server_name">
       <code class="literal">
        Tls_sni_server_name
       </code>
      </a>
      status
            variable.
     </p>
     <p>
      Server Name Indication (SNI) is an extension to the TLS
            protocol (OpenSSL must be compiled using TLS extensions for
            this option to function). The MySQL implementation of SNI
            represents the client-side only.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_tls-version">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_tls-version">
       <code class="option">
        --tls-version=
        <em class="replaceable">
         <code>
          protocol_list
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for tls-version">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --tls-version=protocol_list
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            TLSv1,TLSv1.1,TLSv1.2,TLSv1.3
           </code>
           (OpenSSL 1.1.1 or higher)
          </p>
          <p class="valid-value">
           <code class="literal">
            TLSv1,TLSv1.1,TLSv1.2
           </code>
           (otherwise)
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313850736">
     </a>
     <a class="indexterm" name="idm46045313849248">
     </a>
     <p>
      The permissible TLS protocols for encrypted connections. The
            value is a list of one or more comma-separated protocol
            names. The protocols that can be named for this option
            depend on the SSL library used to compile MySQL. For
            details, see
      <a class="xref" href="encrypted-connection-protocols-ciphers.html" title="8.3.2 Encrypted Connection TLS Protocols and Ciphers">
       Section 8.3.2, “Encrypted Connection TLS Protocols and Ciphers”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_user">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_user">
       <code class="option">
        --user=
        <em class="replaceable">
         <code>
          user_name
         </code>
        </em>
       </code>
      </a>
      ,
      <code class="option">
       -u
       <em class="replaceable">
        <code>
         user_name
        </code>
       </em>
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for user">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --user=user_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313835680">
     </a>
     <a class="indexterm" name="idm46045313834192">
     </a>
     <p>
      The user name of the MySQL account to use for connecting to
            the server.
     </p>
     <p>
      If you are using the
      <code class="literal">
       Rewriter
      </code>
      plugin, you
            should grant this user the
      <a class="link" href="privileges-provided.html#priv_skip-query-rewrite">
       <code class="literal">
        SKIP_QUERY_REWRITE
       </code>
      </a>
      privilege.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_zstd-compression-level">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_zstd-compression-level">
       <code class="option">
        --zstd-compression-level=
        <em class="replaceable">
         <code>
          level
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for zstd-compression-level">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --zstd-compression-level=#
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Integer
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313819680">
     </a>
     <a class="indexterm" name="idm46045313818176">
     </a>
     <p>
      The compression level to use for connections to the server
            that use the
      <code class="literal">
       zstd
      </code>
      compression algorithm.
            The permitted levels are from 1 to 22, with larger values
            indicating increasing levels of compression. The default
      <code class="literal">
       zstd
      </code>
      compression level is 3. The
            compression level setting has no effect on connections that
            do not use
      <code class="literal">
       zstd
      </code>
      compression.
     </p>
     <p>
      For more information, see
      <a class="xref" href="connection-compression-control.html" title="6.2.8 Connection Compression Control">
       Section 6.2.8, “Connection Compression Control”
      </a>
      .
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-option-file-options">
   </a>
   Option-File Options
  </h4>
  <p>
   These options are used to control which option files to read.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_defaults-extra-file">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_defaults-extra-file">
       <code class="option">
        --defaults-extra-file=
        <em class="replaceable">
         <code>
          file_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for defaults-extra-file">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --defaults-extra-file=file_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          File name
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313800496">
     </a>
     <a class="indexterm" name="idm46045313798992">
     </a>
     <p>
      Read this option file after the global option file but (on
            Unix) before the user option file. If the file does not
            exist or is otherwise inaccessible, an error occurs. If
      <em class="replaceable">
       <code>
        file_name
       </code>
      </em>
      is not an absolute path
            name, it is interpreted relative to the current directory.
     </p>
     <p>
      For additional information about this and other option-file
            options, see
      <a class="xref" href="option-file-options.html" title="6.2.2.3 Command-Line Options that Affect Option-File Handling">
       Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_defaults-file">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_defaults-file">
       <code class="option">
        --defaults-file=
        <em class="replaceable">
         <code>
          file_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for defaults-file">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --defaults-file=file_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          File name
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313785088">
     </a>
     <a class="indexterm" name="idm46045313783600">
     </a>
     <p>
      Use only the given option file. If the file does not exist
            or is otherwise inaccessible, an error occurs. If
      <em class="replaceable">
       <code>
        file_name
       </code>
      </em>
      is not an absolute path
            name, it is interpreted relative to the current directory.
     </p>
     <p>
      Exception: Even with
      <a class="link" href="option-file-options.html#option_general_defaults-file">
       <code class="option">
        --defaults-file
       </code>
      </a>
      , client
            programs read
      <code class="filename">
       .mylogin.cnf
      </code>
      .
     </p>
     <p>
      For additional information about this and other option-file
            options, see
      <a class="xref" href="option-file-options.html" title="6.2.2.3 Command-Line Options that Affect Option-File Handling">
       Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_defaults-group-suffix">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_defaults-group-suffix">
       <code class="option">
        --defaults-group-suffix=
        <em class="replaceable">
         <code>
          str
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for defaults-group-suffix">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --defaults-group-suffix=str
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313767632">
     </a>
     <a class="indexterm" name="idm46045313766128">
     </a>
     <p>
      Read not only the usual option groups, but also groups with
            the usual names and a suffix of
      <em class="replaceable">
       <code>
        str
       </code>
      </em>
      . For example,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      normally reads the
      <code class="literal">
       [client]
      </code>
      and
      <code class="literal">
       [mysqldump]
      </code>
      groups. If this option is
            given as
      <a class="link" href="mysqldump.html#option_mysqldump_defaults-group-suffix">
       <code class="option">
        --defaults-group-suffix=_other
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      also reads the
      <code class="literal">
       [client_other]
      </code>
      and
      <code class="literal">
       [mysqldump_other]
      </code>
      groups.
     </p>
     <p>
      For additional information about this and other option-file
            options, see
      <a class="xref" href="option-file-options.html" title="6.2.2.3 Command-Line Options that Affect Option-File Handling">
       Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_no-defaults">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_no-defaults">
       <code class="option">
        --no-defaults
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for no-defaults">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --no-defaults
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313748352">
     </a>
     <a class="indexterm" name="idm46045313746864">
     </a>
     <p>
      Do not read any option files. If program startup fails due
            to reading unknown options from an option file,
      <a class="link" href="mysqldump.html#option_mysqldump_no-defaults">
       <code class="option">
        --no-defaults
       </code>
      </a>
      can be used
            to prevent them from being read.
     </p>
     <p>
      The exception is that the
      <code class="filename">
       .mylogin.cnf
      </code>
      file is read in all cases, if it exists. This permits
            passwords to be specified in a safer way than on the command
            line even when
      <a class="link" href="mysqldump.html#option_mysqldump_no-defaults">
       <code class="option">
        --no-defaults
       </code>
      </a>
      is used. To
            create
      <code class="filename">
       .mylogin.cnf
      </code>
      , use the
      <a class="link" href="mysql-config-editor.html" title="6.6.7 mysql_config_editor — MySQL Configuration Utility">
       <span class="command">
        <strong>
         mysql_config_editor
        </strong>
       </span>
      </a>
      utility. See
      <a class="xref" href="mysql-config-editor.html" title="6.6.7 mysql_config_editor — MySQL Configuration Utility">
       Section 6.6.7, “mysql_config_editor — MySQL Configuration Utility”
      </a>
      .
     </p>
     <p>
      For additional information about this and other option-file
            options, see
      <a class="xref" href="option-file-options.html" title="6.2.2.3 Command-Line Options that Affect Option-File Handling">
       Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_print-defaults">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_print-defaults">
       <code class="option">
        --print-defaults
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for print-defaults">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --print-defaults
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313729952">
     </a>
     <a class="indexterm" name="idm46045313728464">
     </a>
     <p>
      Print the program name and all options that it gets from
            option files.
     </p>
     <p>
      For additional information about this and other option-file
            options, see
      <a class="xref" href="option-file-options.html" title="6.2.2.3 Command-Line Options that Affect Option-File Handling">
       Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”
      </a>
      .
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-ddl-options">
   </a>
   DDL Options
  </h4>
  <p>
   Usage scenarios for
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   include setting
        up an entire new MySQL instance (including database tables), and
        replacing data inside an existing instance with existing
        databases and tables. The following options let you specify
        which things to tear down and set up when restoring a dump, by
        encoding various DDL statements within the dump file.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_add-drop-database">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_add-drop-database">
       <code class="option">
        --add-drop-database
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for add-drop-database">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --add-drop-database
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313714064">
     </a>
     <a class="indexterm" name="idm46045313712560">
     </a>
     <p>
      Write a
      <a class="link" href="drop-database.html" title="15.1.24 DROP DATABASE Statement">
       <code class="literal">
        DROP DATABASE
       </code>
      </a>
      statement before each
      <a class="link" href="create-database.html" title="15.1.12 CREATE DATABASE Statement">
       <code class="literal">
        CREATE
            DATABASE
       </code>
      </a>
      statement. This option is typically used
            in conjunction with the
      <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
       <code class="option">
        --all-databases
       </code>
      </a>
      or
      <a class="link" href="mysqldump.html#option_mysqldump_databases">
       <code class="option">
        --databases
       </code>
      </a>
      option because
            no
      <a class="link" href="create-database.html" title="15.1.12 CREATE DATABASE Statement">
       <code class="literal">
        CREATE DATABASE
       </code>
      </a>
      statements
            are written unless one of those options is specified.
     </p>
     <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Note
      </div>
      <p>
       In MySQL 8.4, the
       <code class="literal">
        mysql
       </code>
       schema is considered a system schema that cannot be
              dropped by end users. If
       <a class="link" href="mysqldump.html#option_mysqldump_add-drop-database">
        <code class="option">
         --add-drop-database
        </code>
       </a>
       is
              used with
       <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
        <code class="option">
         --all-databases
        </code>
       </a>
       or with
       <a class="link" href="mysqldump.html#option_mysqldump_databases">
        <code class="option">
         --databases
        </code>
       </a>
       where the
              list of schemas to be dumped includes
       <code class="literal">
        mysql
       </code>
       , the dump file contains a
       <code class="literal">
        DROP DATABASE `mysql`
       </code>
       statement that
              causes an error when the dump file is reloaded.
      </p>
      <p>
       Instead, to use
       <a class="link" href="mysqldump.html#option_mysqldump_add-drop-database">
        <code class="option">
         --add-drop-database
        </code>
       </a>
       , use
       <a class="link" href="mysqldump.html#option_mysqldump_databases">
        <code class="option">
         --databases
        </code>
       </a>
       with a list
              of schemas to be dumped, where the list does not include
       <code class="literal">
        mysql
       </code>
       .
      </p>
     </div>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_add-drop-table">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_add-drop-table">
       <code class="option">
        --add-drop-table
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for add-drop-table">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --add-drop-table
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313687536">
     </a>
     <a class="indexterm" name="idm46045313686048">
     </a>
     <p>
      Write a
      <a class="link" href="drop-table.html" title="15.1.32 DROP TABLE Statement">
       <code class="literal">
        DROP TABLE
       </code>
      </a>
      statement
            before each
      <a class="link" href="create-table.html" title="15.1.20 CREATE TABLE Statement">
       <code class="literal">
        CREATE TABLE
       </code>
      </a>
      statement.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_add-drop-trigger">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_add-drop-trigger">
       <code class="option">
        --add-drop-trigger
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for add-drop-trigger">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --add-drop-trigger
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313673936">
     </a>
     <a class="indexterm" name="idm46045313672448">
     </a>
     <p>
      Write a
      <a class="link" href="drop-trigger.html" title="15.1.34 DROP TRIGGER Statement">
       <code class="literal">
        DROP TRIGGER
       </code>
      </a>
      statement before each
      <a class="link" href="create-trigger.html" title="15.1.22 CREATE TRIGGER Statement">
       <code class="literal">
        CREATE
            TRIGGER
       </code>
      </a>
      statement.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_all-tablespaces">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_all-tablespaces">
       <code class="option">
        --all-tablespaces
       </code>
      </a>
      ,
      <code class="option">
       -Y
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for all-tablespaces">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --all-tablespaces
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313659920">
     </a>
     <a class="indexterm" name="idm46045313658432">
     </a>
     <p>
      Adds to a table dump all SQL statements needed to create any
            tablespaces used by an
      <a class="link" href="mysql-cluster.html" title="Chapter 25 MySQL NDB Cluster 8.4">
       <code class="literal">
        NDB
       </code>
      </a>
      table. This information is not otherwise included in the
            output from
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      . This option is
            currently relevant only to NDB Cluster tables.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_no-create-db">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_no-create-db">
       <code class="option">
        --no-create-db
       </code>
      </a>
      ,
      <code class="option">
       -n
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for no-create-db">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --no-create-db
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313645728">
     </a>
     <a class="indexterm" name="idm46045313644240">
     </a>
     <p>
      Suppress the
      <a class="link" href="create-database.html" title="15.1.12 CREATE DATABASE Statement">
       <code class="literal">
        CREATE DATABASE
       </code>
      </a>
      statements that are otherwise included in the output if the
      <a class="link" href="mysqldump.html#option_mysqldump_databases">
       <code class="option">
        --databases
       </code>
      </a>
      or
      <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
       <code class="option">
        --all-databases
       </code>
      </a>
      option is
            given.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_no-create-info">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_no-create-info">
       <code class="option">
        --no-create-info
       </code>
      </a>
      ,
      <code class="option">
       -t
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for no-create-info">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --no-create-info
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313630880">
     </a>
     <a class="indexterm" name="idm46045313629392">
     </a>
     <p>
      Do not write
      <a class="link" href="create-table.html" title="15.1.20 CREATE TABLE Statement">
       <code class="literal">
        CREATE TABLE
       </code>
      </a>
      statements that create each dumped table.
     </p>
     <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Note
      </div>
      <p>
       This option does
       <span class="emphasis">
        <em>
         not
        </em>
       </span>
       exclude
              statements creating log file groups or tablespaces from
       <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
        <span class="command">
         <strong>
          mysqldump
         </strong>
        </span>
       </a>
       output; however, you can use
              the
       <a class="link" href="mysqldump.html#option_mysqldump_no-tablespaces">
        <code class="option">
         --no-tablespaces
        </code>
       </a>
       option for this purpose.
      </p>
     </div>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_no-tablespaces">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_no-tablespaces">
       <code class="option">
        --no-tablespaces
       </code>
      </a>
      ,
      <code class="option">
       -y
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for no-tablespaces">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --no-tablespaces
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313614464">
     </a>
     <a class="indexterm" name="idm46045313612976">
     </a>
     <p>
      This option suppresses all
      <a class="link" href="create-logfile-group.html" title="15.1.16 CREATE LOGFILE GROUP Statement">
       <code class="literal">
        CREATE
            LOGFILE GROUP
       </code>
      </a>
      and
      <a class="link" href="create-tablespace.html" title="15.1.21 CREATE TABLESPACE Statement">
       <code class="literal">
        CREATE
            TABLESPACE
       </code>
      </a>
      statements in the output of
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_replace">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_replace">
       <code class="option">
        --replace
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for replace">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --replace
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313599472">
     </a>
     <a class="indexterm" name="idm46045313597984">
     </a>
     <p>
      Write
      <a class="link" href="replace.html" title="15.2.12 REPLACE Statement">
       <code class="literal">
        REPLACE
       </code>
      </a>
      statements
            rather than
      <a class="link" href="insert.html" title="15.2.7 INSERT Statement">
       <code class="literal">
        INSERT
       </code>
      </a>
      statements.
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-debug-options">
   </a>
   Debug Options
  </h4>
  <p>
   The following options print debugging information, encode
        debugging information in the dump file, or let the dump
        operation proceed regardless of potential problems.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_allow-keywords">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_allow-keywords">
       <code class="option">
        --allow-keywords
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for allow-keywords">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --allow-keywords
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313583824">
     </a>
     <a class="indexterm" name="idm46045313582336">
     </a>
     <p>
      Permit creation of column names that are keywords. This
            works by prefixing each column name with the table name.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_comments">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_comments">
       <code class="option">
        --comments
       </code>
      </a>
      ,
      <code class="option">
       -i
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for comments">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --comments
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313572144">
     </a>
     <a class="indexterm" name="idm46045313570656">
     </a>
     <p>
      Write additional information in the dump file such as
            program version, server version, and host. This option is
            enabled by default. To suppress this additional information,
            use
      <a class="link" href="mysqldump.html#option_mysqldump_skip-comments">
       <code class="option">
        --skip-comments
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_debug">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_debug">
       <code class="option">
        --debug[=
        <em class="replaceable">
         <code>
          debug_options
         </code>
        </em>
        ]
       </code>
      </a>
      ,
      <code class="option">
       -#
            [
       <em class="replaceable">
        <code>
         debug_options
        </code>
       </em>
       ]
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for debug">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --debug[=debug_options]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           d:t:o,/tmp/mysqldump.trace
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313554176">
     </a>
     <a class="indexterm" name="idm46045313552688">
     </a>
     <p>
      Write a debugging log. A typical
      <em class="replaceable">
       <code>
        debug_options
       </code>
      </em>
      string is
      <code class="literal">
       d:t:o,
       <em class="replaceable">
        <code>
         file_name
        </code>
       </em>
      </code>
      .
            The default value is
      <code class="literal">
       d:t:o,/tmp/mysqldump.trace
      </code>
      .
     </p>
     <p>
      This option is available only if MySQL was built using
      <a class="link" href="source-configuration-options.html#option_cmake_with_debug">
       <code class="option">
        WITH_DEBUG
       </code>
      </a>
      . MySQL release
            binaries provided by Oracle are
      <span class="emphasis">
       <em>
        not
       </em>
      </span>
      built using this option.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_debug-check">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_debug-check">
       <code class="option">
        --debug-check
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for debug-check">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --debug-check
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313534368">
     </a>
     <a class="indexterm" name="idm46045313532880">
     </a>
     <p>
      Print some debugging information when the program exits.
     </p>
     <p>
      This option is available only if MySQL was built using
      <a class="link" href="source-configuration-options.html#option_cmake_with_debug">
       <code class="option">
        WITH_DEBUG
       </code>
      </a>
      . MySQL release
            binaries provided by Oracle are
      <span class="emphasis">
       <em>
        not
       </em>
      </span>
      built using this option.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_debug-info">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_debug-info">
       <code class="option">
        --debug-info
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for debug-info">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --debug-info
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313516768">
     </a>
     <a class="indexterm" name="idm46045313515280">
     </a>
     <p>
      Print debugging information and memory and CPU usage
            statistics when the program exits.
     </p>
     <p>
      This option is available only if MySQL was built using
      <a class="link" href="source-configuration-options.html#option_cmake_with_debug">
       <code class="option">
        WITH_DEBUG
       </code>
      </a>
      . MySQL release
            binaries provided by Oracle are
      <span class="emphasis">
       <em>
        not
       </em>
      </span>
      built using this option.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_dump-date">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_dump-date">
       <code class="option">
        --dump-date
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for dump-date">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --dump-date
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           TRUE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313499120">
     </a>
     <a class="indexterm" name="idm46045313497632">
     </a>
     <p>
      If the
      <a class="link" href="mysqldump.html#option_mysqldump_comments">
       <code class="option">
        --comments
       </code>
      </a>
      option
            is given,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      produces a comment at
            the end of the dump of the following form:
     </p>
     <div class="copytoclipboard-wrapper">
      <pre class="programlisting one-line language-none"><div class="docs-select-all right" id="sa36816070"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-none">-- Dump completed on <em class="replaceable">DATE</em></code></pre>
     </div>
     <p>
      However, the date causes dump files taken at different times
            to appear to be different, even if the data are otherwise
            identical.
      <a class="link" href="mysqldump.html#option_mysqldump_dump-date">
       <code class="option">
        --dump-date
       </code>
      </a>
      and
      <a class="link" href="mysqldump.html#option_mysqldump_dump-date">
       <code class="option">
        --skip-dump-date
       </code>
      </a>
      control whether the date is added to the comment. The
            default is
      <a class="link" href="mysqldump.html#option_mysqldump_dump-date">
       <code class="option">
        --dump-date
       </code>
      </a>
      (include the date in the comment).
      <a class="link" href="mysqldump.html#option_mysqldump_dump-date">
       <code class="option">
        --skip-dump-date
       </code>
      </a>
      suppresses date printing.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_force">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_force">
       <code class="option">
        --force
       </code>
      </a>
      ,
      <code class="option">
       -f
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for force">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --force
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313479296">
     </a>
     <a class="indexterm" name="idm46045313477808">
     </a>
     <p>
      Ignore all errors; continue even if an SQL error occurs
            during a table dump.
     </p>
     <p>
      One use for this option is to cause
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      to continue executing even when
            it encounters a view that has become invalid because the
            definition refers to a table that has been dropped. Without
      <code class="option">
       --force
      </code>
      ,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      exits
            with an error message. With
      <code class="option">
       --force
      </code>
      ,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      prints the error message, but
            it also writes an SQL comment containing the view definition
            to the dump output and continues executing.
     </p>
     <p>
      If the
      <a class="link" href="mysqldump.html#option_mysqldump_ignore-error">
       <code class="option">
        --ignore-error
       </code>
      </a>
      option is also given to ignore specific errors,
      <a class="link" href="mysqldump.html#option_mysqldump_force">
       <code class="option">
        --force
       </code>
      </a>
      takes precedence.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_log-error">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_log-error">
       <code class="option">
        --log-error=
        <em class="replaceable">
         <code>
          file_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for log-error">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --log-error=file_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          File name
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313457920">
     </a>
     <a class="indexterm" name="idm46045313456432">
     </a>
     <p>
      Log warnings and errors by appending them to the named file.
            The default is to do no logging.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_skip-comments">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_skip-comments">
       <code class="option">
        --skip-comments
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for skip-comments">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --skip-comments
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313446704">
     </a>
     <a class="indexterm" name="idm46045313445216">
     </a>
     <p>
      See the description for the
      <a class="link" href="mysqldump.html#option_mysqldump_comments">
       <code class="option">
        --comments
       </code>
      </a>
      option.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_verbose">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_verbose">
       <code class="option">
        --verbose
       </code>
      </a>
      ,
      <code class="option">
       -v
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for verbose">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --verbose
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313434128">
     </a>
     <a class="indexterm" name="idm46045313432640">
     </a>
     <p>
      Verbose mode. Print more information about what the program
            does.
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-help-options">
   </a>
   Help Options
  </h4>
  <p>
   The following options display information about the
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   command itself.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_help">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_help">
       <code class="option">
        --help
       </code>
      </a>
      ,
      <code class="option">
       -?
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for help">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --help
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313419456">
     </a>
     <a class="indexterm" name="idm46045313417968">
     </a>
     <p>
      Display a help message and exit.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_version">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_version">
       <code class="option">
        --version
       </code>
      </a>
      ,
      <code class="option">
       -V
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for version">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --version
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313407856">
     </a>
     <a class="indexterm" name="idm46045313406368">
     </a>
     <p>
      Display version information and exit.
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-i18n-options">
   </a>
   Internationalization Options
  </h4>
  <p>
   The following options change how the
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   command represents character data
        with national language settings.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_character-sets-dir">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_character-sets-dir">
       <code class="option">
        --character-sets-dir=
        <em class="replaceable">
         <code>
          dir_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for character-sets-dir">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --character-sets-dir=dir_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Directory name
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313390272">
     </a>
     <a class="indexterm" name="idm46045313388768">
     </a>
     <p>
      The directory where character sets are installed. See
      <a class="xref" href="charset-configuration.html" title="12.15 Character Set Configuration">
       Section 12.15, “Character Set Configuration”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_default-character-set">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_default-character-set">
       <code class="option">
        --default-character-set=
        <em class="replaceable">
         <code>
          charset_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for default-character-set">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --default-character-set=charset_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           utf8
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313373584">
     </a>
     <a class="indexterm" name="idm46045313372080">
     </a>
     <p>
      Use
      <em class="replaceable">
       <code>
        charset_name
       </code>
      </em>
      as the default
            character set. See
      <a class="xref" href="charset-configuration.html" title="12.15 Character Set Configuration">
       Section 12.15, “Character Set Configuration”
      </a>
      .
            If no character set is specified,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      uses
      <code class="literal">
       utf8mb4
      </code>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_no-set-names">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_no-set-names">
       <code class="option">
        --no-set-names
       </code>
      </a>
      ,
      <code class="option">
       -N
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for no-set-names">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --no-set-names
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Deprecated
         </th>
         <td>
          Yes
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313356864">
     </a>
     <a class="indexterm" name="idm46045313355376">
     </a>
     <p>
      Turns off the
      <a class="link" href="mysqldump.html#option_mysqldump_set-charset">
       <code class="option">
        --set-charset
       </code>
      </a>
      setting, the
            same as specifying
      <code class="option">
       --skip-set-charset
      </code>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_set-charset">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_set-charset">
       <code class="option">
        --set-charset
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for set-charset">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --set-charset
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Disabled by
         </th>
         <td>
          <code class="literal">
           skip-set-charset
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313341824">
     </a>
     <a class="indexterm" name="idm46045313340336">
     </a>
     <p>
      Write
      <a class="link" href="set-names.html" title="15.7.6.3 SET NAMES Statement">
       <code class="literal">
        SET NAMES
        <em class="replaceable">
         <code>
          default_character_set
         </code>
        </em>
       </code>
      </a>
      to the output. This option is enabled by default. To
            suppress the
      <a class="link" href="set-names.html" title="15.7.6.3 SET NAMES Statement">
       <code class="literal">
        SET NAMES
       </code>
      </a>
      statement, use
      <a class="link" href="mysqldump.html#option_mysqldump_set-charset">
       <code class="option">
        --skip-set-charset
       </code>
      </a>
      .
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-replication-options">
   </a>
   Replication Options
  </h4>
  <p>
   The
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   command is frequently used to
        create an empty instance, or an instance including data, on a
        replica server in a replication configuration. The following
        options apply to dumping and restoring data on replication
        source servers and replicas.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_apply-replica-statements">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_apply-replica-statements">
       <code class="option">
        --apply-replica-statements
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for apply-replica-statements">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --apply-replica-statements
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313318064">
     </a>
     <a class="indexterm" name="idm46045313316560">
     </a>
     <p>
      For a replica dump produced with the
      <a class="link" href="mysqldump.html#option_mysqldump_dump-replica">
       <code class="option">
        --dump-replica
       </code>
      </a>
      option,
            this option adds a
      <a class="link" href="stop-replica.html" title="15.4.2.5 STOP REPLICA Statement">
       <code class="literal">
        STOP
            REPLICA
       </code>
      </a>
      statement before the statement with the
            binary log coordinates, and a
      <a class="link" href="start-replica.html" title="15.4.2.4 START REPLICA Statement">
       <code class="literal">
        START
            REPLICA
       </code>
      </a>
      statement at the end of the output.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_apply-slave-statements">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_apply-slave-statements">
       <code class="option">
        --apply-slave-statements
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for apply-slave-statements">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --apply-slave-statements
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Deprecated
         </th>
         <td>
          Yes
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313296768">
     </a>
     <a class="indexterm" name="idm46045313295264">
     </a>
     <p>
      This is a deprecated alias for
      <a class="link" href="mysqldump.html#option_mysqldump_apply-replica-statements">
       <code class="option">
        --apply-replica-statements
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_delete-source-logs">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_delete-source-logs">
       <code class="option">
        --delete-source-logs
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for delete-source-logs">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --delete-source-logs
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313284544">
     </a>
     <a class="indexterm" name="idm46045313283040">
     </a>
     <p>
      On a replication source server, delete the binary logs by
            sending a
      <a class="link" href="purge-binary-logs.html" title="15.4.1.1 PURGE BINARY LOGS Statement">
       <code class="literal">
        PURGE BINARY LOGS
       </code>
      </a>
      statement to the server after performing the dump operation.
            The options require the
      <a class="link" href="privileges-provided.html#priv_reload">
       <code class="literal">
        RELOAD
       </code>
      </a>
      privilege as well as
            privileges sufficient to execute that statement. This option
            automatically enables
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_delete-master-logs">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_delete-master-logs">
       <code class="option">
        --delete-master-logs
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for delete-master-logs">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --delete-master-logs
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Deprecated
         </th>
         <td>
          Yes
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313267616">
     </a>
     <a class="indexterm" name="idm46045313266112">
     </a>
     <p>
      This is a deprecated alias for
      <a class="link" href="mysqldump.html#option_mysqldump_delete-source-logs">
       <code class="option">
        --delete-source-logs
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_dump-replica">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_dump-replica">
       <code class="option">
        --dump-replica[=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
        ]
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for dump-replica">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --dump-replica[=value]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Numeric
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           1
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            1
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            2
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313246816">
     </a>
     <a class="indexterm" name="idm46045313245328">
     </a>
     <p>
      This option is similar to
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      , except that
            it is used to dump a replica server to produce a dump file
            that can be used to set up another server as a replica that
            has the same source as the dumped server. The option causes
            the dump output to include a
      <a class="link" href="change-replication-source-to.html" title="15.4.2.2 CHANGE REPLICATION SOURCE TO Statement">
       <code class="literal">
        CHANGE
            REPLICATION SOURCE TO
       </code>
      </a>
      statement that indicates the
            binary log coordinates (file name and position) of the
            dumped replica's source. The
      <a class="link" href="change-replication-source-to.html" title="15.4.2.2 CHANGE REPLICATION SOURCE TO Statement">
       <code class="literal">
        CHANGE REPLICATION SOURCE TO
       </code>
      </a>
      statement reads the values of
      <code class="literal">
       Relay_Master_Log_File
      </code>
      and
      <code class="literal">
       Exec_Master_Log_Pos
      </code>
      from the
      <a class="link" href="show-replica-status.html" title="15.7.7.35 SHOW REPLICA STATUS Statement">
       <code class="literal">
        SHOW
            REPLICA STATUS
       </code>
      </a>
      output and uses them for
      <code class="literal">
       SOURCE_LOG_FILE
      </code>
      and
      <code class="literal">
       SOURCE_LOG_POS
      </code>
      respectively. These are
            the replication source server coordinates from which the
            replica starts replicating.
     </p>
     <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Note
      </div>
      <p>
       Inconsistencies in the sequence of transactions from the
              relay log which have been executed can cause the wrong
              position to be used. See
       <a class="xref" href="replication-features-transaction-inconsistencies.html" title="19.5.1.34 Replication and Transaction Inconsistencies">
        Section 19.5.1.34, “Replication and Transaction Inconsistencies”
       </a>
       for more information.
      </p>
     </div>
     <p>
      <code class="option">
       --dump-replica
      </code>
      causes the coordinates from
            the source to be used rather than those of the dumped
            server, as is done by the
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      option. In
            addition, specifying this option overrides the
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      option.
     </p>
     <div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Warning
      </div>
      <p>
       <code class="option">
        --dump-replica
       </code>
       should not be used if the
              server where the dump is going to be applied uses
       <a class="link" href="replication-options-gtids.html#sysvar_gtid_mode">
        <code class="literal">
         gtid_mode=ON
        </code>
       </a>
       and
       <code class="literal">
        SOURCE_AUTO_POSITION=1
       </code>
       .
      </p>
     </div>
     <p>
      The option value is handled the same way as for
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      . Setting no
            value or 1 causes a
      <a class="link" href="change-replication-source-to.html" title="15.4.2.2 CHANGE REPLICATION SOURCE TO Statement">
       <code class="literal">
        CHANGE REPLICATION
            SOURCE TO
       </code>
      </a>
      statement to be written to the dump.
            Setting 2 causes the statement to be written but encased in
            SQL comments. It has the same effect as
      <code class="option">
       --source-data
      </code>
      in terms of enabling or
            disabling other options and in how locking is handled.
     </p>
     <p>
      <code class="option">
       --dump-replica
      </code>
      causes
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      to stop the replication SQL
            thread before the dump and restart it again after.
     </p>
     <p>
      <code class="option">
       --dump-replica
      </code>
      sends a
      <a class="link" href="show-replica-status.html" title="15.7.7.35 SHOW REPLICA STATUS Statement">
       <code class="literal">
        SHOW
            REPLICA STATUS
       </code>
      </a>
      statement to the server to obtain
            information, so they require privileges sufficient to
            execute that statement.
     </p>
     <p>
      <a class="link" href="mysqldump.html#option_mysqldump_apply-replica-statements">
       <code class="option">
        --apply-replica-statements
       </code>
      </a>
      and
      <a class="link" href="mysqldump.html#option_mysqldump_include-source-host-port">
       <code class="option">
        --include-source-host-port
       </code>
      </a>
      options can be used in conjunction with
      <code class="option">
       --dump-replica
      </code>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_dump-slave">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_dump-slave">
       <code class="option">
        --dump-slave[=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
        ]
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for dump-slave">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --dump-slave[=value]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Deprecated
         </th>
         <td>
          Yes
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Numeric
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           1
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            1
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            2
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313197840">
     </a>
     <a class="indexterm" name="idm46045313196352">
     </a>
     <p>
      This is a deprecated alias for
      <a class="link" href="mysqldump.html#option_mysqldump_dump-replica">
       <code class="option">
        --dump-replica
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_include-source-host-port">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_include-source-host-port">
       <code class="option">
        --include-source-host-port
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for include-source-host-port">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --include-source-host-port
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313181040">
     </a>
     <a class="indexterm" name="idm46045313179536">
     </a>
     <p>
      Adds the
      <code class="literal">
       SOURCE_HOST
      </code>
      and
      <code class="literal">
       SOURCE_PORT
      </code>
      options for the host name and
            TCP/IP port number of the replica's source, to the
      <a class="link" href="change-replication-source-to.html" title="15.4.2.2 CHANGE REPLICATION SOURCE TO Statement">
       <code class="literal">
        CHANGE REPLICATION SOURCE TO
       </code>
      </a>
      statement in a replica dump produced with the
      <a class="link" href="mysqldump.html#option_mysqldump_dump-replica">
       <code class="option">
        --dump-replica
       </code>
      </a>
      option.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_include-master-host-port">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_include-master-host-port">
       <code class="option">
        --include-master-host-port
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for include-master-host-port">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --include-master-host-port
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Deprecated
         </th>
         <td>
          Yes
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313159440">
     </a>
     <a class="indexterm" name="idm46045313157936">
     </a>
     <p>
      This is a deprecated alias for
      <a class="link" href="mysqldump.html#option_mysqldump_include-source-host-port">
       <code class="option">
        --include-source-host-port
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_master-data">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_master-data">
       <code class="option">
        --master-data[=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
        ]
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for master-data">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --master-data[=value]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Deprecated
         </th>
         <td>
          Yes
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Numeric
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           1
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            1
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            2
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313136640">
     </a>
     <a class="indexterm" name="idm46045313135152">
     </a>
     <p>
      This is a deprecated alias for
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_output-as-version">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_output-as-version">
       <code class="option">
        --output-as-version=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for output-as-version">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --output-as-version=value
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Enumeration
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           SERVER
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            BEFORE_8_0_23
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            BEFORE_8_2_0
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313115952">
     </a>
     <a class="indexterm" name="idm46045313114448">
     </a>
     <p>
      Determines the level of terminology used for statements
            relating to replicas and events, making it possible to
            create dumps compatible with older versions of MySQL that do
            not accept the newer terminology. This option can take any
            one of the following values, with effects described as
            listed here:
     </p>
     <div class="itemizedlist">
      <ul class="itemizedlist" style="list-style-type: circle; ">
       <li class="listitem">
        <p>
         <code class="literal">
          SERVER
         </code>
         : Reads the server version and
                uses the latest versions of statements compatible with
                that version. This is the default value.
        </p>
       </li>
       <li class="listitem">
        <p>
         <code class="literal">
          BEFORE_8_0_23
         </code>
         : Replication SQL
                statements using deprecated terms such as
         <span class="quote">
          “
          <span class="quote">
           slave
          </span>
          ”
         </span>
         and
         <span class="quote">
          “
          <span class="quote">
           master
          </span>
          ”
         </span>
         are
                written to the output in place of those using
         <span class="quote">
          “
          <span class="quote">
           replica
          </span>
          ”
         </span>
         and
         <span class="quote">
          “
          <span class="quote">
           source
          </span>
          ”
         </span>
         , as in
                MySQL versions prior to 8.0.23.
        </p>
        <p>
         This option also duplicates the effects of
         <code class="literal">
          BEFORE_8_2_0
         </code>
         on the output of
         <a class="link" href="show-create-event.html" title="15.7.7.8 SHOW CREATE EVENT Statement">
          <code class="literal">
           SHOW CREATE EVENT
          </code>
         </a>
         .
        </p>
       </li>
       <li class="listitem">
        <p>
         <code class="literal">
          BEFORE_8_2_0
         </code>
         : This option causes
         <a class="link" href="show-create-event.html" title="15.7.7.8 SHOW CREATE EVENT Statement">
          <code class="literal">
           SHOW CREATE EVENT
          </code>
         </a>
         to
                reflect how the event would have been created in a MySQL
                server prior to version 8.2.0, displaying
         <code class="literal">
          DISABLE ON SLAVE
         </code>
         rather than
         <code class="literal">
          DISABLE ON REPLICA
         </code>
         .
        </p>
       </li>
      </ul>
     </div>
     <p>
      This option affects the output from
      <a class="link" href="mysqldump.html#option_mysqldump_events">
       <code class="option">
        --events
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_dump-replica">
       <code class="option">
        --dump-replica
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_apply-replica-statements">
       <code class="option">
        --apply-replica-statements
       </code>
      </a>
      ,
            and
      <a class="link" href="mysqldump.html#option_mysqldump_include-source-host-port">
       <code class="option">
        --include-source-host-port
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_source-data">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data[=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
        ]
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for source-data">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --source-data[=value]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Numeric
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           1
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            1
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            2
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313078048">
     </a>
     <a class="indexterm" name="idm46045313076560">
     </a>
     <p>
      Used to dump a replication source server to produce a dump
            file that can be used to set up another server as a replica
            of the source. The options cause the dump output to include
            a
      <a class="link" href="change-replication-source-to.html" title="15.4.2.2 CHANGE REPLICATION SOURCE TO Statement">
       <code class="literal">
        CHANGE REPLICATION SOURCE
            TO
       </code>
      </a>
      statement that indicates the binary log
            coordinates (file name and position) of the dumped server.
            These are the replication source server coordinates from
            which the replica should start replicating after you load
            the dump file into the replica.
     </p>
     <p>
      If the option value is 2, the
      <a class="link" href="change-replication-source-to.html" title="15.4.2.2 CHANGE REPLICATION SOURCE TO Statement">
       <code class="literal">
        CHANGE
            REPLICATION SOURCE TO
       </code>
      </a>
      statement is written as an
            SQL comment, and thus is informative only; it has no effect
            when the dump file is reloaded. If the option value is 1,
            the statement is not written as a comment and takes effect
            when the dump file is reloaded. If no option value is
            specified, the default value is 1.
     </p>
     <p>
      <code class="option">
       --source-data
      </code>
      sends a
      <a class="link" href="show-binary-log-status.html" title="15.7.7.1 SHOW BINARY LOG STATUS Statement">
       <code class="literal">
        SHOW BINARY LOG STATUS
       </code>
      </a>
      statement to the server to obtain information, so they
            require privileges sufficient to execute that statement.
            This option also requires the
      <a class="link" href="privileges-provided.html#priv_reload">
       <code class="literal">
        RELOAD
       </code>
      </a>
      privilege and the
            binary log must be enabled.
     </p>
     <p>
      <code class="option">
       --source-data
      </code>
      automatically turns off
      <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
       <code class="option">
        --lock-tables
       </code>
      </a>
      . They also
            turn on
      <a class="link" href="mysqldump.html#option_mysqldump_lock-all-tables">
       <code class="option">
        --lock-all-tables
       </code>
      </a>
      ,
            unless
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
      also
            is specified, in which case, a global read lock is acquired
            only for a short time at the beginning of the dump (see the
            description for
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
      ). In
            all cases, any action on logs happens at the exact moment of
            the dump.
     </p>
     <p>
      It is also possible to set up a replica by dumping an
            existing replica of the source, using the
      <a class="link" href="mysqldump.html#option_mysqldump_dump-replica">
       <code class="option">
        --dump-replica
       </code>
      </a>
      option,
            which overrides
      <code class="option">
       --source-data
      </code>
      causing it to
            be ignored.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_set-gtid-purged">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_set-gtid-purged">
       <code class="option">
        --set-gtid-purged=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for set-gtid-purged">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --set-gtid-purged=value
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Enumeration
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           AUTO
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            OFF
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            ON
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            AUTO
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045313042912">
     </a>
     <a class="indexterm" name="idm46045313041424">
     </a>
     <p>
      This option is for servers that use GTID-based replication
            (
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_mode">
       <code class="literal">
        gtid_mode=ON
       </code>
      </a>
      ). It controls
            the inclusion of a
      <code class="literal">
       SET
            @@GLOBAL.gtid_purged
      </code>
      statement in the dump output,
            which updates the value of
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_purged">
       <code class="literal">
        gtid_purged
       </code>
      </a>
      on a server
            where the dump file is reloaded, to add the GTID set from
            the source server's
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
       <code class="literal">
        gtid_executed
       </code>
      </a>
      system
            variable.
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_purged">
       <code class="literal">
        gtid_purged
       </code>
      </a>
      holds
            the GTIDs of all transactions that have been applied on the
            server, but do not exist on any binary log file on the
            server.
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      therefore adds the
            GTIDs for the transactions that were executed on the source
            server, so that the target server records these transactions
            as applied, although it does not have them in its binary
            logs.
      <code class="option">
       --set-gtid-purged
      </code>
      also controls the
            inclusion of a
      <code class="literal">
       SET
            @@SESSION.sql_log_bin=0
      </code>
      statement, which disables
            binary logging while the dump file is being reloaded. This
            statement prevents new GTIDs from being generated and
            assigned to the transactions in the dump file as they are
            executed, so that the original GTIDs for the transactions
            are used.
     </p>
     <p>
      If you do not set the
      <code class="option">
       --set-gtid-purged
      </code>
      option, the default is that a
      <code class="literal">
       SET
            @@GLOBAL.gtid_purged
      </code>
      statement is included in the
            dump output if GTIDs are enabled on the server you are
            backing up, and the set of GTIDs in the global value of the
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
       <code class="literal">
        gtid_executed
       </code>
      </a>
      system
            variable is not empty. A
      <code class="literal">
       SET
            @@SESSION.sql_log_bin=0
      </code>
      statement is also included
            if GTIDs are enabled on the server.
     </p>
     <p>
      You can either replace the value of
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_purged">
       <code class="literal">
        gtid_purged
       </code>
      </a>
      with a
            specified GTID set, or add a plus sign (+) to the statement
            to append a specified GTID set to the GTID set that is
            already held by
      <code class="literal">
       gtid_purged
      </code>
      . The
      <code class="literal">
       SET @@GLOBAL.gtid_purged
      </code>
      statement
            recorded by
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      includes a plus
            sign (
      <code class="literal">
       +
      </code>
      ) in a version-specific comment,
            such that MySQL adds the GTID set from the dump file to the
            existing
      <code class="literal">
       gtid_purged
      </code>
      value.
     </p>
     <p>
      It is important to note that the value that is included by
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      for the
      <code class="literal">
       SET
            @@GLOBAL.gtid_purged
      </code>
      statement includes the GTIDs
            of all transactions in the
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
       <code class="literal">
        gtid_executed
       </code>
      </a>
      set on the
            server, even those that changed suppressed parts of the
            database, or other databases on the server that were not
            included in a partial dump. This can mean that after the
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_purged">
       <code class="literal">
        gtid_purged
       </code>
      </a>
      value has been
            updated on the server where the dump file is replayed, GTIDs
            are present that do not relate to any data on the target
            server. If you do not replay any further dump files on the
            target server, the extraneous GTIDs do not cause any
            problems with the future operation of the server, but they
            make it harder to compare or reconcile GTID sets on
            different servers in the replication topology. If you do
            replay a further dump file on the target server that
            contains the same GTIDs (for example, another partial dump
            from the same origin server), any
      <code class="literal">
       SET
            @@GLOBAL.gtid_purged
      </code>
      statement in the second dump
            file fails. In this case, either remove the statement
            manually before replaying the dump file, or output the dump
            file without the statement.
     </p>
     <p>
      If the
      <code class="literal">
       SET @@GLOBAL.gtid_purged
      </code>
      statement
            would not have the desired result on your target server, you
            can exclude the statement from the output, or include it but
            comment it out so that it is not actioned automatically. You
            can also include the statement but manually edit it in the
            dump file to achieve the desired result.
     </p>
     <p>
      The possible values for the
      <code class="option">
       --set-gtid-purged
      </code>
      option are as follows:
     </p>
     <div class="variablelist">
      <dl class="variablelist">
       <dt>
        <span class="term">
         <code class="literal">
          AUTO
         </code>
        </span>
       </dt>
       <dd>
        <p>
         The default value. If GTIDs are enabled on the server
                  you are backing up and
         <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
          <code class="literal">
           gtid_executed
          </code>
         </a>
         is not
                  empty,
         <code class="literal">
          SET @@GLOBAL.gtid_purged
         </code>
         is
                  added to the output, containing the GTID set from
         <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
          <code class="literal">
           gtid_executed
          </code>
         </a>
         . If
                  GTIDs are enabled,
         <code class="literal">
          SET
                  @@SESSION.sql_log_bin=0
         </code>
         is added to the
                  output. If GTIDs are not enabled on the server, the
                  statements are not added to the output.
        </p>
       </dd>
       <dt>
        <span class="term">
         <code class="literal">
          OFF
         </code>
        </span>
       </dt>
       <dd>
        <p>
         <code class="literal">
          SET @@GLOBAL.gtid_purged
         </code>
         is not
                  added to the output, and
         <code class="literal">
          SET
                  @@SESSION.sql_log_bin=0
         </code>
         is not added to the
                  output. For a server where GTIDs are not in use, use
                  this option or
         <code class="literal">
          AUTO
         </code>
         . Only use this
                  option for a server where GTIDs are in use if you are
                  sure that the required GTID set is already present in
         <a class="link" href="replication-options-gtids.html#sysvar_gtid_purged">
          <code class="literal">
           gtid_purged
          </code>
         </a>
         on the
                  target server and should not be changed, or if you
                  plan to identify and add any missing GTIDs manually.
        </p>
       </dd>
       <dt>
        <span class="term">
         <code class="literal">
          ON
         </code>
        </span>
       </dt>
       <dd>
        <p>
         If GTIDs are enabled on the server you are backing up,
         <code class="literal">
          SET @@GLOBAL.gtid_purged
         </code>
         is added
                  to the output (unless
         <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
          <code class="literal">
           gtid_executed
          </code>
         </a>
         is
                  empty), and
         <code class="literal">
          SET
                  @@SESSION.sql_log_bin=0
         </code>
         is added to the
                  output. An error occurs if you set this option but
                  GTIDs are not enabled on the server. For a server
                  where GTIDs are in use, use this option or
         <code class="literal">
          AUTO
         </code>
         , unless you are sure that the
                  GTIDs in
         <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
          <code class="literal">
           gtid_executed
          </code>
         </a>
         are not
                  needed on the target server.
        </p>
       </dd>
       <dt>
        <span class="term">
         <code class="literal">
          COMMENTED
         </code>
        </span>
       </dt>
       <dd>
        <p>
         If GTIDs are enabled on the server you are backing up,
         <code class="literal">
          SET @@GLOBAL.gtid_purged
         </code>
         is added
                  to the output (unless
         <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
          <code class="literal">
           gtid_executed
          </code>
         </a>
         is
                  empty), but it is commented out. This means that the
                  value of
         <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
          <code class="literal">
           gtid_executed
          </code>
         </a>
         is
                  available in the output, but no action is taken
                  automatically when the dump file is reloaded.
         <code class="literal">
          SET @@SESSION.sql_log_bin=0
         </code>
         is
                  added to the output, and it is not commented out. With
         <code class="literal">
          COMMENTED
         </code>
         , you can control the use
                  of the
         <a class="link" href="replication-options-gtids.html#sysvar_gtid_executed">
          <code class="literal">
           gtid_executed
          </code>
         </a>
         set manually or through automation. For example, you
                  might prefer to do this if you are migrating data to
                  another server that already has different active
                  databases.
        </p>
       </dd>
      </dl>
     </div>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-format-options">
   </a>
   Format Options
  </h4>
  <p>
   The following options specify how to represent the entire dump
        file or certain kinds of data in the dump file. They also
        control whether certain optional information is written to the
        dump file.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_compact">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_compact">
       <code class="option">
        --compact
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for compact">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --compact
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312971936">
     </a>
     <a class="indexterm" name="idm46045312970448">
     </a>
     <p>
      Produce more compact output. This option enables the
      <a class="link" href="mysqldump.html#option_mysqldump_add-drop-table">
       <code class="option">
        --skip-add-drop-table
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_add-locks">
       <code class="option">
        --skip-add-locks
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_skip-comments">
       <code class="option">
        --skip-comments
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_disable-keys">
       <code class="option">
        --skip-disable-keys
       </code>
      </a>
      ,
            and
      <a class="link" href="mysqldump.html#option_mysqldump_set-charset">
       <code class="option">
        --skip-set-charset
       </code>
      </a>
      options.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_compatible">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_compatible">
       <code class="option">
        --compatible=
        <em class="replaceable">
         <code>
          name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for compatible">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --compatible=name[,name,...]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           ''
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Valid Values
         </th>
         <td>
          <p class="valid-value">
           <code class="literal">
            ansi
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            mysql323
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            mysql40
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            postgresql
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            oracle
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            mssql
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            db2
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            maxdb
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            no_key_options
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            no_table_options
           </code>
          </p>
          <p class="valid-value">
           <code class="literal">
            no_key_options
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312938592">
     </a>
     <a class="indexterm" name="idm46045312937104">
     </a>
     <p>
      Produce output that is more compatible with other database
            systems or with older MySQL servers. The only permitted
            value for this option is
      <code class="literal">
       ansi
      </code>
      , which has
            the same meaning as the corresponding option for setting the
            server SQL mode. See
      <a class="xref" href="sql-mode.html" title="7.1.11 Server SQL Modes">
       Section 7.1.11, “Server SQL Modes”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_complete-insert">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_complete-insert">
       <code class="option">
        --complete-insert
       </code>
      </a>
      ,
      <code class="option">
       -c
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for complete-insert">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --complete-insert
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312925424">
     </a>
     <a class="indexterm" name="idm46045312923936">
     </a>
     <p>
      Use complete
      <a class="link" href="insert.html" title="15.2.7 INSERT Statement">
       <code class="literal">
        INSERT
       </code>
      </a>
      statements that include column names.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_create-options">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_create-options">
       <code class="option">
        --create-options
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for create-options">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --create-options
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312913024">
     </a>
     <a class="indexterm" name="idm46045312911536">
     </a>
     <p>
      Include all MySQL-specific table options in the
      <a class="link" href="create-table.html" title="15.1.20 CREATE TABLE Statement">
       <code class="literal">
        CREATE TABLE
       </code>
      </a>
      statements.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_fields">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_fields">
       <code class="option">
        --fields-terminated-by=...
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_fields">
       <code class="option">
        --fields-enclosed-by=...
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_fields">
       <code class="option">
        --fields-optionally-enclosed-by=...
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_fields">
       <code class="option">
        --fields-escaped-by=...
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for fields-terminated-by">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --fields-terminated-by=string
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312895696">
     </a>
     <a class="indexterm" name="idm46045312894192">
     </a>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for fields-enclosed-by">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --fields-enclosed-by=string
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312885104">
     </a>
     <a class="indexterm" name="idm46045312883600">
     </a>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for fields-optionally-enclosed-by">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --fields-optionally-enclosed-by=string
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312874496">
     </a>
     <a class="indexterm" name="idm46045312872992">
     </a>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for fields-escaped-by">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --fields-escaped-by
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312863920">
     </a>
     <a class="indexterm" name="idm46045312862416">
     </a>
     <p>
      These options are used with the
      <a class="link" href="mysqldump.html#option_mysqldump_tab">
       <code class="option">
        --tab
       </code>
      </a>
      option and have the
            same meaning as the corresponding
      <code class="literal">
       FIELDS
      </code>
      clauses for
      <a class="link" href="load-data.html" title="15.2.9 LOAD DATA Statement">
       <code class="literal">
        LOAD DATA
       </code>
      </a>
      . See
      <a class="xref" href="load-data.html" title="15.2.9 LOAD DATA Statement">
       Section 15.2.9, “LOAD DATA Statement”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_hex-blob">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_hex-blob">
       <code class="option">
        --hex-blob
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for hex-blob">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --hex-blob
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312849056">
     </a>
     <a class="indexterm" name="idm46045312847568">
     </a>
     <p>
      Dump binary columns using hexadecimal notation (for example,
      <code class="literal">
       'abc'
      </code>
      becomes
      <code class="literal">
       0x616263
      </code>
      ). The affected data types are
      <a class="link" href="binary-varbinary.html" title="13.3.3 The BINARY and VARBINARY Types">
       <code class="literal">
        BINARY
       </code>
      </a>
      ,
      <a class="link" href="binary-varbinary.html" title="13.3.3 The BINARY and VARBINARY Types">
       <code class="literal">
        VARBINARY
       </code>
      </a>
      ,
      <a class="link" href="blob.html" title="13.3.4 The BLOB and TEXT Types">
       <code class="literal">
        BLOB
       </code>
      </a>
      types,
      <a class="link" href="bit-type.html" title="13.1.5 Bit-Value Type - BIT">
       <code class="literal">
        BIT
       </code>
      </a>
      , all spatial data types,
            and other non-binary data types when used with the
      <a class="link" href="charset-binary-set.html" title="12.10.8 The Binary Character Set">
       <code class="literal">
        binary
       </code>
       character set
      </a>
      .
     </p>
     <p>
      The
      <a class="link" href="mysqldump.html#option_mysqldump_hex-blob">
       <code class="option">
        --hex-blob
       </code>
      </a>
      option is
            ignored when the
      <a class="link" href="mysqldump.html#option_mysqldump_tab">
       <code class="option">
        --tab
       </code>
      </a>
      is
            used.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_lines-terminated-by">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_lines-terminated-by">
       <code class="option">
        --lines-terminated-by=...
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for lines-terminated-by">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --lines-terminated-by=string
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312825280">
     </a>
     <a class="indexterm" name="idm46045312823776">
     </a>
     <p>
      This option is used with the
      <a class="link" href="mysqldump.html#option_mysqldump_tab">
       <code class="option">
        --tab
       </code>
      </a>
      option and has the
            same meaning as the corresponding
      <code class="literal">
       LINES
      </code>
      clause for
      <a class="link" href="load-data.html" title="15.2.9 LOAD DATA Statement">
       <code class="literal">
        LOAD DATA
       </code>
      </a>
      . See
      <a class="xref" href="load-data.html" title="15.2.9 LOAD DATA Statement">
       Section 15.2.9, “LOAD DATA Statement”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_quote-names">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_quote-names">
       <code class="option">
        --quote-names
       </code>
      </a>
      ,
      <code class="option">
       -Q
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for quote-names">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --quote-names
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Disabled by
         </th>
         <td>
          <code class="literal">
           skip-quote-names
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312807552">
     </a>
     <a class="indexterm" name="idm46045312806064">
     </a>
     <p>
      Quote identifiers (such as database, table, and column
            names) within
      <code class="literal">
       `
      </code>
      characters. If the
      <a class="link" href="sql-mode.html#sqlmode_ansi_quotes">
       <code class="literal">
        ANSI_QUOTES
       </code>
      </a>
      SQL mode is
            enabled, identifiers are quoted within
      <code class="literal">
       "
      </code>
      characters. This option is enabled by default. It can be
            disabled with
      <code class="option">
       --skip-quote-names
      </code>
      , but this
            option should be given after any option such as
      <a class="link" href="mysqldump.html#option_mysqldump_compatible">
       <code class="option">
        --compatible
       </code>
      </a>
      that may
            enable
      <a class="link" href="mysqldump.html#option_mysqldump_quote-names">
       <code class="option">
        --quote-names
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_result-file">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_result-file">
       <code class="option">
        --result-file=
        <em class="replaceable">
         <code>
          file_name
         </code>
        </em>
       </code>
      </a>
      ,
      <code class="option">
       -r
       <em class="replaceable">
        <code>
         file_name
        </code>
       </em>
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for result-file">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --result-file=file_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          File name
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312788064">
     </a>
     <a class="indexterm" name="idm46045312786576">
     </a>
     <p>
      Direct output to the named file. The result file is created
            and its previous contents overwritten, even if an error
            occurs while generating the dump.
     </p>
     <p>
      This option should be used on Windows to prevent newline
      <code class="literal">
       \n
      </code>
      characters from being converted to
      <code class="literal">
       \r\n
      </code>
      carriage return/newline sequences.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_show-create-skip-secondary-engine">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_show-create-skip-secondary-engine">
       <code class="option">
        --show-create-skip-secondary-engine=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for show-create-skip-secondary-engine">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --show-create-skip-secondary-engine
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312774432">
     </a>
     <a class="indexterm" name="idm46045312772912">
     </a>
     <p>
      Excludes the
      <code class="literal">
       SECONDARY ENGINE
      </code>
      clause from
      <a class="link" href="create-table.html" title="15.1.20 CREATE TABLE Statement">
       <code class="literal">
        CREATE TABLE
       </code>
      </a>
      statements. It
            does so by enabling the
      <a class="link" href="server-system-variables.html#sysvar_show_create_table_skip_secondary_engine">
       <code class="literal">
        show_create_table_skip_secondary_engine
       </code>
      </a>
      system variable for the duration of the dump operation.
            Alternatively, you can enable the
      <a class="link" href="server-system-variables.html#sysvar_show_create_table_skip_secondary_engine">
       <code class="literal">
        show_create_table_skip_secondary_engine
       </code>
      </a>
      system variable prior to using
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_tab">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_tab">
       <code class="option">
        --tab=
        <em class="replaceable">
         <code>
          dir_name
         </code>
        </em>
       </code>
      </a>
      ,
      <code class="option">
       -T
       <em class="replaceable">
        <code>
         dir_name
        </code>
       </em>
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for tab">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --tab=dir_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Directory name
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312754112">
     </a>
     <a class="indexterm" name="idm46045312752624">
     </a>
     <p>
      Produce tab-separated text-format data files. For each
            dumped table,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      creates a
      <code class="filename">
       <em class="replaceable">
        <code>
         tbl_name
        </code>
       </em>
       .sql
      </code>
      file that contains the
      <a class="link" href="create-table.html" title="15.1.20 CREATE TABLE Statement">
       <code class="literal">
        CREATE
            TABLE
       </code>
      </a>
      statement that creates the table, and the
            server writes a
      <code class="filename">
       <em class="replaceable">
        <code>
         tbl_name
        </code>
       </em>
       .txt
      </code>
      file that contains its data. The option value is the
            directory in which to write the files.
     </p>
     <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Note
      </div>
      <p>
       This option should be used only when
       <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
        <span class="command">
         <strong>
          mysqldump
         </strong>
        </span>
       </a>
       is run on the same machine as
              the
       <a class="link" href="mysqld.html" title="6.3.1 mysqld — The MySQL Server">
        <span class="command">
         <strong>
          mysqld
         </strong>
        </span>
       </a>
       server. Because the server
              creates
       <code class="filename">
        *.txt
       </code>
       files in the directory
              that you specify, the directory must be writable by the
              server and the MySQL account that you use must have the
       <a class="link" href="privileges-provided.html#priv_file">
        <code class="literal">
         FILE
        </code>
       </a>
       privilege. Because
       <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
        <span class="command">
         <strong>
          mysqldump
         </strong>
        </span>
       </a>
       creates
       <code class="filename">
        *.sql
       </code>
       in the same directory, it must
              be writable by your system login account.
      </p>
     </div>
     <p>
      By default, the
      <code class="filename">
       .txt
      </code>
      data files are
            formatted using tab characters between column values and a
            newline at the end of each line. The format can be specified
            explicitly using the
      <code class="option">
       --fields-
       <em class="replaceable">
        <code>
         xxx
        </code>
       </em>
      </code>
      and
      <a class="link" href="mysqldump.html#option_mysqldump_lines-terminated-by">
       <code class="option">
        --lines-terminated-by
       </code>
      </a>
      options.
     </p>
     <p>
      Column values are converted to the character set specified
            by the
      <a class="link" href="mysqldump.html#option_mysqldump_default-character-set">
       <code class="option">
        --default-character-set
       </code>
      </a>
      option.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_tz-utc">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_tz-utc">
       <code class="option">
        --tz-utc
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for tz-utc">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --tz-utc
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Disabled by
         </th>
         <td>
          <code class="literal">
           skip-tz-utc
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312723648">
     </a>
     <a class="indexterm" name="idm46045312722160">
     </a>
     <p>
      This option enables
      <a class="link" href="datetime.html" title="13.2.2 The DATE, DATETIME, and TIMESTAMP Types">
       <code class="literal">
        TIMESTAMP
       </code>
      </a>
      columns to be dumped and reloaded between servers in
            different time zones.
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      sets its
            connection time zone to UTC and adds
      <code class="literal">
       SET
            TIME_ZONE='+00:00'
      </code>
      to the dump file. Without this
            option,
      <a class="link" href="datetime.html" title="13.2.2 The DATE, DATETIME, and TIMESTAMP Types">
       <code class="literal">
        TIMESTAMP
       </code>
      </a>
      columns are
            dumped and reloaded in the time zones local to the source
            and destination servers, which can cause the values to
            change if the servers are in different time zones.
      <code class="option">
       --tz-utc
      </code>
      also protects against changes due
            to daylight saving time.
      <code class="option">
       --tz-utc
      </code>
      is
            enabled by default. To disable it, use
      <code class="option">
       --skip-tz-utc
      </code>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_xml">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_xml">
       <code class="option">
        --xml
       </code>
      </a>
      ,
      <code class="option">
       -X
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for xml">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --xml
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312705968">
     </a>
     <a class="indexterm" name="idm46045312704480">
     </a>
     <p>
      Write dump output as well-formed XML.
     </p>
     <p>
      <span class="bold">
       <strong>
        <code class="literal">
         NULL
        </code>
        ,
        <code class="literal">
         'NULL'
        </code>
        , and Empty Values
       </strong>
      </span>
      : For
            a column named
      <em class="replaceable">
       <code>
        column_name
       </code>
      </em>
      , the
      <code class="literal">
       NULL
      </code>
      value, an empty string, and the
            string value
      <code class="literal">
       'NULL'
      </code>
      are distinguished
            from one another in the output generated by this option as
            follows.
     </p>
     <div class="informaltable">
      <table summary="For a column named column_name, the NULL value, an empty string, and the string value 'NULL' are distinguished from one another in the XML output generated by the mysqldump --xml, -X option, as shown in this table.">
       <colgroup>
        <col style="width: 50%"/>
        <col style="width: 50%"/>
       </colgroup>
       <thead>
        <tr>
         <th>
          Value:
         </th>
         <th>
          XML Representation:
         </th>
        </tr>
       </thead>
       <tbody>
        <tr>
         <td>
          <code class="literal">
           NULL
          </code>
          (
          <span class="emphasis">
           <em>
            unknown value
           </em>
          </span>
          )
         </td>
         <td>
          <p>
           <code class="literal">
            &lt;field
                    name="
            <em class="replaceable">
             <code>
              column_name
             </code>
            </em>
            "
                    xsi:nil="true" /&gt;
           </code>
          </p>
         </td>
        </tr>
        <tr>
         <td>
          <code class="literal">
           ''
          </code>
          (
          <span class="emphasis">
           <em>
            empty string
           </em>
          </span>
          )
         </td>
         <td>
          <p>
           <code class="literal">
            &lt;field
                    name="
            <em class="replaceable">
             <code>
              column_name
             </code>
            </em>
            "&gt;&lt;/field&gt;
           </code>
          </p>
         </td>
        </tr>
        <tr>
         <td>
          <code class="literal">
           'NULL'
          </code>
          (
          <span class="emphasis">
           <em>
            string value
           </em>
          </span>
          )
         </td>
         <td>
          <p>
           <code class="literal">
            &lt;field
                    name="
            <em class="replaceable">
             <code>
              column_name
             </code>
            </em>
            "&gt;NULL&lt;/field&gt;
           </code>
          </p>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <p>
      The output from the
      <a class="link" href="mysql.html" title="6.5.1 mysql — The MySQL Command-Line Client">
       <span class="command">
        <strong>
         mysql
        </strong>
       </span>
      </a>
      client when run
            using the
      <a class="link" href="mysql-command-options.html#option_mysql_xml">
       <code class="option">
        --xml
       </code>
      </a>
      option also
            follows the preceding rules. (See
      <a class="xref" href="mysql-command-options.html" title="6.5.1.1 mysql Client Options">
       Section 6.5.1.1, “mysql Client Options”
      </a>
      .)
     </p>
     <p>
      XML output from
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      includes the
            XML namespace, as shown here:
     </p>
     <div class="copytoclipboard-wrapper">
      <pre class="programlisting language-terminal"><div class="docs-select-all right" id="sa12943407"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal"><span class="token prompt">$&gt; </span><span class="token command">mysqldump</span> <span class="token property">--xml</span> <span class="token property">-u</span> root world City
&lt;?xml version=<span class="token atrule">"1.0"</span>?&gt;
&lt;mysqldump xmlns<span class="token punctuation">:</span>xsi=<span class="token atrule">"http://www.w3.org/2001/XMLSchema-instance"</span>&gt;
&lt;database name=<span class="token atrule">"world"</span>&gt;
&lt;table_structure name=<span class="token atrule">"City"</span>&gt;
&lt;field Field=<span class="token atrule">"ID"</span> Type=<span class="token atrule">"int(11)"</span> Null=<span class="token atrule">"NO"</span> Key=<span class="token atrule">"PRI"</span> Extra=<span class="token atrule">"auto_increment"</span> /&gt;
&lt;field Field=<span class="token atrule">"Name"</span> Type=<span class="token atrule">"char(35)"</span> Null=<span class="token atrule">"NO"</span> Key=<span class="token atrule">""</span> Default=<span class="token atrule">""</span> Extra=<span class="token atrule">""</span> /&gt;
&lt;field Field=<span class="token atrule">"CountryCode"</span> Type=<span class="token atrule">"char(3)"</span> Null=<span class="token atrule">"NO"</span> Key=<span class="token atrule">""</span> Default=<span class="token atrule">""</span> Extra=<span class="token atrule">""</span> /&gt;
&lt;field Field=<span class="token atrule">"District"</span> Type=<span class="token atrule">"char(20)"</span> Null=<span class="token atrule">"NO"</span> Key=<span class="token atrule">""</span> Default=<span class="token atrule">""</span> Extra=<span class="token atrule">""</span> /&gt;
&lt;field Field=<span class="token atrule">"Population"</span> Type=<span class="token atrule">"int(11)"</span> Null=<span class="token atrule">"NO"</span> Key=<span class="token atrule">""</span> Default=<span class="token atrule">"0"</span> Extra=<span class="token atrule">""</span> /&gt;
&lt;key Table=<span class="token atrule">"City"</span> Non_unique=<span class="token atrule">"0"</span> Key_name=<span class="token atrule">"PRIMARY"</span> Seq_in_index=<span class="token atrule">"1"</span> Column_name=<span class="token atrule">"ID"</span>
Collation=<span class="token atrule">"A"</span> Cardinality=<span class="token atrule">"4079"</span> Null=<span class="token atrule">""</span> Index_type=<span class="token atrule">"BTREE"</span> Comment=<span class="token atrule">""</span> /&gt;
&lt;options Name=<span class="token atrule">"City"</span> Engine=<span class="token atrule">"MyISAM"</span> Version=<span class="token atrule">"10"</span> Row_format=<span class="token atrule">"Fixed"</span> Rows=<span class="token atrule">"4079"</span>
Avg_row_length=<span class="token atrule">"67"</span> Data_length=<span class="token atrule">"273293"</span> Max_data_length=<span class="token atrule">"18858823439613951"</span>
Index_length=<span class="token atrule">"43008"</span> Data_free=<span class="token atrule">"0"</span> Auto_increment=<span class="token atrule">"4080"</span>
Create_time=<span class="token atrule">"2007-03-31 01:47:01"</span> Update_time=<span class="token atrule">"2007-03-31 01:47:02"</span>
Collation=<span class="token atrule">"latin1_swedish_ci"</span> Create_options=<span class="token atrule">""</span> Comment=<span class="token atrule">""</span> /&gt;
&lt;/table_structure&gt;
&lt;table_data name=<span class="token atrule">"City"</span>&gt;
&lt;row&gt;
&lt;field name=<span class="token atrule">"ID"</span>&gt;1&lt;/field&gt;
&lt;field name=<span class="token atrule">"Name"</span>&gt;Kabul&lt;/field&gt;
&lt;field name=<span class="token atrule">"CountryCode"</span>&gt;AFG&lt;/field&gt;
&lt;field name=<span class="token atrule">"District"</span>&gt;Kabol&lt;/field&gt;
&lt;field name=<span class="token atrule">"Population"</span>&gt;1780000&lt;/field&gt;
&lt;/row&gt;

<span class="token punctuation"></span><em class="replaceable"><span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span></em><span class="token punctuation"></span>

&lt;row&gt;
&lt;field name=<span class="token atrule">"ID"</span>&gt;4079&lt;/field&gt;
&lt;field name=<span class="token atrule">"Name"</span>&gt;Rafah&lt;/field&gt;
&lt;field name=<span class="token atrule">"CountryCode"</span>&gt;PSE&lt;/field&gt;
&lt;field name=<span class="token atrule">"District"</span>&gt;Rafah&lt;/field&gt;
&lt;field name=<span class="token atrule">"Population"</span>&gt;92020&lt;/field&gt;
&lt;/row&gt;
&lt;/table_data&gt;
&lt;/database&gt;
&lt;/mysqldump&gt;</code></pre>
     </div>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-filter-options">
   </a>
   Filtering Options
  </h4>
  <p>
   The following options control which kinds of schema objects are
        written to the dump file: by category, such as triggers or
        events; by name, for example, choosing which databases and
        tables to dump; or even filtering rows from the table data using
        a
   <code class="literal">
    WHERE
   </code>
   clause.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_all-databases">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
       <code class="option">
        --all-databases
       </code>
      </a>
      ,
      <code class="option">
       -A
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for all-databases">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --all-databases
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312659360">
     </a>
     <a class="indexterm" name="idm46045312657872">
     </a>
     <p>
      Dump all tables in all databases. This is the same as using
            the
      <a class="link" href="mysqldump.html#option_mysqldump_databases">
       <code class="option">
        --databases
       </code>
      </a>
      option and
            naming all the databases on the command line.
     </p>
     <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Note
      </div>
      <p>
       See the
       <a class="link" href="mysqldump.html#option_mysqldump_add-drop-database">
        <code class="option">
         --add-drop-database
        </code>
       </a>
       description for information about an incompatibility of
              that option with
       <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
        <code class="option">
         --all-databases
        </code>
       </a>
       .
      </p>
     </div>
     <p>
      Prior to MySQL 8.4, the
      <a class="link" href="mysqldump.html#option_mysqldump_routines">
       <code class="option">
        --routines
       </code>
      </a>
      and
      <a class="link" href="mysqldump.html#option_mysqldump_events">
       <code class="option">
        --events
       </code>
      </a>
      options for
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      were not required to include
            stored routines and events when using the
      <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
       <code class="option">
        --all-databases
       </code>
      </a>
      option:
            The dump included the
      <code class="literal">
       mysql
      </code>
      system
            database, and therefore also the
      <code class="literal">
       mysql.proc
      </code>
      and
      <code class="literal">
       mysql.event
      </code>
      tables containing stored
            routine and event definitions. As of MySQL 8.4,
            the
      <code class="literal">
       mysql.event
      </code>
      and
      <code class="literal">
       mysql.proc
      </code>
      tables are not used.
            Definitions for the corresponding objects are stored in data
            dictionary tables, but those tables are not dumped. To
            include stored routines and events in a dump made using
      <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
       <code class="option">
        --all-databases
       </code>
      </a>
      , use the
      <a class="link" href="mysqldump.html#option_mysqldump_routines">
       <code class="option">
        --routines
       </code>
      </a>
      and
      <a class="link" href="mysqldump.html#option_mysqldump_events">
       <code class="option">
        --events
       </code>
      </a>
      options
            explicitly.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_databases">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_databases">
       <code class="option">
        --databases
       </code>
      </a>
      ,
      <code class="option">
       -B
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for databases">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --databases
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312632128">
     </a>
     <a class="indexterm" name="idm46045312630640">
     </a>
     <p>
      Dump several databases. Normally,
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      treats the first name argument
            on the command line as a database name and following names
            as table names. With this option, it treats all name
            arguments as database names.
      <a class="link" href="create-database.html" title="15.1.12 CREATE DATABASE Statement">
       <code class="literal">
        CREATE
            DATABASE
       </code>
      </a>
      and
      <a class="link" href="use.html" title="15.8.4 USE Statement">
       <code class="literal">
        USE
       </code>
      </a>
      statements are included in the output before each new
            database.
     </p>
     <p>
      This option may be used to dump the
      <code class="literal">
       performance_schema
      </code>
      database, which
            normally is not dumped even with the
      <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
       <code class="option">
        --all-databases
       </code>
      </a>
      option.
            (Also use the
      <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
       <code class="option">
        --skip-lock-tables
       </code>
      </a>
      option.)
     </p>
     <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Note
      </div>
      <p>
       See the
       <a class="link" href="mysqldump.html#option_mysqldump_add-drop-database">
        <code class="option">
         --add-drop-database
        </code>
       </a>
       description for information about an incompatibility of
              that option with
       <a class="link" href="mysqldump.html#option_mysqldump_databases">
        <code class="option">
         --databases
        </code>
       </a>
       .
      </p>
     </div>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_events">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_events">
       <code class="option">
        --events
       </code>
      </a>
      ,
      <code class="option">
       -E
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for events">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --events
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312610544">
     </a>
     <a class="indexterm" name="idm46045312609056">
     </a>
     <p>
      Include Event Scheduler events for the dumped databases in
            the output. This option requires the
      <a class="link" href="privileges-provided.html#priv_event">
       <code class="literal">
        EVENT
       </code>
      </a>
      privileges for those
            databases.
     </p>
     <p>
      The output generated by using
      <code class="option">
       --events
      </code>
      contains
      <a class="link" href="create-event.html" title="15.1.13 CREATE EVENT Statement">
       <code class="literal">
        CREATE EVENT
       </code>
      </a>
      statements to create the events.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_ignore-error">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_ignore-error">
       <code class="option">
        --ignore-error=
        <em class="replaceable">
         <code>
          error[,error]...
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for ignore-error">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --ignore-error=error[,error]...
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312593360">
     </a>
     <a class="indexterm" name="idm46045312591872">
     </a>
     <p>
      Ignore the specified errors. The option value is a list of
            comma-separated error numbers specifying the errors to
            ignore during
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      execution. If the
      <a class="link" href="mysqldump.html#option_mysqldump_force">
       <code class="option">
        --force
       </code>
      </a>
      option is also
            given to ignore all errors,
      <a class="link" href="mysqldump.html#option_mysqldump_force">
       <code class="option">
        --force
       </code>
      </a>
      takes precedence.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_ignore-table">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_ignore-table">
       <code class="option">
        --ignore-table=
        <em class="replaceable">
         <code>
          db_name.tbl_name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for ignore-table">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --ignore-table=db_name.tbl_name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312576528">
     </a>
     <a class="indexterm" name="idm46045312575040">
     </a>
     <p>
      Do not dump the given table, which must be specified using
            both the database and table names. To ignore multiple
            tables, use this option multiple times. This option also can
            be used to ignore views.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_ignore-views">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_ignore-views">
       <code class="option">
        --ignore-views=
        <em class="replaceable">
         <code>
          boolean
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for ignore-views">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --ignore-views
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312560400">
     </a>
     <a class="indexterm" name="idm46045312558912">
     </a>
     <p>
      Skips table views in the dump file.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_init-command">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_init-command">
       <code class="option">
        --init-command=
        <em class="replaceable">
         <code>
          str
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for init-command">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --init-command=str
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312546944">
     </a>
     <a class="indexterm" name="idm46045312545456">
     </a>
     <p>
      Single SQL statement to execute after connecting to the
            MySQL server. The definition resets existing statements
            defined by it or
      <a class="link" href="mysqldump.html#option_mysqldump_init-command-add">
       <code class="option">
        init-command-add
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_init-command-add">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_init-command-add">
       <code class="option">
        --init-command-add=
        <em class="replaceable">
         <code>
          str
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for init-command-add">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --init-command-add=str
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          String
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312532384">
     </a>
     <a class="indexterm" name="idm46045312530896">
     </a>
     <p>
      Add an additional SQL statement to execute after connecting
            or reconnecting to the MySQL server. It's usable without
      <a class="link" href="mysqldump.html#option_mysqldump_init-command">
       <code class="option">
        --init-command
       </code>
      </a>
      but has no
            effect if used before it because
      <a class="link" href="mysqldump.html#option_mysqldump_init-command">
       <code class="option">
        init-command
       </code>
      </a>
      resets the
            list of commands to call.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_no-data">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_no-data">
       <code class="option">
        --no-data
       </code>
      </a>
      ,
      <code class="option">
       -d
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for no-data">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --no-data
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312518608">
     </a>
     <a class="indexterm" name="idm46045312517120">
     </a>
     <p>
      Do not write any table row information (that is, do not dump
            table contents). This is useful if you want to dump only the
      <a class="link" href="create-table.html" title="15.1.20 CREATE TABLE Statement">
       <code class="literal">
        CREATE TABLE
       </code>
      </a>
      statement for
            the table (for example, to create an empty copy of the table
            by loading the dump file).
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_routines">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_routines">
       <code class="option">
        --routines
       </code>
      </a>
      ,
      <code class="option">
       -R
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for routines">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --routines
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312505600">
     </a>
     <a class="indexterm" name="idm46045312504112">
     </a>
     <p>
      Include stored routines (procedures and functions) for the
            dumped databases in the output. This option requires the
            global
      <a class="link" href="privileges-provided.html#priv_select">
       <code class="literal">
        SELECT
       </code>
      </a>
      privilege.
     </p>
     <p>
      The output generated by using
      <code class="option">
       --routines
      </code>
      contains
      <a class="link" href="create-procedure.html" title="15.1.17 CREATE PROCEDURE and CREATE FUNCTION Statements">
       <code class="literal">
        CREATE PROCEDURE
       </code>
      </a>
      and
      <a class="link" href="create-function.html" title="15.1.14 CREATE FUNCTION Statement">
       <code class="literal">
        CREATE FUNCTION
       </code>
      </a>
      statements to
            create the routines.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_skip-generated-invisible-primary-key">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_skip-generated-invisible-primary-key">
       <code class="option">
        --skip-generated-invisible-primary-key
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for skip-generated-invisible-primary-key">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --skip-generated-invisible-primary-key
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           FALSE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312485104">
     </a>
     <a class="indexterm" name="idm46045312483584">
     </a>
     <p>
      This option causes generated invisible primary keys to be
            excluded from the output. For more information, see
      <a class="xref" href="create-table-gipks.html" title="15.1.20.11 Generated Invisible Primary Keys">
       Section 15.1.20.11, “Generated Invisible Primary Keys”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_tables">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_tables">
       <code class="option">
        --tables
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for tables">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --tables
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312473152">
     </a>
     <a class="indexterm" name="idm46045312471664">
     </a>
     <p>
      Override the
      <a class="link" href="mysqldump.html#option_mysqldump_databases">
       <code class="option">
        --databases
       </code>
      </a>
      or
      <code class="option">
       -B
      </code>
      option.
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      regards all name arguments following the option as table
            names.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_triggers">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_triggers">
       <code class="option">
        --triggers
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for triggers">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --triggers
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Disabled by
         </th>
         <td>
          <code class="literal">
           skip-triggers
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312456832">
     </a>
     <a class="indexterm" name="idm46045312455344">
     </a>
     <p>
      Include triggers for each dumped table in the output. This
            option is enabled by default; disable it with
      <code class="option">
       --skip-triggers
      </code>
      .
     </p>
     <p>
      To be able to dump a table's triggers, you must have the
      <a class="link" href="privileges-provided.html#priv_trigger">
       <code class="literal">
        TRIGGER
       </code>
      </a>
      privilege for the
            table.
     </p>
     <p>
      Multiple triggers are permitted.
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      dumps triggers in activation
            order so that when the dump file is reloaded, triggers are
            created in the same activation order. However, if a
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      dump file contains multiple
            triggers for a table that have the same trigger event and
            action time, an error occurs for attempts to load the dump
            file into an older server that does not support multiple
            triggers. (For a workaround, see
      <a class="ulink" href="/doc/refman/5.7/en/downgrading-to-previous-series.html" target="_top">
       Downgrade Notes
      </a>
      ;
            you can convert triggers to be compatible with older
            servers.)
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_where">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_where">
       <code class="option">
        --where='
        <em class="replaceable">
         <code>
          where_condition
         </code>
        </em>
        '
       </code>
      </a>
      ,
      <code class="option">
       -w
            '
       <em class="replaceable">
        <code>
         where_condition
        </code>
       </em>
       '
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for where">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --where='where_condition'
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312438000">
     </a>
     <a class="indexterm" name="idm46045312436512">
     </a>
     <p>
      Dump only rows selected by the given
      <code class="literal">
       WHERE
      </code>
      condition. Quotes around the
            condition are mandatory if it contains spaces or other
            characters that are special to your command interpreter.
     </p>
     <p>
      Examples:
     </p>
     <div class="copytoclipboard-wrapper">
      <pre class="programlisting language-terminal"><div class="docs-select-all right" id="sa86878796"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal"><span class="token constant">--where</span>=<span class="token atrule">"user='jimf'"</span>
<span class="token property">-w</span><span class="token atrule">"userid&gt;1"</span>
<span class="token property">-w</span><span class="token atrule">"userid&lt;1"</span></code></pre>
     </div>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-performance-options">
   </a>
   Performance Options
  </h4>
  <p>
   The following options are the most relevant for the performance
        particularly of the restore operations. For large data sets,
        restore operation (processing the
   <code class="literal">
    INSERT
   </code>
   statements in the dump file) is the most time-consuming part.
        When it is urgent to restore data quickly, plan and test the
        performance of this stage in advance. For restore times measured
        in hours, you might prefer an alternative backup and restore
        solution, such as
   <a class="link" href="mysql-enterprise-backup.html" title="32.1 MySQL Enterprise Backup Overview">
    MySQL Enterprise Backup
   </a>
   for
   <code class="literal">
    InnoDB
   </code>
   -only and mixed-use databases.
  </p>
  <p>
   Performance is also affected by the
   <a class="link" href="mysqldump.html#mysqldump-transaction-options" title="Transactional Options">
    transactional
        options
   </a>
   , primarily for the dump operation.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_column-statistics">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_column-statistics">
       <code class="option">
        --column-statistics
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for column-statistics">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --column-statistics
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           OFF
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312412272">
     </a>
     <a class="indexterm" name="idm46045312410768">
     </a>
     <p>
      Add
      <a class="link" href="analyze-table.html" title="15.7.3.1 ANALYZE TABLE Statement">
       <code class="literal">
        ANALYZE TABLE
       </code>
      </a>
      statements
            to the output to generate histogram statistics for dumped
            tables when the dump file is reloaded. This option is
            disabled by default because histogram generation for large
            tables can take a long time.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_disable-keys">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_disable-keys">
       <code class="option">
        --disable-keys
       </code>
      </a>
      ,
      <code class="option">
       -K
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for disable-keys">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --disable-keys
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312399184">
     </a>
     <a class="indexterm" name="idm46045312397696">
     </a>
     <p>
      For each table, surround the
      <a class="link" href="insert.html" title="15.2.7 INSERT Statement">
       <code class="literal">
        INSERT
       </code>
      </a>
      statements with
      <code class="literal">
       /*!40000 ALTER TABLE
       <em class="replaceable">
        <code>
         tbl_name
        </code>
       </em>
       DISABLE KEYS
            */;
      </code>
      and
      <code class="literal">
       /*!40000 ALTER TABLE
       <em class="replaceable">
        <code>
         tbl_name
        </code>
       </em>
       ENABLE KEYS
            */;
      </code>
      statements. This makes loading the dump file
            faster because the indexes are created after all rows are
            inserted. This option is effective only for nonunique
            indexes of
      <code class="literal">
       MyISAM
      </code>
      tables.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_extended-insert">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_extended-insert">
       <code class="option">
        --extended-insert
       </code>
      </a>
      ,
      <code class="option">
       -e
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for extended-insert">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --extended-insert
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Disabled by
         </th>
         <td>
          <code class="literal">
           skip-extended-insert
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312380624">
     </a>
     <a class="indexterm" name="idm46045312379136">
     </a>
     <p>
      Write
      <a class="link" href="insert.html" title="15.2.7 INSERT Statement">
       <code class="literal">
        INSERT
       </code>
      </a>
      statements using
            multiple-row syntax that includes several
      <code class="literal">
       VALUES
      </code>
      lists. This results in a smaller
            dump file and speeds up inserts when the file is reloaded.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_insert-ignore">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_insert-ignore">
       <code class="option">
        --insert-ignore
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for insert-ignore">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --insert-ignore
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312367408">
     </a>
     <a class="indexterm" name="idm46045312365920">
     </a>
     <p>
      Write
      <a class="link" href="insert.html" title="15.2.7 INSERT Statement">
       <code class="literal">
        INSERT
            IGNORE
       </code>
      </a>
      statements rather than
      <a class="link" href="insert.html" title="15.2.7 INSERT Statement">
       <code class="literal">
        INSERT
       </code>
      </a>
      statements.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_max-allowed-packet">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_max-allowed-packet">
       <code class="option">
        --max-allowed-packet=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for max-allowed-packet">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --max-allowed-packet=value
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Numeric
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           25165824
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312349008">
     </a>
     <a class="indexterm" name="idm46045312347504">
     </a>
     <p>
      The maximum size of the buffer for client/server
            communication. The default is 24MB, the maximum is 1GB.
     </p>
     <div class="note" style="margin-left: 0.5in; margin-right: 0.5in;">
      <div class="admon-title">
       Note
      </div>
      <p>
       The value of this option is specific to
       <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
        <span class="command">
         <strong>
          mysqldump
         </strong>
        </span>
       </a>
       and should not be confused
              with the MySQL server's
       <a class="link" href="server-system-variables.html#sysvar_max_allowed_packet">
        <code class="literal">
         max_allowed_packet
        </code>
       </a>
       system
              variable; the server value cannot be exceeded by a single
              packet from
       <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
        <span class="command">
         <strong>
          mysqldump
         </strong>
        </span>
       </a>
       , regardless of
              any setting for the
       <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
        <span class="command">
         <strong>
          mysqldump
         </strong>
        </span>
       </a>
       option,
              even if the latter is larger.
      </p>
     </div>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_mysqld-long-query-time">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_mysqld-long-query-time">
       <code class="option">
        --mysqld-long-query-time=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for mysqld-long-query-time">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --mysqld-long-query-time=value
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Numeric
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           Server global setting
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312326704">
     </a>
     <a class="indexterm" name="idm46045312325200">
     </a>
     <p>
      Set the session value of the
      <a class="link" href="server-system-variables.html#sysvar_long_query_time">
       <code class="literal">
        long_query_time
       </code>
      </a>
      system
            variable. Use this option if you want to increase the time
            allowed for queries from
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      before
            they are logged to the slow query log file.
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      performs a full table scan,
            which means its queries can often exceed a global
      <a class="link" href="server-system-variables.html#sysvar_long_query_time">
       <code class="literal">
        long_query_time
       </code>
      </a>
      setting that is useful for regular queries. The default
            global setting is 10 seconds.
     </p>
     <p>
      You can use
      <a class="link" href="mysqldump.html#option_mysqldump_mysqld-long-query-time">
       <code class="option">
        --mysqld-long-query-time
       </code>
      </a>
      to specify a session value from 0 (meaning that every query
            from
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      is logged to the slow
            query log) to 31536000, which is 365 days in seconds. For
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      ’s option, you can only
            specify whole seconds. When you do not specify this option,
            the server’s global setting applies to
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      ’s queries.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_net-buffer-length">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_net-buffer-length">
       <code class="option">
        --net-buffer-length=
        <em class="replaceable">
         <code>
          value
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for net-buffer-length">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --net-buffer-length=value
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Numeric
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           16384
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312299984">
     </a>
     <a class="indexterm" name="idm46045312298480">
     </a>
     <p>
      The initial size of the buffer for client/server
            communication. When creating multiple-row
      <a class="link" href="insert.html" title="15.2.7 INSERT Statement">
       <code class="literal">
        INSERT
       </code>
      </a>
      statements (as with
            the
      <a class="link" href="mysqldump.html#option_mysqldump_extended-insert">
       <code class="option">
        --extended-insert
       </code>
      </a>
      or
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
      option),
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      creates rows up to
      <a class="link" href="mysqldump.html#option_mysqldump_net-buffer-length">
       <code class="option">
        --net-buffer-length
       </code>
      </a>
      bytes
            long. If you increase this variable, ensure that the MySQL
            server
      <a class="link" href="server-system-variables.html#sysvar_net_buffer_length">
       <code class="literal">
        net_buffer_length
       </code>
      </a>
      system variable has a value at least this large.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_network-timeout">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_network-timeout">
       <code class="option">
        --network-timeout
       </code>
      </a>
      ,
      <code class="option">
       -M
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for network-timeout">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --network-timeout[={0|1}]
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Type
         </th>
         <td>
          Boolean
         </td>
        </tr>
        <tr>
         <th>
          Default Value
         </th>
         <td>
          <code class="literal">
           TRUE
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312276848">
     </a>
     <a class="indexterm" name="idm46045312275360">
     </a>
     <p>
      Enable large tables to be dumped by setting
      <a class="link" href="mysqldump.html#option_mysqldump_max-allowed-packet">
       <code class="option">
        --max-allowed-packet
       </code>
      </a>
      to
            its maximum value and network read and write timeouts to a
            large value. This option is enabled by default. To disable
            it, use
      <a class="link" href="mysqldump.html#option_mysqldump_network-timeout">
       <code class="option">
        --skip-network-timeout
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_opt">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for opt">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --opt
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Disabled by
         </th>
         <td>
          <code class="literal">
           skip-opt
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312261184">
     </a>
     <a class="indexterm" name="idm46045312259696">
     </a>
     <p>
      This option, enabled by default, is shorthand for the
            combination of
      <a class="link" href="mysqldump.html#option_mysqldump_add-drop-table">
       <code class="option">
        --add-drop-table
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_add-locks">
       <code class="option">
        --add-locks
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_create-options">
       <code class="option">
        --create-options
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_disable-keys">
       <code class="option">
        --disable-keys
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_extended-insert">
       <code class="option">
        --extended-insert
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
       <code class="option">
        --lock-tables
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_quick">
       <code class="option">
        --quick
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_set-charset">
       <code class="option">
        --set-charset
       </code>
      </a>
      . It gives a
            fast dump operation and produces a dump file that can be
            reloaded into a MySQL server quickly.
     </p>
     <p>
      Because the
      <code class="option">
       --opt
      </code>
      option is enabled by
            default, you only specify its converse, the
      <a class="link" href="mysqldump.html#option_mysqldump_skip-opt">
       <code class="option">
        --skip-opt
       </code>
      </a>
      to turn off
            several default settings. See the discussion of
      <a class="link" href="mysqldump.html#mysqldump-option-groups" title="Option Groups">
       <code class="literal">
        mysqldump
       </code>
       option groups
      </a>
      for information about selectively
            enabling or disabling a subset of the options affected by
      <code class="option">
       --opt
      </code>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_quick">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_quick">
       <code class="option">
        --quick
       </code>
      </a>
      ,
      <code class="option">
       -q
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for quick">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --quick
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Disabled by
         </th>
         <td>
          <code class="literal">
           skip-quick
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312235424">
     </a>
     <a class="indexterm" name="idm46045312233936">
     </a>
     <p>
      This option is useful for dumping large tables. It forces
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      to retrieve rows for a table
            from the server a row at a time rather than retrieving the
            entire row set and buffering it in memory before writing it
            out.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_skip-opt">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_skip-opt">
       <code class="option">
        --skip-opt
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for skip-opt">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --skip-opt
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312222800">
     </a>
     <a class="indexterm" name="idm46045312221312">
     </a>
     <p>
      See the description for the
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
      option.
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-transaction-options">
   </a>
   Transactional Options
  </h4>
  <p>
   The following options trade off the performance of the dump
        operation, against the reliability and consistency of the
        exported data.
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      <a name="option_mysqldump_add-locks">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_add-locks">
       <code class="option">
        --add-locks
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for add-locks">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --add-locks
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312207104">
     </a>
     <a class="indexterm" name="idm46045312205616">
     </a>
     <p>
      Surround each table dump with
      <a class="link" href="lock-tables.html" title="15.3.6 LOCK TABLES and UNLOCK TABLES Statements">
       <code class="literal">
        LOCK
            TABLES
       </code>
      </a>
      and
      <a class="link" href="lock-tables.html" title="15.3.6 LOCK TABLES and UNLOCK TABLES Statements">
       <code class="literal">
        UNLOCK
            TABLES
       </code>
      </a>
      statements. This results in faster inserts
            when the dump file is reloaded. See
      <a class="xref" href="insert-optimization.html" title="10.2.5.1 Optimizing INSERT Statements">
       Section 10.2.5.1, “Optimizing INSERT Statements”
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_flush-logs">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_flush-logs">
       <code class="option">
        --flush-logs
       </code>
      </a>
      ,
      <code class="option">
       -F
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for flush-logs">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --flush-logs
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312191424">
     </a>
     <a class="indexterm" name="idm46045312189936">
     </a>
     <p>
      Flush the MySQL server log files before starting the dump.
            This option requires the
      <a class="link" href="privileges-provided.html#priv_reload">
       <code class="literal">
        RELOAD
       </code>
      </a>
      privilege. If you use
            this option in combination with the
      <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
       <code class="option">
        --all-databases
       </code>
      </a>
      option,
            the logs are flushed
      <span class="emphasis">
       <em>
        for each database
            dumped
       </em>
      </span>
      . The exception is when using
      <a class="link" href="mysqldump.html#option_mysqldump_lock-all-tables">
       <code class="option">
        --lock-all-tables
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      , or
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
      . In
            these cases, the logs are flushed only once, corresponding
            to the moment that all tables are locked by
      <a class="link" href="flush.html#flush-tables-with-read-lock">
       <code class="literal">
        FLUSH TABLES WITH READ LOCK
       </code>
      </a>
      .
            If you want your dump and the log flush to happen at exactly
            the same moment, you should use
      <code class="option">
       --flush-logs
      </code>
      together with
      <a class="link" href="mysqldump.html#option_mysqldump_lock-all-tables">
       <code class="option">
        --lock-all-tables
       </code>
      </a>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_source-data">
       <code class="option">
        --source-data
       </code>
      </a>
      , or
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_flush-privileges">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_flush-privileges">
       <code class="option">
        --flush-privileges
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for flush-privileges">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --flush-privileges
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312169280">
     </a>
     <a class="indexterm" name="idm46045312167792">
     </a>
     <p>
      Add a
      <a class="link" href="flush.html#flush-privileges">
       <code class="literal">
        FLUSH PRIVILEGES
       </code>
      </a>
      statement to the dump output after dumping the
      <code class="literal">
       mysql
      </code>
      database. This option should be
            used any time the dump contains the
      <code class="literal">
       mysql
      </code>
      database and any other database that depends on the data in
            the
      <code class="literal">
       mysql
      </code>
      database for proper
            restoration.
     </p>
     <p>
      Because the dump file contains a
      <a class="link" href="flush.html#flush-privileges">
       <code class="literal">
        FLUSH
            PRIVILEGES
       </code>
      </a>
      statement, reloading the file requires
            privileges sufficient to execute that statement.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_lock-all-tables">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_lock-all-tables">
       <code class="option">
        --lock-all-tables
       </code>
      </a>
      ,
      <code class="option">
       -x
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for lock-all-tables">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --lock-all-tables
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312152272">
     </a>
     <a class="indexterm" name="idm46045312150784">
     </a>
     <p>
      Lock all tables across all databases. This is achieved by
            acquiring a global read lock for the duration of the whole
            dump. This option automatically turns off
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
      and
      <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
       <code class="option">
        --lock-tables
       </code>
      </a>
      .
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_lock-tables">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
       <code class="option">
        --lock-tables
       </code>
      </a>
      ,
      <code class="option">
       -l
      </code>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for lock-tables">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --lock-tables
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312138528">
     </a>
     <a class="indexterm" name="idm46045312137040">
     </a>
     <p>
      For each dumped database, lock all tables to be dumped
            before dumping them. The tables are locked with
      <code class="literal">
       READ LOCAL
      </code>
      to permit concurrent inserts
            in the case of
      <code class="literal">
       MyISAM
      </code>
      tables. For
            transactional tables such as
      <code class="literal">
       InnoDB
      </code>
      ,
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
      is a
            much better option than
      <code class="option">
       --lock-tables
      </code>
      because it does not need to lock the tables at all.
     </p>
     <p>
      Because
      <code class="option">
       --lock-tables
      </code>
      locks tables for each
            database separately, this option does not guarantee that the
            tables in the dump file are logically consistent between
            databases. Tables in different databases may be dumped in
            completely different states.
     </p>
     <p>
      Some options, such as
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
      , automatically
            enable
      <code class="option">
       --lock-tables
      </code>
      . If you want to
            override this, use
      <code class="option">
       --skip-lock-tables
      </code>
      at
            the end of the option list.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_no-autocommit">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_no-autocommit">
       <code class="option">
        --no-autocommit
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for no-autocommit">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --no-autocommit
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312120000">
     </a>
     <a class="indexterm" name="idm46045312118512">
     </a>
     <p>
      Enclose the
      <a class="link" href="insert.html" title="15.2.7 INSERT Statement">
       <code class="literal">
        INSERT
       </code>
      </a>
      statements
            for each dumped table within
      <code class="literal">
       SET autocommit =
            0
      </code>
      and
      <a class="link" href="commit.html" title="15.3.1 START TRANSACTION, COMMIT, and ROLLBACK Statements">
       <code class="literal">
        COMMIT
       </code>
      </a>
      statements.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_order-by-primary">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_order-by-primary">
       <code class="option">
        --order-by-primary
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for order-by-primary">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --order-by-primary
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312105504">
     </a>
     <a class="indexterm" name="idm46045312104016">
     </a>
     <p>
      Dump each table's rows sorted by its primary key, or by its
            first unique index, if such an index exists. This is useful
            when dumping a
      <code class="literal">
       MyISAM
      </code>
      table to be loaded
            into an
      <code class="literal">
       InnoDB
      </code>
      table, but makes the dump
            operation take considerably longer.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_shared-memory-base-name">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_shared-memory-base-name">
       <code class="option">
        --shared-memory-base-name=
        <em class="replaceable">
         <code>
          name
         </code>
        </em>
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for shared-memory-base-name">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --shared-memory-base-name=name
          </code>
         </td>
        </tr>
        <tr>
         <th>
          Platform Specific
         </th>
         <td>
          Windows
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312089264">
     </a>
     <a class="indexterm" name="idm46045312087760">
     </a>
     <p>
      On Windows, the shared-memory name to use for connections
            made using shared memory to a local server. The default
            value is
      <code class="literal">
       MYSQL
      </code>
      . The shared-memory name is
            case-sensitive.
     </p>
     <p>
      This option applies only if the server was started with the
      <a class="link" href="server-system-variables.html#sysvar_shared_memory">
       <code class="literal">
        shared_memory
       </code>
      </a>
      system
            variable enabled to support shared-memory connections.
     </p>
    </li>
    <li class="listitem">
     <p>
      <a name="option_mysqldump_single-transaction">
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
     </p>
     <div class="informaltable">
      <table frame="box" rules="all" summary="Properties for single-transaction">
       <colgroup>
        <col style="width: 30%"/>
        <col style="width: 70%"/>
       </colgroup>
       <tbody>
        <tr>
         <th>
          Command-Line Format
         </th>
         <td>
          <code class="literal">
           --single-transaction
          </code>
         </td>
        </tr>
       </tbody>
      </table>
     </div>
     <a class="indexterm" name="idm46045312075504">
     </a>
     <a class="indexterm" name="idm46045312074000">
     </a>
     <p>
      This option sets the transaction isolation mode to
      <a class="link" href="innodb-transaction-isolation-levels.html#isolevel_repeatable-read">
       <code class="literal">
        REPEATABLE READ
       </code>
      </a>
      and sends
            a
      <a class="link" href="commit.html" title="15.3.1 START TRANSACTION, COMMIT, and ROLLBACK Statements">
       <code class="literal">
        START
            TRANSACTION
       </code>
      </a>
      SQL statement to the server before
            dumping data. It is useful only with transactional tables
            such as
      <code class="literal">
       InnoDB
      </code>
      , because then it dumps the
            consistent state of the database at the time when
      <a class="link" href="commit.html" title="15.3.1 START TRANSACTION, COMMIT, and ROLLBACK Statements">
       <code class="literal">
        START
            TRANSACTION
       </code>
      </a>
      was issued without blocking any
            applications.
     </p>
     <p>
      The
      <a class="link" href="privileges-provided.html#priv_reload">
       <code class="literal">
        RELOAD
       </code>
      </a>
      or
      <a class="link" href="privileges-provided.html#priv_flush-tables">
       <code class="literal">
        FLUSH_TABLES
       </code>
      </a>
      privilege is
            required with
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
      if
            both
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_mode">
       <code class="literal">
        gtid_mode=ON
       </code>
      </a>
      and
      <a class="link" href="replication-options-gtids.html#sysvar_gtid_purged">
       <code class="literal">
        gtid_purged=ON|AUTO
       </code>
      </a>
      .
     </p>
     <p>
      When using this option, you should keep in mind that only
      <code class="literal">
       InnoDB
      </code>
      tables are dumped in a consistent
            state. For example, any
      <code class="literal">
       MyISAM
      </code>
      or
      <code class="literal">
       MEMORY
      </code>
      tables dumped while using this
            option may still change state.
     </p>
     <p>
      While a
      <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
       <code class="option">
        --single-transaction
       </code>
      </a>
      dump
            is in process, to ensure a valid dump file (correct table
            contents and binary log coordinates), no other connection
            should use the following statements:
      <a class="link" href="alter-table.html" title="15.1.9 ALTER TABLE Statement">
       <code class="literal">
        ALTER TABLE
       </code>
      </a>
      ,
      <a class="link" href="create-table.html" title="15.1.20 CREATE TABLE Statement">
       <code class="literal">
        CREATE TABLE
       </code>
      </a>
      ,
      <a class="link" href="drop-table.html" title="15.1.32 DROP TABLE Statement">
       <code class="literal">
        DROP TABLE
       </code>
      </a>
      ,
      <a class="link" href="rename-table.html" title="15.1.36 RENAME TABLE Statement">
       <code class="literal">
        RENAME TABLE
       </code>
      </a>
      ,
      <a class="link" href="truncate-table.html" title="15.1.37 TRUNCATE TABLE Statement">
       <code class="literal">
        TRUNCATE TABLE
       </code>
      </a>
      . A consistent
            read is not isolated from those statements, so use of them
            on a table to be dumped can cause the
      <a class="link" href="select.html" title="15.2.13 SELECT Statement">
       <code class="literal">
        SELECT
       </code>
      </a>
      that is performed by
      <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
       <span class="command">
        <strong>
         mysqldump
        </strong>
       </span>
      </a>
      to retrieve the table contents
            to obtain incorrect contents or fail.
     </p>
     <p>
      The
      <code class="option">
       --single-transaction
      </code>
      option and the
      <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
       <code class="option">
        --lock-tables
       </code>
      </a>
      option are
            mutually exclusive because
      <a class="link" href="lock-tables.html" title="15.3.6 LOCK TABLES and UNLOCK TABLES Statements">
       <code class="literal">
        LOCK
            TABLES
       </code>
      </a>
      causes any pending transactions to be
            committed implicitly.
     </p>
     <p>
      To dump large tables, combine the
      <code class="option">
       --single-transaction
      </code>
      option with the
      <a class="link" href="mysqldump.html#option_mysqldump_quick">
       <code class="option">
        --quick
       </code>
      </a>
      option.
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-option-groups">
   </a>
   Option Groups
  </h4>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      The
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
      option turns on
            several settings that work together to perform a fast dump
            operation. All of these settings are on by default, because
      <code class="option">
       --opt
      </code>
      is on by default. Thus you rarely if
            ever specify
      <code class="literal">
       --opt
      </code>
      . Instead, you can turn
            these settings off as a group by specifying
      <code class="literal">
       --skip-opt
      </code>
      , then optionally re-enable
            certain settings by specifying the associated options later
            on the command line.
     </p>
    </li>
    <li class="listitem">
     <p>
      The
      <a class="link" href="mysqldump.html#option_mysqldump_compact">
       <code class="option">
        --compact
       </code>
      </a>
      option turns
            off several settings that control whether optional
            statements and comments appear in the output. Again, you can
            follow this option with other options that re-enable certain
            settings, or turn all the settings on by using the
      <code class="literal">
       --skip-compact
      </code>
      form.
     </p>
    </li>
   </ul>
  </div>
  <p>
   When you selectively enable or disable the effect of a group
        option, order is important because options are processed first
        to last. For example,
   <a class="link" href="mysqldump.html#option_mysqldump_disable-keys">
    <code class="option">
     --disable-keys
    </code>
   </a>
   <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
    <code class="option">
     --lock-tables
    </code>
   </a>
   <a class="link" href="mysqldump.html#option_mysqldump_skip-opt">
    <code class="option">
     --skip-opt
    </code>
   </a>
   would not have the
        intended effect; it is the same as
   <a class="link" href="mysqldump.html#option_mysqldump_skip-opt">
    <code class="option">
     --skip-opt
    </code>
   </a>
   by itself.
  </p>
  <h4>
   <a name="mysqldump-option-examples">
   </a>
   Examples
  </h4>
  <p>
   To make a backup of an entire database:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa33251401"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <em class="replaceable">db_name</em> &gt; <em class="replaceable">backup-file<span class="token punctuation">.</span>sql</em></code></pre>
  </div>
  <p>
   To load the dump file back into the server:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa43436026"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysql <em class="replaceable">db_name</em> &lt; <em class="replaceable">backup-file<span class="token punctuation">.</span>sql</em></code></pre>
  </div>
  <p>
   Another way to reload the dump file:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa22096539"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysql <span class="token property">-e</span> <span class="token atrule">"source <em class="replaceable">/path-to-backup/backup-file.sql</em>"</span> <em class="replaceable">db_name</em></code></pre>
  </div>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   is also very useful for populating
        databases by copying data from one MySQL server to another:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa89089641"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token property">--opt</span> <em class="replaceable">db_name</em> | mysql <span class="token constant">--host</span><span class="token attr-value"><span class="token punctuation">=</span><em class="replaceable">remote_host</em></span> <span class="token property">-C</span> <em class="replaceable">db_name</em></code></pre>
  </div>
  <p>
   You can dump several databases with one command:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa86544729"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token property">--databases</span> <em class="replaceable">db_name1</em> <span class="token punctuation">[</span><em class="replaceable">db_name2</em> <span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">.</span><span class="token punctuation">]</span> &gt; my_databases<span class="token punctuation">.</span>sql</code></pre>
  </div>
  <p>
   To dump all databases, use the
   <a class="link" href="mysqldump.html#option_mysqldump_all-databases">
    <code class="option">
     --all-databases
    </code>
   </a>
   option:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa40737"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token property">--all-databases</span> &gt; all_databases<span class="token punctuation">.</span>sql</code></pre>
  </div>
  <p>
   For
   <code class="literal">
    InnoDB
   </code>
   tables,
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   provides a way of making an online
        backup:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa54839139"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token property">--all-databases</span> <span class="token property">--source-data</span> <span class="token property">--single-transaction</span> &gt; all_databases<span class="token punctuation">.</span>sql</code></pre>
  </div>
  <p>
   This backup acquires a global read lock on all tables (using
   <a class="link" href="flush.html#flush-tables-with-read-lock">
    <code class="literal">
     FLUSH TABLES WITH READ LOCK
    </code>
   </a>
   ) at
        the beginning of the dump. As soon as this lock has been
        acquired, the binary log coordinates are read and the lock is
        released. If long updating statements are running when the
   <a class="link" href="flush.html" title="15.7.8.3 FLUSH Statement">
    <code class="literal">
     FLUSH
    </code>
   </a>
   statement is issued, the
        MySQL server may get stalled until those statements finish.
        After that, the dump becomes lock free and does not disturb
        reads and writes on the tables. If the update statements that
        the MySQL server receives are short (in terms of execution
        time), the initial lock period should not be noticeable, even
        with many updates.
  </p>
  <p>
   For point-in-time recovery (also known as
   <span class="quote">
    “
    <span class="quote">
     roll-forward,
    </span>
    ”
   </span>
   when you need to restore an old
        backup and replay the changes that happened since that backup),
        it is often useful to rotate the binary log (see
   <a class="xref" href="binary-log.html" title="7.4.4 The Binary Log">
    Section 7.4.4, “The Binary Log”
   </a>
   ) or at least know the binary log
        coordinates to which the dump corresponds:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa98455149"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token property">--all-databases</span> <span class="token constant">--source-data</span><span class="token attr-value"><span class="token punctuation">=</span>2</span> &gt; all_databases<span class="token punctuation">.</span>sql</code></pre>
  </div>
  <p>
   Or:
  </p>
  <div class="copytoclipboard-wrapper">
   <pre class="programlisting one-line language-terminal"><div class="docs-select-all right" id="sa29797200"><div class="copy-help left">Press ⌘+C to copy</div> <div class="right"><button class="clipboard-btn" title="Copy to Clipboard"><span class="icon-clipboard"></span></button></div></div><code class="language-terminal">mysqldump <span class="token property">--all-databases</span> <span class="token property">--flush-logs</span> <span class="token constant">--source-data</span><span class="token attr-value"><span class="token punctuation">=</span>2</span> &gt; all_databases<span class="token punctuation">.</span>sql</code></pre>
  </div>
  <p>
   The
   <a class="link" href="mysqldump.html#option_mysqldump_source-data">
    <code class="option">
     --source-data
    </code>
   </a>
   option can
        be used simultaneously with the
   <a class="link" href="mysqldump.html#option_mysqldump_single-transaction">
    <code class="option">
     --single-transaction
    </code>
   </a>
   option,
        which provides a convenient way to make an online backup
        suitable for use prior to point-in-time recovery if tables are
        stored using the
   <code class="literal">
    InnoDB
   </code>
   storage engine.
  </p>
  <p>
   For more information on making backups, see
   <a class="xref" href="backup-methods.html" title="9.2 Database Backup Methods">
    Section 9.2, “Database Backup Methods”
   </a>
   , and
   <a class="xref" href="backup-strategy-example.html" title="9.3 Example Backup and Recovery Strategy">
    Section 9.3, “Example Backup and Recovery Strategy”
   </a>
   .
  </p>
  <div class="itemizedlist">
   <ul class="itemizedlist" style="list-style-type: disc; ">
    <li class="listitem">
     <p>
      To select the effect of
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
      except for some
            features, use the
      <code class="option">
       --skip
      </code>
      option for each
            feature. To disable extended inserts and memory buffering,
            use
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_extended-insert">
       <code class="option">
        --skip-extended-insert
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_quick">
       <code class="option">
        --skip-quick
       </code>
      </a>
      .
            (Actually,
      <a class="link" href="mysqldump.html#option_mysqldump_extended-insert">
       <code class="option">
        --skip-extended-insert
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_quick">
       <code class="option">
        --skip-quick
       </code>
      </a>
      is sufficient because
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
      is on by default.)
     </p>
    </li>
    <li class="listitem">
     <p>
      To reverse
      <a class="link" href="mysqldump.html#option_mysqldump_opt">
       <code class="option">
        --opt
       </code>
      </a>
      for all
            features except disabling of indexes and table locking, use
      <a class="link" href="mysqldump.html#option_mysqldump_skip-opt">
       <code class="option">
        --skip-opt
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_disable-keys">
       <code class="option">
        --disable-keys
       </code>
      </a>
      <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
       <code class="option">
        --lock-tables
       </code>
      </a>
      .
     </p>
    </li>
   </ul>
  </div>
  <h4>
   <a name="mysqldump-restrictions">
   </a>
   Restrictions
  </h4>
  <a class="indexterm" name="idm46045311980720">
  </a>
  <a class="indexterm" name="idm46045311979232">
  </a>
  <a class="indexterm" name="idm46045311977744">
  </a>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   does not dump the
   <code class="literal">
    performance_schema
   </code>
   or
   <code class="literal">
    sys
   </code>
   schema by default. To dump any of these, name them explicitly on
        the command line. You can also name them with the
   <a class="link" href="mysqldump.html#option_mysqldump_databases">
    <code class="option">
     --databases
    </code>
   </a>
   option. For
   <code class="literal">
    performance_schema
   </code>
   , also use the
   <a class="link" href="mysqldump.html#option_mysqldump_lock-tables">
    <code class="option">
     --skip-lock-tables
    </code>
   </a>
   option.
  </p>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   does not dump the
   <code class="literal">
    INFORMATION_SCHEMA
   </code>
   schema.
  </p>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   does not dump
   <code class="literal">
    InnoDB
   </code>
   <a class="link" href="create-tablespace.html" title="15.1.21 CREATE TABLESPACE Statement">
    <code class="literal">
     CREATE
        TABLESPACE
    </code>
   </a>
   statements.
  </p>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   does not dump the NDB Cluster
   <a class="link" href="mysql-cluster-ndbinfo.html" title="25.6.17 ndbinfo: The NDB Cluster Information Database">
    <code class="literal">
     ndbinfo
    </code>
   </a>
   information database.
  </p>
  <p>
   <a class="link" href="mysqldump.html" title="6.5.4 mysqldump — A Database Backup Program">
    <span class="command">
     <strong>
      mysqldump
     </strong>
    </span>
   </a>
   includes statements to recreate the
   <code class="literal">
    general_log
   </code>
   and
   <code class="literal">
    slow_query_log
   </code>
   tables for dumps of the
   <code class="literal">
    mysql
   </code>
   database. Log table contents are not
        dumped.
  </p>
  <p>
   If you encounter problems backing up views due to insufficient
        privileges, see
   <a class="xref" href="view-restrictions.html" title="27.9 Restrictions on Views">
    Section 27.9, “Restrictions on Views”
   </a>
   for a
        workaround.
  </p>
 </div>
 <br/>
</div>
