aurora_ccm_status

Affiche l'état du gestionnaire de cache du cluster.

Syntaxe

aurora_ccm_status()

Arguments

Aucun.

Type de retour

Registre SETOF avec les colonnes suivantes :

• buffers_sent_last_minute – Nombre de tampons envoyés au lecteur désigné au cours de la dernière minute.

• buffers_found_last_minute : nombre de tampons fréquemment consultés, identifiés au cours de la dernière minute.

• buffers_sent_last_scan – Nombre de tampons envoyés au lecteur désigné au cours de la dernière analyse terminée du cache du tampon.

• buffers_found_last_scan – Nombre de tampons fréquemment consultés envoyés au cours de la dernière analyse terminée du cache du tampon. Les tampons déjà mis en cache sur le lecteur désigné ne sont pas envoyés.

• buffers_sent_current_scan – Nombre de tampons envoyés au cours de l'analyse actuelle.

• buffers_found_current_scan – Nombre de tampons fréquemment consultés qui ont été identifiés au cours de l'analyse actuelle.

• current_scan_progress – Nombre de tampons visités jusqu'à maintenant au cours de l'analyse actuelle.

Notes d'utilisation

Vous pouvez utiliser cette fonction pour vérifier et surveiller la fonctionnalité de gestion de cache du cluster (CCM). Cette fonction fonctionne uniquement si la CCM est active sur votre cluster de bases de données Aurora PostgreSQL. Pour utiliser cette fonction, connectez-vous à l'instance de base de données d'écriture sur votre cluster de bases de données Aurora PostgreSQL.

Activez la CCM pour un cluster de bases de données Aurora PostgreSQL en définissant apg_ccm_enabled sur 1 dans le groupe de paramètres de cluster de bases de données personnalisé du cluster. Pour savoir comment procéder, veuillez consulter la section Configuration de la gestion des caches de clusters.

La gestion de cache du cluster est active sur un cluster de bases de données Aurora PostgreSQL lorsque le cluster dispose d'une instance Aurora Reader configurée comme suit :

• L'instance Aurora Reader utilise le même type et la même taille de classe d'instance de base de données que l'instance d'enregistreur du cluster.

• L'instance Aurora Reader est configurée en tant que niveau 0 pour le cluster. Si le cluster possède plusieurs lecteurs, il s'agit de son seul lecteur de niveau 0.

La définition de plusieurs lecteurs sur le niveau 0 désactive la CCM. Lorsque la CCM est désactivée, l'appel de cette fonction renvoie le message d'erreur suivant :

ERROR: Cluster Cache Manager is disabled

Vous pouvez également utiliser l'extension pg_buffercache PostgreSQL pour analyser le cache du tampon. Pour plus d'informations, consultez pg_buffercache dans la documentation de PostgreSQL.

Pour plus d'informations, consultez Introduction to Aurora PostgreSQL cluster cache management.

Exemples

L'exemple suivant montre les résultats de l'appel de la fonction aurora_ccm_status. Ce premier exemple montre les statistiques CCM.

=> SELECT * FROM aurora_ccm_status();
 buffers_sent_last_minute | buffers_found_last_minute | buffers_sent_last_scan | buffers_found_last_scan | buffers_sent_current_scan | buffers_found_current_scan | current_scan_progress
--------------------------+---------------------------+------------------------+-------------------------+---------------------------+----------------------------+-----------------------
                  2242000 |                   2242003 |               17920442 |                17923410 |                  14098000 |                   14100964 |              15877443

Pour plus de détails, vous pouvez utiliser l'affichage développé, comme indiqué ci-dessous :

\x
Expanded display is on.
SELECT *  FROM aurora_ccm_status();
[ RECORD 1 ]-----------------------+---------
buffers_sent_last_minute           | 2242000
buffers_found_last_minute          | 2242003
buffers_sent_last_scan             | 17920442
buffers_found_last_scan            | 17923410
buffers_sent_current_scan          | 14098000
buffers_found_current_scan         | 14100964
current_scan_progress              | 15877443

Cet exemple montre comment vérifier le débit d'activation et le pourcentage d'activation.

=> SELECT buffers_sent_last_minute * 8/60 AS warm_rate_kbps,
100 * (1.0-buffers_sent_last_scan/buffers_found_last_scan) AS warm_percent 
FROM aurora_ccm_status ();
 warm_rate_kbps | warm_percent
----------------+--------------
 16523 |        100.0