Cette page répertorie les problèmes les plus fréquents que vous pouvez rencontrer en travaillant avec des instances Cloud SQL, ainsi que la procédure à suivre pour y remédier. Consultez également les pages Problèmes connus, Dépannage et Assistance.
Voir les journaux
Pour afficher des informations sur les opérations récentes, vous pouvez consulter les journaux des opérations des instances Cloud SQL ou les journaux des erreurs PostgreSQL.
Problèmes de connexion
Pour obtenir de l'aide concernant les problèmes de connexion, consultez la page Déboguer les problèmes de connexion ou la section Connectivité de la page de dépannage.
Problèmes d'instance
Sauvegardes
Pour optimiser les performances des sauvegardes, conservez un nombre raisonnable de tables.
Pour les autres problèmes de sauvegarde, consultez la section Sauvegardes de la page de dépannage.
Importation et exportation
L'exécution d'opérations d'importation dans Cloud SQL et d'exportations à partir de Cloud SQL peut prendre beaucoup de temps selon la taille des données traitées. Cela peut avoir les conséquences suivantes :
- Vous ne pouvez pas arrêter une opération d'instance Cloud SQL de longue durée.
- Vous ne pouvez effectuer qu'une seule opération d'importation ou d'exportation à la fois pour chaque instance, tandis qu'une importation ou une exportation de longue durée bloque d'autres opérations, telles que les sauvegardes automatiques quotidiennes. Les exportations sans serveur vous permettent d'exécuter d'autres opérations, comme la modification d'instances, l'importation, le basculement et le déblocage des sauvegardes quotidiennes.
Vous pouvez réduire le temps nécessaire à l'exécution de chaque opération en utilisant la fonctionnalité d'importation ou d'exportation Cloud SQL avec de plus petits lots de données.
Pour les exportations, vous pouvez effectuer l'exportation à partir d'une instance dupliquée avec accès en lecture ou utiliser l'exportation sans serveur afin de minimiser l'impact sur les performances de la base de données et de permettre que d'autres opérations s'exécutent sur votre instance pendant l'exécution d'une exportation.
Pour les autres problèmes d'importation et d'exportation, consultez la section Importation et exportation de la page de dépannage.
Espace disque
Si votre instance atteint l'espace de stockage maximal autorisé, les écritures vers la base de données échouent. Si vous supprimez des données, par exemple en supprimant une table, l'espace est généralement libéré, mais il n'est pas reflété dans l'espace de stockage utilisé indiqué pour l'instance. Vous pouvez exécuter la commandeVACUUM FULL pour récupérer de l'espace non utilisé. Notez que les opérations d'écriture sont bloquées pendant l'exécution de la commande "vacuum". En savoir plus
État suspendu
Cloud SQL peut suspendre une instance pour plusieurs raisons, parmi lesquelles :
Problèmes de facturation
Par exemple, l'instance est susceptible d'être suspendue si la carte de crédit liée au compte de facturation du projet a expiré. Pour vérifier les informations de facturation d'un projet, accédez à la page de facturation de Google Cloud Console, puis sélectionnez le projet pour afficher les informations du compte de facturation correspondantes. Une fois le problème de facturation résolu, l'instance retourne à l'état opérationnel dans les heures qui suivent.
Principaux problèmes liés à KMS
Par exemple, si la version de clé KMS utilisée pour chiffrer les données utilisateur dans l'instance Cloud SQL est absente, ou si elle a été désactivée ou détruite. Reportez-vous à la page Utiliser des clés de chiffrement gérées par le client (CMEK).
Problèmes d'ordre juridique
Par exemple, une violation des Règles d'utilisation autorisée de Google Cloud peut entraîner la suspension de l'instance. Pour en savoir plus, consultez la section "Suspensions et suppressions" dans les Conditions d'utilisation de Google Cloud.
Problèmes opérationnels
Par exemple, si une instance est bloquée dans une boucle de plantage (disons qu'elle se bloque au démarrage ou juste après le démarrage), Cloud SQL est susceptible de la suspendre.
Lorsqu'une instance est suspendue, vous pouvez continuer à afficher les informations la concernant ou la supprimer si la suspension a été déclenchée par des problèmes de facturation.
Les utilisateurs de Cloud SQL disposant des formules d'assistance Platinum, Gold ou Silver peuvent contacter directement notre équipe d'assistance au sujet des instances suspendues. Tous les utilisateurs peuvent utiliser les conseils précédents et accéder au forum google-cloud-sql.
Performances
Présentation
Cloud SQL traite les charges de travail exigeantes en performances et peut gérer jusqu'à 60 000 IOPS sans frais supplémentaires. Les performances d'IOPS et de débit dépendent de facteurs tels que la taille des disques, le nombre de processeurs virtuels de l'instance et la taille des blocs d'E/S.
Les performances de votre instance dépendent également du type de stockage que vous avez choisi et de votre charge de travail.
En savoir plus :
- Disques persistants et performances.
- Performances et métriques de limitation.
- Optimiser les performances des disques.
- Autres facteurs ayant une incidence sur les performances.
Maintenir un nombre raisonnable de tables de base de données
Les tables de base de données consomment des ressources système. Si elles sont très nombreuses, cela peut affecter les performances et la disponibilité de l'instance, et entraîner la perte de sa couverture par le contrat de niveau de service. En savoir plus
Activer les journaux de requêtes
Vous pouvez consigner les requêtes lentes pour Cloud SQL pour PostgreSQL en définissant l'option log_min_duration_statement. Les requêtes exécutées pendant au moins la durée spécifiée sont enregistrées. Si cette valeur est spécifiée sans unité, elle est exprimée en millisecondes. Accédez à la page "Journalisation des opérations" pour afficher les journaux.
Conseils relatifs aux performances générales
Assurez-vous que l'instance n'est pas limitée en termes de mémoire ou de processeur. Pour les charges de travail exigeantes en performances, assurez-vous que votre instance dispose d'au moins 60 Go de mémoire. Si vous rencontrez une latence pendant l'insertion, la mise à jour ou la suppression de bases de données, vérifiez les emplacements du rédacteur et de la base de données. L'envoi de données sur une longue distance entraîne généralement une latence.Améliorez les performances des requêtes à l'aide de Query Insights.
En cas de sélections lentes dans une base de données, prenez en compte les éléments suivants :
- La mise en cache est importante pour les performances de lecture. Vérifiez les différents ratios
blks_hit / (blks_hit + blks_read)dans le collecteur de statistiques de PostgreSQL. Dans l'idéal, le ratio doit être supérieur à 99 %. Si ce n'est pas le cas, envisagez d'augmenter la taille de la mémoire RAM de votre instance. - Si votre charge de travail est composée de requêtes nécessitant une utilisation intensive des processeurs (opérations de tri, expressions régulières et autres fonctions complexes), votre instance peut être limitée. Pensez à ajouter des processeurs virtuels.
- Vérifiez l'emplacement du lecteur et de la base de données. La latence affecte davantage les performances de lecture que les performances d'écriture.
- Recherchez des améliorations de performances spécifiques à SQL en dehors du Cloud, telles que l'ajout d'une indexation appropriée, la réduction du nombre de données à analyser et la réduction du nombre d'allers-retours supplémentaires.
EXPLAIN pour déterminer l'emplacement destiné à l'ajout d'index sur les tables, et ainsi améliorer ces performances. Par exemple, assurez-vous que chaque champ utilisé en tant que clé JOIN (clé de jointure) possède un index sur les deux tables.
Résoudre les problèmes
Si vous rencontrez d'autres problèmes Cloud SQL, consultez la page de Dépannage.
Messages d'erreur
Pour en savoir plus sur les messages d'erreur liés à l'API, consultez la page de référence Messages d'erreur.
Résoudre les problèmes liés aux clés de chiffrement gérées par le client (CMEK)
Les opérations d'administrateur Cloud SQL, telles que la création, le clonage ou la mise à jour peuvent échouer en raison d'erreurs Cloud KMS et de l'absence de rôles ou d'autorisations. Les causes habituelles d'échec sont les suivantes : la version de clé Cloud KMS est manquante, la version de clé Cloud KMS est désactivée ou détruite, les autorisations IAM sont insuffisantes pour accéder à la version de clé Cloud KMS ou la version de clé Cloud KMS se trouve dans une région différente de celle de l'instance Cloud SQL. Utilisez le tableau de dépannage ci-dessous pour diagnostiquer et résoudre les problèmes courants.
Tableau de dépannage des clés de chiffrement gérées par le client
| Pour cette erreur... | Le problème peut être... | Essayez ce qui suit... |
|---|---|---|
| Le compte de service par produit et par projet est introuvable | Le nom du compte de service est incorrect. | Assurez-vous d'avoir créé un compte de service pour le bon projet utilisateur. |
| Impossible d'accorder l'accès au compte de service | Le compte utilisateur n'a pas l'autorisation d'accorder l'accès à cette version de clé. | Ajoutez le rôle Administrateur de l'organisation à votre compte utilisateur ou de service.
|
| La version de clé Cloud KMS est détruite | La version de clé est détruite. | Si la version de clé est détruite, vous ne pouvez pas l'utiliser pour chiffrer ou déchiffrer des données. |
| La version de clé Cloud KMS est désactivée | La version de clé est désactivée. | Réactivez la version de clé Cloud KMS.
|
| Autorisation insuffisante pour utiliser la clé Cloud KMS | Le rôle cloudkms.cryptoKeyEncrypterDecrypter est manquant sur le compte utilisateur ou de service que vous utilisez pour exécuter des opérations sur des instances Cloud SQL, ou la version de clé Cloud KMS n'existe pas. |
Dans le projet Google Cloud qui héberge la clé, ajoutez le rôle cloudkms.cryptoKeyEncrypterDecrypter à votre compte utilisateur ou de service.
Si le rôle est déjà attribué à votre compte, consultez Créer une clé pour savoir comment créer une version de clé. Voir la remarque ci-dessous. |
| La clé Cloud KMS est introuvable | La version de clé n'existe pas. | Créez une nouvelle version de la clé. Consultez la section Créer une clé. Voir la remarque ci-dessous. |
| L'instance Cloud SQL et la version de clé Cloud KMS se trouvent dans des régions différentes | La version de clé Cloud KMS et l'instance Cloud SQL doivent se trouver dans la même région. Cela ne fonctionnera pas si la version de clé Cloud KMS se trouve dans une région mondiale ou dans un emplacement multirégional. | Créez une version de clé dans la même région que celle où vous souhaitez créer des instances. Consultez la section Créer une clé. Voir la remarque ci-dessous. |
| La version de clé Cloud KMS est restaurée, mais l'instance est toujours suspendue | La version de clé est désactivée ou n'accorde pas les autorisations appropriées. | Réactivez la version de clé et attribuez le rôle cloudkms.cryptoKeyEncrypterDecrypter à votre compte utilisateur ou de service dans le projet Google Cloud qui héberge la clé. |
Tableau de dépannage du rechiffrement
| Pour cette erreur... | Le problème peut être... | Essayez ce qui suit... |
|---|---|---|
| Le rechiffrement des ressources CMEK a échoué, car la clé Cloud KMS est inaccessible. Veuillez vous assurer que la version de clé primaire est activée et que l'autorisation est accordée correctement. | La version de clé est désactivée ou n'accorde pas les autorisations appropriées. | Réactivez la version de clé Cloud KMS : ACCÉDER À LA PAGE "CLÉS DE CHIFFREMENT" Dans le projet Google Cloud qui héberge la clé, confirmez que le rôle |
| Échec du rechiffrement des ressources CMEK en raison d'une erreur interne du serveur. Veuillez réessayer plus tard. | Une erreur interne du serveur s'est produite. | Relancez le rechiffrement. Pour en savoir plus, consultez Rechiffrer une instance ou une instance répliquée existante sur laquelle l'option CMEK est activée. |