Comando Linux mysqldump

Em sistemas operacionais do tipo Unix executando o MySQL , o comando mysqldump “despeja” um banco de dados MySQL, ou uma coleção de bancos de dados, para backup ou transferência para outro servidor SQL .

Descrição

O cliente mysqldump é um utilitário que executa backups lógicos, produzindo um conjunto de instruções SQL que podem ser executadas para reproduzir os objetos de esquema originais, dados da tabela ou ambos. Despeja um ou mais banco de dados MySQL para backup ou transferência para outro servidor SQL. O comando mysqldump também pode gerar saída em CSV , outro texto delimitado ou formato XML .

O mysqldump requer pelo menos o privilégio SELECT para tabelas despejadas, SHOW VIEW para visualizações despejadas, TRIGGER para gatilhos despejados e LOCK TABLES se a opção – única transação não for usada. Certas opções podem exigir outros privilégios, conforme observado nas descrições das opções.

Para recarregar um arquivo de despejo, você deve ter os mesmos privilégios necessários para criar cada um dos objetos despejados, emitindo instruções CREATE manualmente.

A saída do mysqldump pode incluir instruções ALTER DATABASE que alteram o agrupamento do banco de dados. Eles podem ser usados ​​ao despejar programas armazenados para preservar suas codificações de caracteres . Para recarregar um arquivo de despejo que contém essas instruções, é necessário o privilégio ALTER do banco de dados afetado.

Considerações sobre desempenho e escalabilidade

As vantagens do mysqldump incluem a conveniência e a flexibilidade de visualizar ou mesmo editar a saída antes de restaurar. Você pode clonar bancos de dados para desenvolvimento e trabalho de DBA ou produzir pequenas variações de um banco de dados existente para teste. Não se destina a ser uma solução rápida ou escalável para fazer backup de quantidades substanciais de dados. Com tamanhos de dados grandes, mesmo que a etapa de backup demore um tempo razoável, a restauração dos dados pode ser muito lenta porque a reprodução das instruções SQL envolve E / S de disco para inserção, criação de índice, etc.

Para backup e restauração em larga escala, um backup físico é mais apropriado, para copiar os arquivos de dados em seu formato original que podem ser restaurados rapidamente:

• Se suas tabelas são principalmente tabelas InnoDB ou se você tem uma mistura de tabelas InnoDB e MyISAM, uma ferramenta melhor pode ser o comando mysqlbackup do produto MySQL Enterprise Backup (que não é gratuito). Ele oferece o melhor desempenho para backups do InnoDB e também pode fazer backup de tabelas do MyISAM e outros mecanismos de armazenamento; e fornece muitas opções convenientes para acomodar diferentes cenários de backup.
• Se suas tabelas são principalmente tabelas MyISAM, considere usar o mysqlhotcopy para obter melhor desempenho do que o mysqldump das operações de backup e restauração.

O mysqldump pode recuperar e despejar o conteúdo da tabela linha por linha, ou pode recuperar todo o conteúdo de uma tabela e armazená-lo na memória antes de descarregá-lo. O buffer da memória pode ser um problema se você estiver descartando tabelas grandes. Para despejar tabelas linha por linha, use a opção –quick (ou –opt , que habilita –quick ). A opção –opt (e, portanto, –quick ) está ativada por padrão; portanto, para ativar o buffer de memória, use –skip-quick .

Se você estiver usando uma versão recente do mysqldump para gerar um dump a ser recarregado em um servidor MySQL muito antigo, use a opção –skip-opt em vez da opção –opt ou –extended-insert .

Invocando o mysqldump

Existem três maneiras gerais de usar o mysqldump . Pode ser usado para despejar um conjunto de uma ou mais tabelas, despejar um conjunto de um ou mais bancos de dados completos ou despejar um servidor MySQL inteiro. Esses três usos, respectivamente, são mostrados aqui:

  mysqldump [opções] nome_bd [nome_tabela ...]

  mysqldump [opções] - bancos de dados db_name ...

  mysqldump [opções] --todos os bancos de dados

Para despejar bancos de dados inteiros, não nomeie nenhuma tabela após db_name ; ou, use a opção –databases ou –all-database .

Sintaxe

  mysqldump [ opções ] [ nome_bd [ nome_tabela ...]]

Opções

