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.
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.
Problemas relacionados ao Cloud Monitoring ou ao Cloud Logging
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 regioncloudsql_database.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-19 UTC."],[],[],null,["# Known issues\n\n\u003cbr /\u003e\n\nMySQL \\| [PostgreSQL](/sql/docs/postgres/known-issues \"View this page for the PostgreSQL database engine\") \\| [SQL Server](/sql/docs/sqlserver/known-issues \"View this page for the SQL Server database engine\")\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\nThis page lists known issues with Cloud SQL for MySQL, along with\nways you can avoid or recover from these issues.\nIf you are experiencing issues with your instance, make sure you also review the [Operational Guidelines](/sql/docs/mysql/operational-guidelines), as well as the information in [Diagnosing Issues](/sql/docs/mysql/diagnose-issues).\n\n### Data durability and availability issues\n\n- Generated columns (MySQL 5.7 instances only)\n\n Due to an issue in MySQL, using generated columns might result in data\n corruption. For more information, see\n [MySQL bug #82736](https://bugs.mysql.com/bug.php?id=82736).\n\n### Instance connection issues\n\n- Expired SSL/TLS certificates\n\n\n If your instance is configured to use SSL, go to the\n [Cloud SQL Instances page](https://console.cloud.google.com/sql/instances)\n in the Google Cloud console and open the instance. Open its **Connections** page, select the\n **Security** tab and make sure that your server certificate is valid. If it has expired, you must\n add a new certificate and rotate to it.\n\n \u003cbr /\u003e\n\n- Cloud SQL Auth Proxy version\n\n If you are connecting using the Cloud SQL Auth Proxy, make sure you are using the\n most recent version. For more information, see\n [Keeping the Cloud SQL Auth Proxy up to date](/sql/docs/mysql/sql-proxy#keep-current).\n- Not authorized to connect\n\n If you try to connect to an instance that does not exist in that project,\n the error message only says that you are not authorized to access that\n instance.\n- Can't create a Cloud SQL instance\n\n If you see the `Failed to create subnetwork. Router status is temporarily\n unavailable. Please try again later. Help Token: [token-ID]` error\n message, try to create the Cloud SQL instance again.\n\n### Administrative issues\n\n- Only one long-running Cloud SQL import or export operation can run at a time on an instance. When you start an operation, make sure you don't need to perform other operations on the instance. Also, when you start the operation, you can [cancel it](/sql/docs/mysql/import-export/cancel-import-export).\n\n- MySQL auto-commits on each DDL statement. Cloud SQL\n persists all steps of the import up to cancelling the\n instance. Therefore, you might have to clean up the data on the\n instance manually.\n\n\u003cbr /\u003e\n\n### Issues with importing and exporting data\n\n- CSV export does not format NULLs and newlines correctly.\n\n When you export data as CSV using the Cloud SQL export feature,\n NULLs are exported as `\"N`, which can cause the CSV file to contain\n unbalanced quotation marks. Additionally, if your\n text data contains a newline character, a trailing quote mark is added\n at the end of the line.\n\n When you import a file that you exported using the default escape character,\n the file treats the value as `\"NULL\"` instead of `NULL`. To override the default\n when you export the file, use `--escape=\"5C\"`.\n\n \u003cbr /\u003e\n\n- The SQL Mode setting affects how Cloud SQL interprets SQL queries.\n\n For example, if you export from a database without Strict SQL enabled, then\n try to import to Cloud SQL (which enables Strict SQL by default), the\n import might fail. The best practice is to use the same SQL Mode on import\n that you used for export.\n\n \u003cbr /\u003e\n\n- The DEFINER clause may cause import to fail\n\n A DEFINER clause may cause an import operation to fail if the DEFINER user is\n a SUPER or system user and is different from the user doing the import into\n Cloud SQL. Learn more about [DEFINER usage](/sql/docs/mysql/import-export#definer-clause)\n and potential workarounds in Cloud SQL.\n\n \u003cbr /\u003e\n\n- If you're trying to import and export data from a large database (for example,\n a database that has 500 GB of data or greater), then the import and export\n operations might take a long time to complete. In addition, other operations\n (for example, the backup operation) aren't available for you to perform\n while the import or export is occurring. A potential option to improve the\n performance of the import and export process is to [restore a previous backup](/sql/docs/mysql/backup-recovery/restoring#projectid) using `gcloud`\n or the API.\n\n\u003c!-- --\u003e\n\n- Cloud Storage supports a [maximum single-object size up five terabytes](/storage-transfer/docs/known-limitations-transfer#object-limit). If you have databases larger than 5TB, the export operation to Cloud Storage fails. In this case, you need to break down your export files into smaller segments.\n\n### Transaction logs and disk growth\n\nLogs are purged once daily, not continuously. When the number of days of log\nretention is configured to be the same as the number of backups, a day of\nlogging might be lost, depending on when the backup occurs. For example, setting\nlog retention to seven days and backup retention to seven backups means that\nbetween six and seven days of logs will be retained.\n\nWe recommend setting the number of backups to at least one more than the days of\nlog retention to guarantee a minimum of specified days of log retention.\n\n### Issues with upgrading your MySQL instance\n\nIf you use Database Migration Service to [upgrade your MySQL instance](/sql/docs/mysql/upgrade-major-db-version-migrate) from version 5.7 to version 8.0, and you have stored procedures created in the database named `mysql` in your version 5.7 instance, then your stored procedures may not get copied to the `mysql` database in the upgraded version 8.0 instance. Also, you may not be able to create stored procedures in the `mysql` database in the upgraded instance.\n\n### Issues with InnoDB page compression\n\n[InnoDB page compression](https://dev.mysql.com/doc/refman/8.0/en/innodb-page-compression.html)\ncan improve the performance of update queries by reducing the amount of data that\nneeds to be read and written to disk. However, page compression can impact performance on the\nupdate queries on frequently updated tables. To evaluate\nthe impact of page compression on your update queries, you can run a performance\ntest with and without page compression. This helps you to observe how page\ncompression affects the performance of your workload.\n\nYou can optimize page compression performance as follows:\n\n- Use a compression algorithm suitable for your data type. For example, use LZ4\n for text data and ZLIB for binary data.\n\n- Avoid using compression for data that is frequently updated.\n Compressing and decompressing data can slow down your update queries.\n\n### Issues related to Cloud Monitoring or Cloud Logging\n\nInstances with the following region names are displayed incorrectly in certain\ncontexts, as follows:\n\n- `us-central1` is displayed as `us-central`\n- `europe-west1` is displayed as `europe`\n- `asia-east1` is displayed as `asia`\n\nThis issue occurs in the following contexts:\n\n- Alerting in Cloud Monitoring\n- Metrics Explorer\n- Cloud Logging\n\nYou can mitigate the issue for Alerting in Cloud Monitoring, and for Metrics\nExplorer, by using\n[Resource metadata labels](https://cloud.google.com/monitoring/api/v3/metric-model#meta-labels).\nUse the system metadata label `region` instead of the\n[cloudsql_database](https://cloud.google.com/monitoring/api/resources#tag_cloudsql_database)\nmonitored resource label `region`."]]
