Uso de pg_stat_statements e pg_buffercache
Aproveite extensões avançadas, como `pg_stat_statements` e `pg_buffercache`, para obter análises detalhadas de desempenho.
Uso de pg_stat_statements e pg_buffercache é uma aula grátis de PostgreSQL Performance & Query Optimization no CoddyKit. Esta é a aula 1 de 4. Você pode ler a aula completa abaixo gratuitamente — depois pratica ao vivo no navegador com um editor de código integrado e um tutor de IA 24/7. Faz parte do caminho de aprendizado de PostgreSQL Performance & Query Optimization, e seu progresso é sincronizado entre a web e o app CoddyKit. O curso de PostgreSQL Performance & Query Optimization inclui 4 aulas no total.
Partes desta aula ainda não foram traduzidas e aparecem em inglês.
PostgreSQL Extensions: Power-Ups
PostgreSQL is incredibly powerful, and its functionality can be extended even further using extensions.
Extensions are modules that add new functions, data types, operators, and more to your database. They're like plugins that enhance your database's capabilities without modifying its core code.
In this lesson, we'll explore two crucial extensions for performance monitoring: pg_stat_statements and pg_buffercache.
Meet pg_stat_statements: Query Profiler
pg_stat_statements is an invaluable tool for understanding your database's workload. It tracks execution statistics for all SQL statements executed by the server.
This extension helps you identify:
- Which queries are run most frequently.
- Which queries consume the most total time.
- Queries with high average execution times.
- Queries that read/write a lot of disk blocks.
It's your go-to for pinpointing performance bottlenecks at the query level.
Activating pg_stat_statements
To use pg_stat_statements, you first need to enable it in your PostgreSQL configuration.
1. Edit your postgresql.conf file and add pg_stat_statements to the shared_preload_libraries parameter. E.g., shared_preload_libraries = 'pg_stat_statements'.
2. Restart your PostgreSQL server for the change to take effect.
3. Finally, connect to your database and create the extension:
CREATE EXTENSION pg_stat_statements;Deciphering pg_stat_statements Output
Once enabled, pg_stat_statements collects data in a view named pg_stat_statements. Here are some key columns you'll often check:
query: The normalized SQL statement.calls: How many times the query was executed.total_time: Total time spent executing this query (in milliseconds).mean_time: Average execution time per call.rows: Total rows returned or affected.shared_blks_hit/shared_blks_read: Cache hits vs. disk reads.
Sorting by total_time helps find the biggest overall resource consumers.
Practical Example: Top Queries
Let's see how to find the top 5 queries that have consumed the most total execution time. This query helps you prioritize your optimization efforts.
The hit_percent column gives you an idea of how effective PostgreSQL's buffer cache is for that query.
SELECT
query,
calls,
total_time,
mean_time,
rows,
100.0 * shared_blks_hit / (shared_blks_hit + shared_blks_read + 1) AS hit_percent
FROM
pg_stat_statements
ORDER BY
total_time DESC
LIMIT 5;Meet pg_buffercache: Memory Inspector
While pg_stat_statements shows you query performance, pg_buffercache gives you insight into PostgreSQL's shared buffer cache. This is the memory area where PostgreSQL stores frequently accessed data blocks.
Understanding what's in the buffer cache helps you determine:
- Which tables or indexes are most actively used.
- If your
shared_bufferssetting is adequate. - Whether queries are benefiting from cached data or hitting disk.
Activating pg_buffercache
Enabling pg_buffercache is simpler than pg_stat_statements. It typically does not require modification to shared_preload_libraries or a server restart.
You just need to connect to your database and create the extension:
CREATE EXTENSION pg_buffercache;Peeking into the Shared Buffer Cache
After creating the extension, you can query the pg_buffercache view to see which relations (tables or indexes) occupy the most buffers. Each buffer typically represents an 8KB data block.
This query shows the top 5 relations by the number of buffers they occupy in the cache:
SELECT
c.relname AS relation_name,
count(*) AS buffers_in_cache
FROM
pg_buffercache b
JOIN
pg_class c ON b.relfilenode = c.relfilenode
JOIN
pg_database d ON b.reldatabase = d.oid AND d.datname = current_database()
GROUP BY
c.relname
ORDER BY
buffers_in_cache DESC
LIMIT 5;Interpreting Cache Effectiveness
If a table or index consistently appears at the top of the pg_buffercache output with many buffers, it means that data is frequently accessed and kept in memory.
This is generally a good sign, as memory access is much faster than disk I/O. A high hit_percent in pg_stat_statements often correlates with data being present in the buffer cache.
You can use this information to decide if increasing shared_buffers or optimizing queries to access less data would be beneficial.
Quick Check: Monitoring Tools
Which of the following statements are true regarding pg_stat_statements and pg_buffercache?
Recap: Deep Dives with Extensions
Great job! You've learned how to leverage two powerful PostgreSQL extensions for performance monitoring:
pg_stat_statements: Your essential tool for profiling SQL queries, identifying slow-running or frequently executed statements, and understanding their resource consumption.pg_buffercache: Gives you visibility into the shared buffer cache, helping you understand what data is actively residing in memory and how effectively your caching is working.
Combined, these extensions provide deep insights into your database's workload and memory utilization, guiding your optimization efforts.
Perguntas Frequentes
A aula “Uso de pg_stat_statements e pg_buffercache” é grátis?
Sim — o texto completo de “Uso de pg_stat_statements e pg_buffercache” é grátis para ler aqui na web. Para praticá-la interativamente (um editor de código integrado e um tutor de IA 24/7) e desbloquear o restante do curso de PostgreSQL Performance & Query Optimization, atualize para CoddyKit PRO. O curso de PostgreSQL Performance & Query Optimization inclui 4 aulas no total.
O que vou aprender em “Uso de pg_stat_statements e pg_buffercache”?
Aproveite extensões avançadas, como `pg_stat_statements` e `pg_buffercache`, para obter análises detalhadas de desempenho. Você pratica PostgreSQL Performance & Query Optimization com código prático que executa diretamente no navegador, e um tutor de IA 24/7 responde suas dúvidas enquanto trabalha na aula.
Preciso ter experiência prévia para começar PostgreSQL Performance & Query Optimization?
Nenhuma experiência prévia é necessária. PostgreSQL Performance & Query Optimization no CoddyKit é estruturado para alunos iniciantes até avançados, então você pode começar aqui ou desde o início e aprender no seu ritmo. Esta é a aula 1 de 4.
Quanto tempo leva a aula “Uso de pg_stat_statements e pg_buffercache”?
A maioria das aulas CoddyKit leva cerca de 5–10 minutos. Cada uma é compacta e interativa, então você faz progresso constante e retoma exatamente de onde parou entre web e app.
Posso escrever e executar código nesta aula de PostgreSQL Performance & Query Optimization?
Sim. Cada aula de PostgreSQL Performance & Query Optimization inclui um editor de código integrado, então você escreve e executa código real direto no navegador e recebe feedback de IA instantaneamente — nenhuma configuração local necessária.
Todas as aulas deste curso
- Uso de pg_stat_statements e pg_buffercache
- Configuração de registros para análise
- Integração com ferramentas externas de monitoramento
- Diagnosticando atividades em tempo real com pg_stat_activity