O mysqldump suporta as seguintes opções, que podem ser especificadas na linha de comando ou nos grupos [mysqldump] e [client] de um arquivo de opções.

Opções de conexão

  --bind-address = endereço_ip

  --comprimir
 -C

  --default-auth = plugin

  --host = host_name
 -h host_name

  --login-path = name

  --password [ = senha ]
 -p [ senha ]

  --tubo
 -W

  --plugin-dir = caminho

  --protocol = { TCP |  SOQUETE |  TUBO |  MEMÓRIA }

  --secure-auth

  --socket = caminho , caminho -S

  --ssl *

  --user = nome_do_usuário , -u nome_do_usuário

Você também pode definir as seguintes variáveis usando a sintaxe –var_name = value :

  max_allowed_packet

  net_buffer_length

Opções DDL

Os cenários de uso do mysqldump incluem a configuração de uma nova instância do MySQL inteira (incluindo tabelas de banco de dados) e a substituição de dados dentro de uma instância existente por bancos de dados e tabelas existentes.

As opções a seguir permitem especificar quais itens desmontar e configurar ao restaurar um despejo, codificando várias instruções DDL no arquivo de despejo.

  --add-drop-database

  --add-drop-table

  --add-drop-trigger

  --todos os espaços de tabela
 -Y

  --no-create-db
 -n

  --no-create-info
 -t

  --no-tablespaces
 -y

  --substituir

Opções de depuração

As opções a seguir imprimem informações de depuração , codificam informações de depuração no arquivo de despejo ou permitem que a operação de despejo continue independentemente de possíveis problemas.

  --allow-keywords

  --comentários
 -Eu

  --debug [ = debug_options ]
 - # [ debug_options ]

  --debug-check

  --debug-info

  --dump-date

  - Despejo concluído em DATE

  --força
 -f

  --log-error = nome_do_arquivo

  - skip-comments

  --verbose
 -v

Opções de ajuda

As seguintes opções exibem informações sobre o próprio comando mysqldump .

  --Socorro
 -?

  --versão
 -V

As seguintes opções mudam como o comando mysqldump representa dados de caracteres com configurações de idioma nacional.

  --character-sets-dir = caminho

  --default-character-set = charset_name

  --nenhum-conjunto-nomes , -N

  --set-charset

Opções de replicação

O comando mysqldump é freqüentemente usado para criar uma instância vazia, ou uma instância incluindo dados, em um servidor escravo em uma configuração de replicação. As opções a seguir se aplicam ao dumping e à restauração de dados nos servidores mestre e escravo de replicação.

  --apply-slave-statement

  --delete-master-logs

  --dump-slave [ = valor ]

  --include-master-host-port

  --master-data [ = valor ]

  --set-gtid-purged = value

Opções de formato

As opções a seguir especificam como representar o arquivo de despejo inteiro ou certos tipos de dados no arquivo de despejo. Eles também controlam se certas informações opcionais são gravadas no arquivo de despejo.

  --compactar

  --compatible = nome

  - inserção-completa
 -c

  --create-options

  --fields-terminado-por = ...
 --fields-closed-by = ...
 --fields-opcionalmente fechado por = ...
 - campos-escapados por = ...

  --hex-blob

  - linhas terminadas por = ...

  --quote-names
 -Q

  --result-file = nome_do_arquivo
 -r nome_do_arquivo

  --tab = caminho
 Caminho -T

  --tz-utc

  --xml
 -X

Opções de filtragem

As seguintes opções controlam quais tipos de objetos de esquema são gravados no arquivo de despejo: por categoria, como gatilhos ou eventos; pelo nome, por exemplo, escolhendo quais bancos de dados e tabelas despejar; ou mesmo filtrando linhas dos dados da tabela usando uma cláusula WHERE .

  --all-database
 -UMA

  --databases
 -B

  --eventos
 -E

  --ignore-table = db_name .  tbl_name

  --no-data
 -d

  --rotinas
 -R

  --tables

  --gatilhos

  --where = ' where_condition '
 -w ' where_condition '

  --where = "usuário = 'jimf'"

  -w "ID do usuário> 1"

  -w "ID do usuário <1"

Opções de desempenho

