Base Territorial (base-territorial)
Resumo
O base-territorial contém as tabelas territoriais de referência do DATASUS, que descrevem a divisão político-administrativa e sanitária do Brasil: unidades da federação, municípios, regiões e microrregiões de saúde, macrorregiões, regiões metropolitanas, distritos sanitários, territórios da cidadania e a relação entre municípios e cada um desses recortes. Cada registro (linha) é uma entidade territorial ou um vínculo município–recorte, em uma versão mensal do cadastro. É a base de apoio para padronizar e cruzar códigos territoriais usados em todos os sistemas de informação do SUS.
Ficha técnica
Origem e coleta
- Formato dos arquivos (índice de 2026-10, conforme a página anterior):
.zip (contendo tabelas .dbf, .csv, .xml e .txt de layout)
- Particionamento (índice de 2026-10, conforme a página anterior):
version (versão mensal, ex.: 2026-06)
- Cobertura temporal no FTP (índice de 2026-10, conforme a página anterior): Versões mensais; versão mais recente
2026-06 (conforme index.json)
- Volume aproximado no FTP (índice de 2026-10, conforme a página anterior): 21 arquivos versionados (~33 MB)
- Documentação oficial no FTP (índice de 2026-10, conforme a página anterior):
/territorio/doc (bases_territoriais.pdf, registro_de_alteracoes.pdf)
Diretório FTP (dir) |
Prefixo (filename_prefix) |
Padrão (filename_pattern) |
Extensão |
Preliminar |
/territorio/tabelas |
(vazio) |
<MM>-base_territorial_<mês><AA>.zip (por versão mensal) |
zip |
Não |
Nomenclatura e Armazenamento Local
- No servidor FTP (
ftp.datasus.gov.br): exemplo real 06-base_territorial_jun26.zip (em /territorio/tabelas/2026/) — 06 é o mês, base_territorial o assunto, jun26 o mês abreviado e ano. Dentro do ZIP há os arquivos tb_*.dbf/csv/xml/txt e rl_*.dbf/csv/xml/txt e os respectivos *_layout.txt (definição de colunas).
- No armazenamento local do
datasus-fetcher: como o particionamento é por versão, o arquivo vai para data/base-territorial/base-territorial_<versão>@<AAAAMMDD>.zip, por exemplo data/base-territorial/[email protected].
- Documentação e Tabelas Auxiliares associadas: em
/territorio/doc estão bases_territoriais.pdf (descrição das tabelas e relacionamentos) e registro_de_alteracoes.pdf (histórico de mudanças). Não há pacote de auxiliares separado — as tabelas territoriais são o próprio conteúdo do ZIP.
Conteúdo
A Base Territorial é mantida pelo Ministério da Saúde/DATASUS e consolida, em um formato único e versionado, a divisão territorial usada pelos sistemas de informação em saúde. Ela reúne tabelas de domínio territorial (tb_*), como tb_uf, tb_municip, tb_regiao, tb_regsaud, tb_macsaud, tb_regmetr, tb_micibge, tb_divadm, tb_pndr, tb_dsei e tb_terrcid, e tabelas de relacionamento (rl_*) que associam cada município aos recortes aos quais pertence.
O evento gerador é a atualização periódica (mensal) do cadastro territorial quando há criação, extinção ou alteração de municípios e mudanças nos recortes de saúde (regiões/macrorregiões de saúde, regiões metropolitanas, PNDR, territórios da cidadania). A unidade de análise varia conforme a tabela: para tb_*, é uma entidade territorial (ex.: um município em tb_municip); para rl_*, é um vínculo (ex.: a associação CO_MUNICIP → CO_REGSAUD). A competência mês/ano aparece no nome do arquivo e nos metadados da versão.
A série é versionada por competência (não é uma série histórica de dados, e sim sucessivas versões do cadastro). As versões são organizadas por ano em /territorio/tabelas/<ano>/, com o nome MM-base_territorial_<mês><AA>.zip. O documento registro_de_alteracoes.pdf registra as mudanças entre versões. Não há diretório preliminar.
Aplicações analíticas típicas: padronização de códigos de município (6 e 7 dígitos) e de UF, enriquecimento de bases de saúde com atributos territoriais (capital, Amazônia Legal, semiárido, faixa de fronteira, município de extrema pobreza), mapeamento de municípios para regiões de saúde e macrorregiões, e construção de agregações regionais para indicadores.
Variáveis de uso mais frequente (resumo da versão anterior desta página)
| Tabela (DBF) |
Coluna |
Tipo / Formato |
Descrição |
tb_municip |
CO_MUNICIP |
String (6) |
Código IBGE do município (sem dígito verificador) |
tb_municip |
CO_MUNICDV |
String (7) |
Código IBGE do município (com dígito verificador) |
tb_municip |
CO_UF / CO_REGIAO |
String (2/1) |
UF e macrorregião do município |
tb_municip |
IN_CAPITAL / IN_AMAZLEG / IN_SEMIAR |
String (1) |
Indicadores: capital, Amazônia Legal, semiárido |
tb_municip |
NU_LATITUD / NU_LONGIT / NU_AREA |
Float |
Latitude, longitude, altitude e área do município |
tb_uf |
CO_UF / DS_SIGLA / DS_NOME |
String |
Código, sigla e nome da UF |
tb_regsaud / tb_macsaud |
CO_REGSAUD / CO_MACSAUD, DS_NOME |
String |
Região e macrorregião de saúde |
rl_municip_regsaud |
CO_MUNICIP, CO_REGSAUD |
String |
Relacionamento município → região de saúde |
rl_municip_macsaud |
CO_MUNICIP, CO_MACSAUD |
String |
Relacionamento município → macrorregião de saúde |
rl_municip_divadm |
CO_MUNICIP, CO_DIVADM |
String |
Relacionamento município → divisão administrativa estadual |
tb_divadm / tb_dsei |
CO_DIVADM / CO_DSEI, DS_NOME |
String |
Divisão administrativa estadual / distrito sanitário especial indígena |
Variáveis
O ZIP mais recente da base territorial vira um dataset do lake por tabela (base-territorial-<tabela>, com _ trocado por -). Cada tabela abaixo tem o dicionário das colunas do lake (esquema de amostra: base-territorial-tb-municip e demais, versão 2026-06 do ZIP).
Tabela rl_municip_divadm (dataset base-territorial-rl-municip-divadm)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_divadm |
CO_DIVADM |
texto |
Código da divisão administrativa estadual |
— |
todos |
Tabela rl_municip_dsei (dataset base-territorial-rl-municip-dsei)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_dsei |
CO_DSEI |
texto |
Código do Distrito Sanitário Especial Indígena (DSEI) |
— |
todos |
Tabela rl_municip_macsaud (dataset base-territorial-rl-municip-macsaud)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_macsaud |
CO_MACSAUD |
texto |
Código da macrorregião de saúde |
— |
todos |
Tabela rl_municip_micibge (dataset base-territorial-rl-municip-micibge)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_micibge |
CO_MICIBGE |
texto |
Código da microrregião do IBGE |
— |
todos |
Tabela rl_municip_pndr (dataset base-territorial-rl-municip-pndr)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_pndr |
CO_PNDR |
texto |
Código do recorte da Política Nacional de Desenvolvimento Regional (PNDR) |
— |
todos |
Tabela rl_municip_regmetr (dataset base-territorial-rl-municip-regmetr)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_regmet |
CO_REGMET |
texto |
Código da região metropolitana |
— |
todos |
Tabela rl_municip_regsaud (dataset base-territorial-rl-municip-regsaud)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_regsaud |
CO_REGSAUD |
texto |
Código da região de saúde |
— |
todos |
Tabela rl_municip_terrcid (dataset base-territorial-rl-municip-terrcid)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_terrcid |
CO_TERRCID |
texto |
Código do território da cidadania |
— |
todos |
Tabela rl_regsaud_macsaud (dataset base-territorial-rl-regsaud-macsaud)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_regsaud |
CO_REGSAUD |
texto |
Código da região de saúde |
— |
todos |
co_macrorr |
CO_MACRORR |
texto |
Código da macrorregião de saúde ao qual a região de saúde pertence |
— |
todos |
Tabela tb_divadm (dataset base-territorial-tb-divadm)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_divadm |
CO_DIVADM |
texto |
Código da divisão administrativa estadual |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
ds_abrev |
DS_ABREV |
texto |
Nome abreviado |
— |
todos |
nu_ordem |
NU_ORDEM |
texto |
Ordem de apresentação do registro nos arquivos de conversão |
— |
todos |
Tabela tb_divadmant (dataset base-territorial-tb-divadmant)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_divadm |
CO_DIVADM |
texto |
Código da divisão administrativa estadual |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
ds_abrev |
DS_ABREV |
texto |
Nome abreviado |
— |
todos |
nu_ordem |
NU_ORDEM |
texto |
Ordem de apresentação do registro nos arquivos de conversão |
— |
todos |
Tabela tb_dsei (dataset base-territorial-tb-dsei)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_dsei |
CO_DSEI |
texto |
Código do Distrito Sanitário Especial Indígena (DSEI) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
co_sede |
CO_SEDE |
texto |
Sem descrição na documentação oficial consultada; o nome é o do campo no arquivo de origem |
— |
todos |
Tabela tb_macsaud (dataset base-territorial-tb-macsaud)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_macsaud |
CO_MACSAUD |
texto |
Código da macrorregião de saúde |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
ds_abrev |
DS_ABREV |
texto |
Nome abreviado |
— |
todos |
nu_ordem |
NU_ORDEM |
texto |
Ordem de apresentação do registro nos arquivos de conversão |
— |
todos |
Tabela tb_micibge (dataset base-territorial-tb-micibge)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_micibge |
CO_MICIBGE |
texto |
Código da microrregião do IBGE |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
ds_abrev |
DS_ABREV |
texto |
Nome abreviado |
— |
todos |
nu_ordem |
NU_ORDEM |
texto |
Ordem de apresentação do registro nos arquivos de conversão |
— |
todos |
Tabela tb_mis (dataset base-territorial-tb-mis)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_mis |
CO_MIS |
texto |
Sem descrição na documentação oficial consultada; o nome é o do campo no arquivo de origem |
— |
todos |
nome_mis |
NOME_MIS |
texto |
Sem descrição na documentação oficial consultada; o nome é o do campo no arquivo de origem |
— |
todos |
co_munic_i |
CO_MUNIC_I |
texto |
Sem descrição na documentação oficial consultada; o nome é o do campo no arquivo de origem |
— |
todos |
nu_ordem |
NU_ORDEM |
texto |
Ordem de apresentação do registro nos arquivos de conversão |
— |
todos |
Tabela tb_municip (dataset base-territorial-tb-municip)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_municip |
CO_MUNICIP |
texto |
Código IBGE do município, sem o dígito de controle (6 dígitos) |
— |
todos |
co_municdv |
CO_MUNICDV |
texto |
Código IBGE do município, com o dígito de controle (7 dígitos) |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
co_tipo |
CO_TIPO |
texto |
Tipo da unidade (por exemplo, MUNIC, DISFED, DISEST, TERRIT ou IGNOR em municípios) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
uf |
UF |
texto |
UF do município (sigla ou código, conforme a versão do arquivo) (inferido do nome do campo; sem definição na documentação oficial consultada) |
— |
todos |
macrorregi |
MACRORREGI |
texto |
Macrorregião (do IBGE) do município (inferido do nome do campo; sem definição na documentação oficial consultada) |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
ds_observ |
DS_OBSERV |
texto |
Observações (nome antigo, situação da transferência etc.) |
— |
todos |
co_regiao |
CO_REGIAO |
texto |
Código da região do país em que o registro está localizado |
— |
todos |
co_uf |
CO_UF |
texto |
Código da unidade da federação (2 dígitos, padrão IBGE) |
— |
todos |
co_alter |
CO_ALTER |
texto |
Códigos alternativos usados para o município, separados por vírgula ou em faixa |
— |
todos |
co_alterdv |
CO_ALTERDV |
texto |
Códigos alternativos, com o dígito verificador |
— |
todos |
in_capital |
IN_CAPITAL |
texto |
Capital: F federal; E estadual; N não é capital |
— |
todos |
in_amazleg |
IN_AMAZLEG |
texto |
Faz parte da Amazônia Legal (S ou N) |
— |
todos |
in_semiar |
IN_SEMIAR |
texto |
Faz parte do Semiárido (S ou N) |
— |
todos |
in_frontzn |
IN_FRONTZN |
texto |
Faz parte da zona de fronteira (S ou N) |
— |
todos |
dt_instal |
DT_INSTAL |
texto |
Ano de instalação do município (não disponível para todos) |
— |
todos |
dt_extin |
DT_EXTIN |
texto |
Ano de extinção ou transferência do município |
— |
todos |
co_sucess |
CO_SUCESS |
texto |
Código do registro sucessor ao extinto ou transferido |
— |
todos |
nu_ordem |
NU_ORDEM |
texto |
Ordem de apresentação do registro nos arquivos de conversão |
— |
todos |
nu_ordmap |
NU_ORDMAP |
texto |
Ordem de apresentação do registro nos arquivos de conversão para mapas |
— |
todos |
nu_latitud |
NU_LATITUD |
texto |
Latitude da sede do município |
— |
todos |
nu_longit |
NU_LONGIT |
texto |
Longitude da sede do município |
— |
todos |
nu_altitud |
NU_ALTITUD |
texto |
Altitude, em metros, da sede do município |
— |
todos |
nu_area |
NU_AREA |
texto |
Área, em quilômetros quadrados |
— |
todos |
Tabela tb_pndr (dataset base-territorial-tb-pndr)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_pndr |
CO_PNDR |
texto |
Código do recorte da Política Nacional de Desenvolvimento Regional (PNDR) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
nu_ordmap |
NU_ORDMAP |
inteiro |
Ordem de apresentação do registro nos arquivos de conversão para mapas |
— |
todos |
Tabela tb_regiao (dataset base-territorial-tb-regiao)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_regiao |
CO_REGIAO |
texto |
Código da região do país em que o registro está localizado |
— |
todos |
no_regiao |
NO_REGIAO |
texto |
Nome da região do país |
— |
todos |
sg_regiao |
SG_REGIAO |
texto |
Sigla da região do país |
— |
todos |
st_registr |
ST_REGISTR |
texto |
Situação do registro da região (inferido do nome do campo; sem definição na documentação oficial consultada) |
— |
todos |
Tabela tb_regmetr (dataset base-territorial-tb-regmetr)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_regmetr |
CO_REGMETR |
texto |
Código da região metropolitana |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
co_tipo |
CO_TIPO |
texto |
Tipo da unidade (por exemplo, MUNIC, DISFED, DISEST, TERRIT ou IGNOR em municípios) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
ds_abrev |
DS_ABREV |
texto |
Nome abreviado |
— |
todos |
nu_ordem |
NU_ORDEM |
texto |
Ordem de apresentação do registro nos arquivos de conversão |
— |
todos |
Tabela tb_regsaud (dataset base-territorial-tb-regsaud)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_regsaud |
CO_REGSAUD |
texto |
Código da região de saúde |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
ds_abrev |
DS_ABREV |
texto |
Nome abreviado |
— |
todos |
nu_ordem |
NU_ORDEM |
texto |
Ordem de apresentação do registro nos arquivos de conversão |
— |
todos |
Tabela tb_terrcid (dataset base-territorial-tb-terrcid)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_terrcid |
CO_TERRCID |
texto |
Código do território da cidadania |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
nu_ordmap |
NU_ORDMAP |
inteiro |
Ordem de apresentação do registro nos arquivos de conversão para mapas |
— |
todos |
Tabela tb_uf (dataset base-territorial-tb-uf)
| Coluna no lake |
Na fonte |
Tipo |
Descrição |
Unidade / códigos |
Período |
co_uf |
CO_UF |
texto |
Código da unidade da federação (2 dígitos, padrão IBGE) |
— |
todos |
ds_sigla |
DS_SIGLA |
texto |
Sigla da unidade da federação |
— |
todos |
co_status |
CO_STATUS |
texto |
Situação do registro (por exemplo, ATIVO, EXTINT, TRANSF ou IGNOR) |
— |
todos |
ds_nome |
DS_NOME |
texto |
Nome do registro |
— |
todos |
ds_nomepad |
DS_NOMEPAD |
texto |
Nome padronizado, sem acentuação e em letras maiúsculas |
— |
todos |
co_sucess |
CO_SUCESS |
texto |
Código do registro sucessor ao extinto ou transferido |
— |
todos |
co_regiao |
CO_REGIAO |
texto |
Código da região do país em que o registro está localizado |
— |
todos |
nu_area |
NU_AREA |
texto |
Área, em quilômetros quadrados |
— |
todos |
No lake
- Estado
parcial: os datasets do lake são datasus/base-territorial-<tabela> (não há datasus/base-territorial). Só o ZIP de carimbo mais recente é convertido; as versões anteriores são ignoradas (superado no inventário).
- Cada tabela é gravada sem partição, com a coluna
uf e a _origem ausentes (tabelas de domínio). Tipos: as amostras da conversão mostram todas as colunas como texto (large_string) e nu_ordmap das tabelas pndr e terrcid como inteiro; nas tabelas em DBF os tipos vêm declarados, nas em CSV tudo vem como texto.
- Esquemas de referência: não há
base-territorial.schema.json, porque o id declarado pelo conversor (base-territorial) não existe como dataset do lake; o esquema de cada tabela fica nos arquivos base-territorial-<tabela>.schema.json desta pasta.
Cuidados de uso
- Misturar versões do ZIP gera inconsistências; fixe uma versão (texto da versão anterior desta página).
- O conversor lê só a versão mais recente: se a análise precisar de uma versão específica, converta o ZIP dela separadamente.
Exemplos
Consulta sobre o lake (polars)
Quantos municípios ativos há por UF na base territorial?
import polars as pl
(
pl.scan_parquet("lake/datasus/base-territorial-tb-municip/*.parquet")
.filter(pl.col("co_status") == "ATIVO")
.group_by("co_uf")
.agg(pl.len().alias("municipios"))
.sort("co_uf")
.collect()
)
Pela linha de comando (datasus-fetcher)
# o que o FTP publica para o dataset (arquivos e tamanho)
datasus-fetcher list base-territorial
# baixa um recorte, com a documentação oficial e as tabelas auxiliares (`--dry-run` só lista)
datasus-fetcher sync base-territorial -o ./data --docs --aux
# converte o que foi baixado para o lake (Parquet particionado)
datasus-fetcher convert -i ./data -o ./lake --dataset base-territorial
Referências
- Servidor FTP do DATASUS:
ftp://ftp.datasus.gov.br/territorio/tabelas
- Portal de Transferência de Arquivos do DATASUS: https://datasus.saude.gov.br/transferencia-de-arquivos/
- TabNet DATASUS: https://datasus.saude.gov.br/informacoes-de-saude-tabnet/
- Documentação
bases_territoriais.pdf e registro_de_alteracoes.pdf: ftp://ftp.datasus.gov.br/territorio/doc
- IBGE — Divisão Político-Administrativa e malha territorial: https://www.ibge.gov.br/geociencias/organizacao-do-territorio.html
- PCDaS/Fiocruz — Bases territoriais: https://pcdas.icict.fiocruz.br/