Problemas conhecidos

Nesta página, você verá uma lista problemas conhecidos do Cloud SQL para MySQL, além de maneiras de evitar ou remediar esses problemas.

Se você tiver dificuldades no uso da instância, verifique também as Diretrizes operacionais e as informações em Como diagnosticar problemas.

Problemas de durabilidade e disponibilidade de dados

  • Colunas geradas (apenas para instâncias do MySQL 5.7)

    Devido a um problema no MySQL, o uso de colunas geradas pode causar corrupção de dados. Para mais informações, consulte o bug nº 82736 do MySQL.

Problemas de conexão da instância

  • Certificados SSL/TLS expirados

    Se a instância estiver configurada para usar SSL, acesse a página Instâncias do Cloud SQL no console do Google Cloud e abra a instância. Abra a página Conexões, selecione a guia Segurança e verifique se o certificado do servidor é válido. Se ele tiver expirado, você precisará adicionar um novo e fazer a rotação dos certificados.

  • Versão do proxy do Cloud SQL Auth

    Se estiver se conectando usando o proxy do Cloud SQL Auth, verifique se está usando a versão mais recente. Para mais informações, consulte Como manter o proxy do Cloud SQL Auth atualizado.

  • Conexão não autorizada

    Se você tentar se conectar a uma instância que não existe no projeto, a mensagem de erro informará apenas que você não está autorizado a acessar essa instância.

  • Não é possível criar uma instância do Cloud SQL

    Se a mensagem de erro Failed to create subnetwork. Router status is temporarily unavailable. Please try again later. Help Token: [token-ID] for exibida, tente criar a instância do Cloud SQL novamente.

Problemas administrativos

  • Apenas uma operação de importação ou exportação do Cloud SQL de longa duração pode ser executada por vez em uma instância. Ao iniciar uma operação, verifique se não é necessário executar outras operações na instância. Além disso, ao iniciar a operação, é possível cancelá-la.

  • O MySQL confirma automaticamente em cada instrução DDL. O Cloud SQL mantém todas as etapas da importação até o cancelamento da instância. Portanto, talvez seja necessário limpar os dados manualmente na instância.

Problemas com importação e exportação de dados

  • A exportação CSV não formata NULLs e novas linhas corretamente.

    Quando você exporta dados como CSV usando o recurso de exportação do Cloud SQL, os NULLs são exportados como "N, o que pode fazer com que o arquivo CSV contenha aspas desequilibradas. Além disso, se os dados de texto contiverem um caractere de nova linha, serão adicionadas aspas ao final da linha.

    Quando você importa um arquivo exportado usando o caractere de escape padrão, o arquivo trata o valor como "NULL" em vez de NULL. Para substituir o padrão ao exportar o arquivo, use --escape="5C".

  • A configuração do modo SQL afeta a forma como o Cloud SQL interpreta consultas SQL.

    Por exemplo, se você realizar uma exportação a partir de um banco de dados sem o modo restrito do SQL ativado e, em seguida, tentar realizar uma importação para o Cloud SQL, a importação poderá falhar. A prática recomendada é usar na importação o mesmo modo SQL usado para a exportação.

  • A cláusula DEFINER pode causar falha na importação

    Uma cláusula DEFINER pode causar falha na operação de importação se o usuário DEFINER for SUPER ou se o usuário do sistema for diferente do que faz a importação no Cloud SQL. Saiba mais sobre o uso da DEFINER e as possíveis soluções alternativas no Cloud SQL.

  • Se você estiver tentando importar e exportar dados de um banco de dados grande (por exemplo, um banco de dados que tenha 500 GB de dados ou mais), as operações de importação e exportação poderão levar muito tempo para serem concluídas. Além disso, outras operações (por exemplo, a de backup) não estarão disponíveis para serem realizadas enquanto ocorre a importação ou exportação. Uma opção possível para melhorar o desempenho do processo de importação e exportação é restaurar um backup anterior usando gcloud ou a API.

  • O Cloud Storage é compatível com um tamanho máximo de objeto único de 5 terabytes. Se você tiver bancos de dados maiores que 5 TB, a operação de exportação para o Cloud Storage falhará. Nesse caso, é preciso dividir os arquivos de exportação em segmentos menores.

Registros de transações e crescimento do disco

Os registros são limpados uma vez por dia, e não continuamente. Quando o número de dias de retenção de registros é configurado para ser o mesmo que o número de backups, um dia de registro pode ser perdido, dependendo de quando o backup ocorre. Por exemplo, definir a retenção de registros para 7 dias e a retenção de backup para 7 backups significa que entre 6 e 7 dias de registros serão retidos.

Recomendamos que você defina o número de backups para, pelo menos, um dia a mais de dias de retenção de registros. Dessa forma, é possível garantir um mínimo de dias especificados para a retenção de registros.

Problemas com o upgrade da sua instância do MySQL

Se você usa o Database Migration Service para fazer upgrade da instância do MySQL da versão 5.7 para a 8.0 e tiver armazenado procedimentos criados no banco de dados chamado mysql na versão 5.7, os procedimentos armazenados poderão não ser copiados para o banco de dados mysql na instância com upgrade 8.0. Além disso, talvez não seja possível criar procedimentos armazenados no banco de dados mysql na instância com upgrade.

Problemas com a compactação de páginas do InnoDB

A compactação de páginas do InnoDB pode melhorar o desempenho das consultas de atualização ao reduzir a quantidade de dados que precisam ser lidos e gravados no disco. No entanto, a compactação de páginas pode afetar o desempenho das consultas de atualização em tabelas atualizadas com frequência. Para avaliar o impacto da compactação de páginas nas consultas de atualização, execute um teste de desempenho com e sem a compactação. Isso ajuda você a observar como a compactação de páginas afeta o desempenho da sua carga de trabalho.

É possível otimizar o desempenho da compactação de páginas da seguinte maneira:

  • Use um algoritmo de compactação adequado ao seu tipo de dados. Por exemplo, use LZ4 para dados de texto e ZLIB para dados binários.

  • Evite usar a compactação para dados que são atualizados com frequência. A compactação e a descompactação de dados podem deixar as consultas de atualização mais lentas.

As instâncias com os seguintes nomes de região são exibidas incorretamente em determinados contextos, da seguinte maneira:

  • us-central1 é exibido como us-central
  • europe-west1 é exibido como europe
  • asia-east1 é exibido como asia

Esse problema ocorre nos seguintes contextos:

  • Alertas no Cloud Monitoring
  • Metrics Explorer
  • Cloud Logging

Reduza o problema dos alertas no Cloud Monitoring e no Metrics Explorer usando os rótulos de metadados de recursos. Use o rótulo de metadados do sistema region em vez do rótulo de recurso monitorado region cloudsql_database.