Esta página contém uma lista dos problemas mais frequentes que você pode encontrar ao trabalhar com instâncias do Cloud SQL e as etapas que você pode seguir para solucioná-los. Consulte também as páginas Problemas conhecidos , Solução de problemas e Suporte .
Ver registros
Para ver informações sobre operações recentes, você pode visualizar os logs de operação da instância do Cloud SQL ou os logs de erro do PostgreSQL .
Problemas de conexão
Consulte a página Depuração de problemas de conexão ou a seção Conectividade na página de solução de problemas para obter ajuda com problemas de conexão.
Problemas de instância
Backups
Para obter o melhor desempenho dos backups , mantenha o número de tabelas em um número razoável.
Para outros problemas de backup, consulte a seção Backups na página de solução de problemas.
Importação e exportação
Importações para o Cloud SQL e exportações a partir do Cloud SQL podem levar muito tempo para serem concluídas, dependendo do tamanho dos dados processados. Isso pode ter os seguintes impactos:
- Não é possível interromper uma operação de instância de longa execução do Cloud SQL.
- Você pode executar apenas uma operação de importação ou exportação por vez para cada instância, e uma importação ou exportação de longa duração bloqueia outras operações, como backups diários automatizados. Exportações sem servidor permitem que você execute outras operações, incluindo edição de instâncias, importação, failover e desbloqueio de backups diários automatizados.
Você pode diminuir o tempo necessário para concluir cada operação usando a funcionalidade de importação ou exportação do Cloud SQL com lotes menores de dados.
Para exportações, você pode executar a exportação de uma réplica de leitura ou usar a exportação sem servidor para minimizar o impacto no desempenho do banco de dados e permitir que outras operações sejam executadas na sua instância enquanto uma exportação estiver em execução.
Para outros problemas de importação e exportação, consulte a seção Importação e exportação na página de solução de problemas.
Espaço em disco
Se a sua instância atingir a quantidade máxima de armazenamento permitida, as gravações no banco de dados falharão. Se você excluir dados, por exemplo, removendo uma tabela, o espaço será liberado, mas não será refletido no Armazenamento Usado relatado da instância. Você pode executar o comandoVACUUM FULL para recuperar o espaço não utilizado; observe que as operações de gravação são bloqueadas enquanto o comando vacuum estiver em execução. Saiba mais .Estado suspenso
Há vários motivos pelos quais o Cloud SQL pode suspender uma instância, incluindo:
Problemas de faturamento
Por exemplo, se o cartão de crédito da conta de cobrança do projeto tiver expirado, a instância poderá ser suspensa. Você pode verificar as informações de cobrança de um projeto acessando o Google Cloud página de faturamento do console, selecionando o projeto e visualizando as informações da conta de faturamento usada para o projeto. Após resolver o problema de faturamento, a instância retornará ao status executável em algumas horas.
Principais problemas com o Cloud Key Management Service
Por exemplo, se a versão da chave do Cloud KMS usada para criptografar os dados do usuário na instância do Cloud SQL não estiver presente, o acesso à chave será revogado ou a chave será desativada ou excluída. Para obter mais informações, consulte Usando chaves de criptografia gerenciadas pelo cliente (CMEK) .
Questões legais
Por exemplo, uma violação da Google Cloud A Política de Uso Aceitável pode causar a suspensão da instância. Para obter mais informações, consulte "Suspensões e Remoções" no Google Cloud Termos de Serviço .
Questões operacionais
Por exemplo, se uma instância estiver presa em um loop de falha (ela trava durante a inicialização ou logo após a inicialização), o Cloud SQL poderá suspendê-la.
Enquanto uma instância estiver suspensa, você poderá continuar visualizando informações sobre ela ou excluí-la, caso problemas de cobrança tenham acionado a suspensão.
Usuários do Cloud SQL com pacotes de suporte Platinum, Gold ou Silver podem entrar em contato diretamente com nossa equipe de suporte sobre instâncias suspensas. Todos os usuários podem usar as orientações anteriores, juntamente com o fórum google-cloud-sql .
Desempenho
Visão geral
O Cloud SQL oferece suporte a cargas de trabalho de alto desempenho com até 60.000 IOPS e sem custo extra para E/S. O desempenho de IOPS e throughput depende do tamanho do disco, da contagem de vCPUs da instância e do tamanho do bloco de E/S, entre outros fatores.
O desempenho da sua instância também depende da sua escolha de tipo de armazenamento e carga de trabalho.
Saiba mais sobre:
- Discos persistentes e desempenho .
- Métricas de desempenho e limitação .
- Otimizando o desempenho do disco .
- Outros fatores que afetam o desempenho .
Mantenha um número razoável de tabelas de banco de dados
As tabelas do banco de dados consomem recursos do sistema. Um número grande delas pode afetar o desempenho e a disponibilidade da instância, fazendo com que ela perca a cobertura do SLA. Saiba mais .
Habilitar logs de consulta
Você pode registrar consultas lentas no Cloud SQL para PostgreSQL definindo o sinalizador log_min_duration_statement . As consultas executadas por pelo menos o tempo especificado serão registradas. Se esse valor for especificado sem unidades, será considerado em milissegundos. Navegue até Registro de Operações para visualizar os registros.
Dicas gerais de desempenho
Certifique-se de que sua instância não esteja limitada em termos de memória ou CPU. Para cargas de trabalho com alto desempenho, certifique-se de que sua instância tenha pelo menos 60 GB de memória. Para inserções, atualizações ou exclusões lentas no banco de dados, verifique a localização do gravador e do banco de dados; o envio de dados a longas distâncias gera latência.Melhore o desempenho da consulta usando o Query Insights .
Para seleções lentas de banco de dados, considere o seguinte:
- O cache é importante para o desempenho de leitura. Verifique as diversas proporções
blks_hit / (blks_hit + blks_read)no Coletor de Estatísticas do PostgreSQL . O ideal é que a proporção seja superior a 99%. Caso contrário, considere aumentar o tamanho da RAM da sua instância. - Se sua carga de trabalho consistir em consultas que exigem muita CPU (classificação, expressões regulares, outras funções complexas), sua instância poderá ser limitada; adicione vCPUs.
- Verifique a localização do leitor e do banco de dados - a latência afeta o desempenho de leitura ainda mais do que o desempenho de gravação.
- Investigue melhorias de desempenho não específicas do Cloud SQL, como adicionar indexação apropriada, reduzir dados verificados e evitar viagens de ida e volta extras.
EXPLAIN para identificar onde adicionar índices às tabelas para melhorar o desempenho da consulta. Por exemplo, certifique-se de que cada campo usado como chave JOIN tenha um índice em ambas as tabelas.Solução de problemas
Para outros problemas do Cloud SQL, consulte a página de solução de problemas .
Mensagens de erro
Para mensagens de erro específicas da API, consulte a página de referência de mensagens de erro .
Solucionar problemas de chaves de criptografia gerenciadas pelo cliente (CMEK)
Operações do administrador do Cloud SQL, como criar, clonar ou atualizar, podem falhar devido a erros do Cloud KMS e funções ou permissões ausentes. Os motivos comuns para falhas incluem uma versão ausente da chave do Cloud KMS, uma versão desativada ou destruída da chave do Cloud KMS, permissões insuficientes do IAM para acessar a versão da chave do Cloud KMS ou a versão da chave do Cloud KMS estar em uma região diferente da instância do Cloud SQL. Use a tabela de solução de problemas a seguir para diagnosticar e resolver problemas comuns.
Tabela de solução de problemas de chaves de criptografia gerenciadas pelo cliente
| Para este erro... | O problema pode ser... | Experimente isto... |
|---|---|---|
| Conta de serviço por produto e por projeto não encontrada | O nome da conta de serviço está incorreto. | Certifique-se de ter criado uma conta de serviço para o projeto de usuário correto. |
| Não é possível conceder acesso à conta de serviço | A conta de usuário não tem permissão para conceder acesso a esta versão de chave. | Adicione a função de Administrador da Organização à sua conta de usuário ou serviço. |
| A versão da chave do Cloud KMS foi destruída | A versão chave é destruída. | Se a versão da chave for destruída, você não poderá usá-la para criptografar ou descriptografar dados. |
| A versão da chave do Cloud KMS está desabilitada | A versão da chave está desativada. | Reative a versão da chave do Cloud KMS. |
| Permissão insuficiente para usar a chave do Cloud KMS | A função cloudkms.cryptoKeyEncrypterDecrypter está ausente na conta de usuário ou serviço que você está usando para executar operações em instâncias do Cloud SQL, ou a versão da chave do Cloud KMS não existe. | No Google Cloud projeto que hospeda a chave, adicione a função cloudkms.cryptoKeyEncrypterDecrypter à sua conta de usuário ou serviço.IR PARA A PÁGINA DE CONTAS IAM Se a função já tiver sido concedida à sua conta, consulte "Criando uma chave" para saber como criar uma nova versão de chave. Consulte a observação. |
| A chave do Cloud KMS não foi encontrada | A versão chave não existe. | Crie uma nova versão de chave. Consulte Criação de uma chave . Consulte a nota. |
| A instância do Cloud SQL e a versão da chave do Cloud KMS estão em regiões diferentes | A versão da chave do Cloud KMS e a instância do Cloud SQL devem estar na mesma região. Não funciona se a versão da chave do Cloud KMS estiver em uma região global ou multirregional. | Crie uma versão de chave na mesma região onde você deseja criar instâncias. Consulte Criação de uma chave . Consulte a observação. |
| A versão da chave do Cloud KMS foi restaurada, mas a instância ainda está suspensa | A versão da chave está desabilitada ou não concede permissões adequadas. | Reative a versão da chave e conceda a função cloudkms.cryptoKeyEncrypterDecrypter à sua conta de usuário ou serviço no Google Cloud projeto que hospeda a chave. |
Tabela de solução de problemas de reencriptação
| Para este erro... | O problema pode ser... | Experimente isto... |
|---|---|---|
| A recriptografia do recurso CMEK falhou porque a chave do Cloud KMS está inacessível. Certifique-se de que a versão da chave primária esteja habilitada e que a permissão tenha sido concedida corretamente. | A versão da chave está desabilitada ou não concede permissões adequadas. | Reative a versão da chave do Cloud KMS: IR PARA A PÁGINA DE CHAVES DE CRIPTOMOEDA No Google Cloud projeto que hospeda a chave, confirme se a função |
| A recriptografia do recurso CMEK falhou devido a um erro interno do servidor. Tente novamente mais tarde. | Há um erro interno do servidor. | Tente criptografar novamente. Para obter mais informações, consulte Recriptografar uma instância ou réplica existente habilitada para CMEK. |