Lidando com Problemas de Compatibilidade de Banco de Dados
Este artigo fornece instruções detalhadas sobre como resolver vários problemas de compatibilidade de banco de dados MySQL, incluindo preocupações de compatibilidade e erros de collation de tabelas.
Problemas de Compatibilidade
Para evitar problemas de incompatibilidade de banco de dados, certifique-se de que as versões do banco de dados entre os servidores de build e de instalação sejam as mais próximas possíveis. Se o backup foi criado em uma versão de banco de dados mais recente do que onde está sendo instalado, você poderá encontrar problemas.
É melhor garantir que o servidor onde o instalador está sendo executado tenha a mesma versão ou uma versão superior à onde foi criado. Se as versões principal e secundária forem as mesmas ou próximas (por exemplo, [5.7 para 5.6]), a migração deverá funcionar sem problemas. Um par de versões [5.7 para 5.1] tem maior probabilidade de causar problemas, a menos que você tenha uma configuração muito simples. Se as versões estiverem muito distantes, trabalhe com seu provedor de hospedagem para atualizar o motor MySQL neste servidor.
Solução 1: FORMATO UTF8MB4
Se a versão atual do servidor MySQL detectada for inferior a 5.5.3 (lançada em 8 de abril de 2010), o suporte para tabelas utf8mb4 não funcionará. O formato utf8mb4 só é suportado no servidor MySQL 5.5.3+. É altamente recomendável atualizar sua versão do servidor MySQL neste servidor para ser mais compatível com as versões recentes do WordPress e evitar problemas com erros de instalação.
Solução 2: ENTRADAS UTF8
Se caracteres não ASCII forem detectados como parte da string de conexão do banco de dados e o servidor MySQL não estiver configurado corretamente, você não conseguirá se conectar. Este problema pode ser resolvido atualizando a configuração my.ini do MySQL.
Adicione a configuração character_set_server=utf8 em [mysqld] e reinicie o servidor do banco de dados. Este valor pode apenas precisar ser descomentado.
Solução 3: CONFIGURAÇÕES MARIA-DB
Se uma versão 10.N.N for exibida, a distribuição do banco de dados é um sabor MariaDB do MySQL. Embora as distribuições sejam muito próximas, existem algumas diferenças sutis. Alguns sistemas operacionais relatarão a versão como "5.5.5-10.1.21-MariaDB", mostrando a correlação de ambos. Visite a página online MariaDB versus MySQL – Compatibilidade para mais detalhes.
Por favor, note que algumas mensagens são apenas avisos. É altamente recomendável continuar com o processo de instalação e monitorar de perto o arquivo installer-log.txt juntamente com o relatório de instalação encontrado na etapa 3 do instalador. Certifique-se de procurar por quaisquer avisos/advertências/erros nesses locais para validar que o processo de instalação não detectou nenhum erro. Se forem encontrados problemas, visite as páginas de Perguntas Frequentes e veja a pergunta “Como resolver erros de banco de dados ou avisos gerais no relatório de instalação?”
Solução 4: CRIAR TABELAS
A criação de tabelas entre MySQL e MariaDB é muito semelhante; no entanto, existem algumas pequenas diferenças que às vezes (não comum) podem causar problemas. Para ver as diferenças entre cada um, consulte os dois conjuntos de documentação aqui:
Como você pode ver, eles não são uma correspondência um para um (MariaDB tem opções que o MySQL não tem), então quando você tenta executar uma consulta CREATE que funcionou no MariaDB, mas tem alguma opção de tabela que o MySQL não suporta, ela pode falhar. A correção atual é remover as opções de tabela ofensivas do dump do banco de dados fazendo uma pesquisa e substituição manual no arquivo.
Problemas de Collation de Tabela
Como resolver erros de modo de compatibilidade e de ‘collation desconhecida’?
Existem 4 maneiras de resolver este problema. A Opção 1 é a maneira mais rápida, fácil e segura de resolver este problema.
Visão Geral de Collation Desconhecida
Um erro de “collation desconhecida” significa que o servidor MySQL em que está sendo instalado (servidor de destino) é mais antigo do que o mecanismo MySQL em que você criou o backup. Uma mensagem de erro como:
ERRO erro de banco de dados ao escrever ‘Unknown collation: ‘utf8mb4_unicode_ci’
será acionado porque a versão do MySQL em uso não suporta este formato de tabela. Você pode ver a comparação das versões do servidor MySQL clicando no botão “Testar Conexão” no instalador ou visualizando o arquivo installer-log.txt. A saída será algo como:
VERSÃO MYSQL: Este Servidor: 5.4.22 — Servidor de Build: 5.7.10
Opção 1 – Atualizar Software do Banco de Dados
A maneira mais limpa e segura de corrigir o problema de “Collation Desconhecida” é atualizar seu servidor MySQL de destino para a mesma versão ou uma versão mais recente do que onde o backup foi criado. Os erros de formato mais comuns incluem:
- utf8mb4_unicode_ci: Requer servidor MySQL 5.5.3+.
- utf8mb4_unicode_520_ci: Requer servidor MySQL 5.6+.
Melhor Correção: A melhor e mais fácil maneira de resolver este problema é pedir ao seu provedor para mover sua conta para um servidor MySQL que suporte o tipo de collation que você precisa (veja o exemplo acima). Simplesmente dê a eles a mensagem de erro que você está recebendo e eles poderão ajudá-lo a mover para o servidor correto.
A maioria dos provedores não atualizará o servidor atual em que seu site está; no entanto, eles devem ser capazes de mover facilmente sua conta para um servidor mais novo. Esta é uma prática muito comum e um bom provedor deve ser capaz de ajudar com bastante facilidade.
Se você estiver executando qualquer versão inferior à 5.5.3, então você está usando uma versão muito desatualizada do servidor MySQL. 5.5.3 foi lançado em 2010, o que significa que a versão do servidor MySQL que você está usando é ainda mais antiga. Nós encorajamos fortemente os usuários a trabalhar com seus hosts para usar software atualizado para melhorar a segurança e o desempenho e para se manter em conformidade com as atualizações do núcleo do WordPress. Não deixe que um host ruim use software desatualizado em seu site.
Opção 2 – Conjunto de Caracteres e Colação Padrão
No instalador, na etapa 2, em opções, a caixa de seleção 'Legado' não existe mais. No entanto, agora ela é detectada e definida automaticamente. Se o conjunto de caracteres e a colação não forem explicitamente definidos, um aviso aparecerá informando que o conjunto de caracteres e a colação padrão serão usados.
Ao criar uma tabela de banco de dados, a versão do MySQL em uso pode não suportar o tipo de colação da versão do MySQL onde a tabela foi criada. Nesse cenário, o instalador usará automaticamente um tipo de colação de fallback para tentar criar a tabela.
Opção 3 – Executar Modo de Compatibilidade
O modo de compatibilidade Mysqldump ajuda a produzir uma saída de script SQL do banco de dados que é mais compatível com outros sistemas de banco de dados ou com servidores MySQL mais antigos.
O Duplicator suporta vários modos de compatibilidade, todos os quais estão disponíveis apenas quando o modo mysqldump está habilitado no plugin. O modo de compatibilidade pode ser habilitado ao criar um backup usando a opção mysqldump.
O Duplicator só permitirá o modo de compatibilidade durante o processo de criação. Ele não é permitido ao criar modelos ou com agendamentos. A razão para essa configuração é desencorajar o uso dessas configurações e corrigir o problema real — que é atualizar seu servidor de banco de dados.
Atualizações de Banco de Dados: O Modo de Compatibilidade só deve ser usado como último recurso. A abordagem recomendada para corrigir problemas de banco de dados é garantir que ambos os servidores de banco de dados estejam atualizados e com números de versão muito próximos (veja Opção 1). Por exemplo, se o servidor de banco de dados onde você criou o backup é 5.7.5, então o servidor de banco de dados onde você instalar o backup deve estar pelo menos na faixa 5.7.N. Peça ao seu host ou administrador de servidor para atualizar o servidor MySQL para uma versão mais recente, se possível. Se o seu host não atualizar para uma versão recente, peça para que atualizem para a versão mais alta possível.
Preservação de Dados: Embora existam várias soluções alternativas na internet (Opção 4) explicando como você pode modificar o arquivo SQL atual ou usar o modo de compatibilidade mysqldump, o principal problema subjacente é que você armazenou dados em um formato e agora vai convertê-los. Essas técnicas podem levar à perda de dados e problemas de incompatibilidade no futuro. A abordagem correta é atualizar o software MySQL.
Considere experimentar ambos os modos:
- O Duplicator atualmente suporta dois modos diferentes: Mysqldump e Modo PHP (veja a opção Configurações » Backups).
- Se você estiver enfrentando problemas de caracteres e ficando sem opções, considere tentar criar o banco de dados em ambos os modos para ver se um ou outro resolve os problemas.
Opção 4 – Configurações Manuais
Estas opções são para usuários avançados e devem ser realizadas com cautela. As opções exigem a atualização do script database.sql ou a atualização dos tipos de collation da tabela do banco de dados de origem. Abaixo estão três abordagens diferentes; apenas uma opção é necessária para resolver o problema.
Atualizar database.sql
Para problemas de “collation desconhecida”, você pode tentar os seguintes passos:
- Extraia o arquivo zip do arquivo manualmente.
- Abra o arquivo database.sql com o notepad e Pesquise & Substitua nas colunas. Por exemplo, você pode:
- substitua: ‘utf8mb4’ por ‘utf8’
- substitua: ‘utf8_unicode_520_ci’ por ‘utf8_general_ci’
Sempre tente estas opções primeiro em um sandbox e nunca em um site de produção até que você esteja confortável com os resultados.
Em seguida, navegue até o arquivo installer.php no servidor e escolha Avançado & marque “Extração Manual”.
Isso também pode ser tentado com outras collations (ou seja, substitua ‘collation_type_1’ por ‘collation_type_2’).
Atualizar Banco de Dados de Origem com Código
Esta opção exige que você realmente entenda seu sistema e tenha feito backups com antecedência. O script permitirá que você altere a collation no servidor de build para que ele possa ser suportado pelo servidor de destino. O script completo pode ser visto no Stack Overflow em: http://stackoverflow.com/a/29939906/2808424
Atualizar Banco de Dados de Origem com IDE
Se você não se sentir confortável executando o código acima, você também pode usar uma IDE ou ferramenta GUI que permitirá que você altere manualmente as collations das tabelas, seja com instruções SQL ou através de uma interface. Novamente, estas opções exigem que você realmente entenda seu sistema e tenha feito backups com antecedência.
Abaixo estão instruções passo a passo fáceis de seguir para atualizar as collations via uma IDE como o phpMyAdmin:
