Ajuda de consultas e dimensoes

Guia rapido do que o chat publicado em /mcp entende hoje em linguagem natural e quais dimensoes podem ser usadas nas analises.

O chat opera em modo somente leitura sobre mack.view_dados. Ele aceita SQL de leitura e perguntas em linguagem natural que geram SQL segura para a view permitida.
Se quiser forcar um grafico, use termos como estatistica, grafico, distribuicao, comparar ou perfil. O chat tende a montar barras, donut ou barras agrupadas conforme o retorno.

Como escrever perguntas que funcionam melhor

Estrutura recomendada

  • Informe a metrica: populacao, percentual, participacao, ranking.
  • Informe a dimensao: sexo, cor/raca, grupo de idade, alfabetizacao.
  • Informe o recorte: estado, regiao, cidade, municipio.
  • Quando quiser visual, inclua com grafico ou no mesmo grafico.

Exemplos de formula

  • Gere uma estatistica com base na cor na regiao norte com grafico
  • Compare sexo e cor na regiao sul no mesmo grafico
  • Qual o percentual por estado?
  • Quais cidades tem maior altitude no Brasil? traga top 10 com estado

Dimensoes disponiveis

sexo

Distribuicoes e comparacoes por sexo.

sexohomensmulheresmasculinofeminino

cor_raca

Analises por cor/raca declarada.

corracacor/racabrancospretospardos

grupo_idade

Faixas etarias e comparacoes geracionais.

idadefaixa etariagrupo idade

alfabetizacao

Distribuicao entre alfabetizados e nao alfabetizados.

alfabetizacaoalfabetizadoanalfabeto

estado, uf e regiao

Recortes geograficos maiores para rankings, comparacoes e percentuais.

estadoufregiaonortenordeste

municipio e porte

Analises por cidade e porte da cidade.

municipiocidadetamanho_cidadeporte

latitude, longitude e altitude

Dimensoes geograficas para recortes espaciais e rankings.

latitudelongitudealtitude

id_municipio

Usado para contagens distintas de municipios.

id_municipiocontagem de cidades

quantidade_populacao

Metrica base para totais, medias e percentuais.

populacaototalpercentual

Possibilidades de consulta

Estatisticas por dimensao

  • Gere uma estatistica com base na cor na regiao norte com grafico
  • Gere uma estatistica com base no sexo no estado de Sao Paulo com grafico
  • Gere uma estatistica com base na alfabetizacao na regiao nordeste com grafico
  • Gere uma estatistica com base no grupo de idade no estado de Minas Gerais com grafico

Exemplos por estado

  • Gere uma estatistica com base no sexo no estado de Sao Paulo com grafico
  • Gere uma estatistica com base no grupo de idade no estado de Minas Gerais com grafico
  • Qual a participacao por estado?
  • Distribuicao de sexo por estado

Exemplos por municipio e cidade

  • Gere uma estatistica com base na cor na cidade de Sao Paulo com grafico
  • Quais sao as 5 maiores cidades por populacao?
  • Quais os 10 municipios mais ao norte? usar latitude
  • Top 10 municipios mais a oeste pelo menor valor de longitude

Comparacoes entre dimensoes

  • Compare sexo e cor na regiao sul no mesmo grafico
  • Comparar estado e cor/raca
  • Distribuicao de sexo por estado
  • Compare sexo e alfabetizacao no mesmo grafico

Percentuais e participacao

  • Qual o percentual por sexo?
  • Qual a participacao por estado?
  • Percentual de populacao branca por regiao em relacao ao Brasil
  • Quais sao as 5 maiores cidades por populacao e percentual em relacao ao estado?

Rankings e top listas

  • Quais cidades tem maior altitude no Brasil? traga top 10 com estado
  • Quais os 10 municipios mais ao norte? usar latitude
  • Top 10 municipios mais a oeste pelo menor valor de longitude
  • Quais sao as 5 maiores cidades por populacao?
  • Ranking combinado por municipio

Altitude e faixas

  • Quero a populacao totalizada por altitude e percentual desta populacao com relacao ao total separando por cada 100 metros
  • Populacao por altitude com percentual
  • Quais cidades tem maior altitude no Brasil? traga top 10 com estado

Graficos e leitura visual

  • Use com grafico para distribuicoes simples por uma dimensao.
  • Use no mesmo grafico quando quiser comparar duas dimensoes.
  • Percentuais com poucas categorias tendem a virar visualizacao tipo donut.
  • Comparacoes com duas dimensoes tendem a virar barras agrupadas.

SQL de leitura

  • SELECT estado, SUM(quantidade_populacao) AS populacao_total FROM mack.view_dados GROUP BY estado ORDER BY populacao_total DESC LIMIT 10
  • WITH base AS (...) SELECT ...
  • Apenas SELECT, WITH e EXPLAIN sao aceitos.

Recortes prontos por tema

Cor e raca

  • Gere uma estatistica com base na cor na regiao norte com grafico
  • Comparar estado e cor/raca
  • Percentual de populacao branca por regiao em relacao ao Brasil

Sexo

  • Gere uma estatistica com base no sexo no estado de Sao Paulo com grafico
  • Qual o percentual por sexo?
  • Compare sexo e cor na regiao sul no mesmo grafico

Faixa etaria

  • Gere uma estatistica com base no grupo de idade no estado de Minas Gerais com grafico
  • Distribuicao por grupo de idade
  • Perfil de grupo de idade por regiao

Alfabetizacao

  • Gere uma estatistica com base na alfabetizacao na regiao nordeste com grafico
  • Compare sexo e alfabetizacao no mesmo grafico
  • Distribuicao por alfabetizacao

Regras importantes