As opções a seguir são as mais relevantes para o desempenho, particularmente das operações de restauração. Para conjuntos de dados grandes, a operação de restauração (processando as instruções INSERT no arquivo de despejo) é a parte que consome mais tempo. Quando for urgente restaurar dados rapidamente, planeje e teste o desempenho desse estágio com antecedência. Para tempos de restauração medidos em horas, você pode preferir uma solução alternativa de backup e restauração, como o MySQL Enterprise Backup para bancos de dados somente para uso InnoDB e de uso misto, ou o mysqlhotcopy para bancos de dados somente para MyISAM.

O desempenho também é afetado pelas opções transacionais, principalmente para a operação de despejo.

  - inserção atrasada

  --disable-keys
 -K

  - inserção extendida
 -e

  --inserir-ignorar

  --optar

  --rápido
 -q

  --skip-opt

Opções transacionais

As opções a seguir trocam o desempenho da operação de despejo contra a confiabilidade e a consistência dos dados exportados.

  --add-locks

  --flush-logs
 -F

  --flush-privilégios

  --lock-all-tables
 -x

  --lock-tables
 -eu

  --no-autocommit

  --order-by-primary

  - única transação

Grupos de opções

• A opção –opt ativa várias configurações que trabalham juntas para executar uma operação de despejo rápido. Todas essas configurações estão ativadas por padrão, porque –opt está ativado por padrão. Assim, você raramente ou nunca especifica –opt . Em vez disso, você pode desativar essas configurações como um grupo especificando –skip-opt e , opcionalmente, reativar determinadas configurações especificando as opções associadas posteriormente na linha de comando.
• A opção –compact desativa várias configurações que controlam se declarações e comentários opcionais aparecem na saída. Novamente, você pode seguir esta opção com outras opções que reativam determinadas configurações ou ativam todas as configurações usando o formulário –skip-compact .

Quando você ativa ou desativa seletivamente o efeito de uma opção de grupo, a ordem é importante porque as opções são processadas da primeira à última. Por exemplo, –disable-keys –lock-tables –skip-opt não teria o efeito pretendido; é o mesmo que – skip-opt por si só.

Notas de uso

• Para selecionar o efeito de –opt, exceto em alguns recursos, use a opção –skip para cada recurso. Para desativar inserções estendidas e buffer de memória, use –opt –skip-extended-insert – skip-quick . (Na verdade, –skip-extended-insert –skip-quick é suficiente porque –opt está ativado por padrão.)
• Para inverter –opt para todos os recursos, exceto a desabilitação do índice e o bloqueio de tabela, use –skip-opt –disable-keys –lock-tables .

Restrições

• O mysqldump não despeja o banco de dados INFORMATION_SCHEMA por padrão. Para despejar o arquivo INFORMATION_SCHEMA , nomeie-o explicitamente na linha de comandos e também use a opção –skip-lock-tables .
• O mysqldump nunca despeja o banco de dados performance_schema.
• O mysqldump também não despeja o banco de dados de informações do MySQL Cluster ndbinfo.
• Antes do MySQL 5.6.6, o mysqldump não despeja as tabelas general_log ou slow_query_log para despejos do banco de dados mysql. A partir da versão 5.6.6, o dump inclui instruções para recriar essas tabelas para que elas não estejam ausentes após o recarregamento do arquivo de dump. O conteúdo da tabela de log não é despejado.

Exemplos

 mysqldump db_name> backup-file.sql

Faça backup do banco de dados inteiro db_name no arquivo backup-file.sql .

 mysql nome_do_db <arquivo-de-backup.sql

Carregue o arquivo de backup backup-file.sql no banco de dados db_name .

 mysql -e "source /path-to-backup/backup-file.sql" nome do banco de dados

Essa é outra maneira de fazer a mesma coisa que o exemplo anterior (carregar o arquivo de backup no banco de dados).

mysqldump --opt nome_bd | mysql --host = host_ remoto -C nome do banco de dados

Preencha o banco de dados do servidor mysql remoto db_name com o banco de dados local db_name .

 mysqldump --databases db_name1 [db_name2 ...]> my_databases.sql

O comando acima despeja vários bancos de dados ( db_name1 , db_name2 …) no arquivo de backup único my_databases.sql .

 mysqldump --all-database> all_databases.sql

Despeja todos os bancos de dados no arquivo de backup all_databases.sql .

Comandos relacionados

myisamchk – Verifica, repara, otimiza ou busca informações sobre um banco de dados MySQL.
mysql – Um sistema de gerenciamento de banco de dados relacional de código aberto.