# aurora\_ccm\_status
Exibe o status do gerenciador de cache do cluster.
## Sintaxe
```
aurora_ccm_status()
```
## Argumentos
Nenhum.
## Tipo de retorno
Registro SETOF com as seguintes colunas:
+ `buffers_sent_last_minute`: quantos buffers foram enviados ao leitor designado no último minuto.
+ `buffers_found_last_minute`: o número de buffers acessados com frequência que foram identificados durante o último minuto.
+ `buffers_sent_last_scan`: quantos buffers foram enviados ao leitor designado durante a última verificação completa do cache em buffer.
+ `buffers_found_last_scan`: quantos buffers acessados com frequência foram enviados durante a última verificação completa do cache em buffer. Os buffers que já estão em cache no leitor designado não são enviados.
+ `buffers_sent_current_scan`: quantos buffers foram enviados durante a verificação atual.
+ `buffers_found_current_scan`: o número de buffers acessados com frequência identificados na verificação atual.
+ `current_scan_progress`: quantos buffers foram visitados durante a verificação atual até agora.
## Observações de uso
É possível usar essa função para verificar e monitorar o recurso de gerenciamento de cache de cluster (CCM). Essa função opera somente quando o CCM está ativo no cluster de banco de dados do Aurora PostgreSQL. Para usar essa função, conecte-se à instância de banco de dados de gravação no cluster de banco de dados do Aurora PostgreSQL.
Ative o CCM para um cluster de banco de dados do Aurora PostgreSQL definindo a opção `apg_ccm_enabled` como 1 no grupo de parâmetros de cluster de banco de dados personalizado. Para saber como, consulte [Configuração do gerenciamento de cache do cluster](AuroraPostgreSQL.cluster-cache-mgmt.md#AuroraPostgreSQL.cluster-cache-mgmt.Configure).
O gerenciamento de cache do cluster está ativo em um cluster de banco de dados do Aurora PostgreSQL quando o cluster tem uma instância do leitor do Aurora configurada da seguinte forma:
+ A instância do leitor do Aurora usa o mesmo tipo e tamanho de classe que a instância de banco de dados da instância do gravador do cluster.
+ A instância do leitor do Aurora está configurada como Nível 0 para o cluster. Se o cluster tiver mais de um leitor, esse será o único leitor Nível 0.
A definição de mais de um leitor como Nível 0 desativa o CCM. Quando o CCM está desativado, a chamada dessa função retornará a seguinte mensagem de erro:
```
ERROR: Cluster Cache Manager is disabled
```
Também é possível usar a extensão pg\_buffercache do PostgreSQL para analisar o cache do buffer. Para obter mais informações, consulte [pg\_buffercache](https://www.postgresql.org/docs/current/pgbuffercache.html) na documentação do PostgreSQL.
Para obter mais informações, consulte [Introdução ao gerenciamento de cache do cluster do Aurora PostgreSQL](https://aws.amazon.com/blogs/database/introduction-to-aurora-postgresql-cluster-cache-management/).
## Exemplos
O exemplo a seguir mostra os resultados de uma chamada à função `aurora_ccm_status`. Este primeiro exemplo mostra as estatísticas do 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
```
Para obter detalhes mais completos, use a exibição expandida, conforme mostrado a seguir:
```
\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
```
Este exemplo mostra como verificar a taxa de aquecimento e a porcentagem de aquecimento.
```
=> 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
```