Skip to content

fetch_datasus

Jump to bottom
Raphael Saldanha edited this page Jan 19, 2018 · 1 revision

Objetivo

A função fetch_datasus é responsável pelo download de dados do site do DataSUS, criando um data.frame como resultado.

Exemplos de uso

dados <- fetch_datasus(year_start = 2010, year_end = 2010, uf = "DF", information_system = "SIM-DO")
dados <- fetch_datasus(year_start = 2010, year_end = 2011, uf = "CE", information_system = "SIM-DOFET")
dados <- fetch_datasus(year_start = 2011, year_end = 2013, information_system = "SIM-DOINF")
dados <- fetch_datasus(year_start = 2013, year_end = 2014, uf = "RJ", information_system = "SIM-DO", vars = c("SEXO", "CAUSABAS"))
dados <- fetch_datasus(year_start = 2011, month_start = 1, year_end = 2011, month_end = 2, information_system = "SIH-RD")

Argumentos

A função aceita os seguintes argumentos:

  • year_start : Ano inicial.
  • month_start : Mês inicial.
  • year_end : Ano final.
  • month_end : Mês final.
  • uf : Unidade Federativa.
  • information_system : Sistema de informações.
  • vars : Variáveis de interesse.

year_start

  • Obrigatório.
  • Numérico.
  • Em um período de tempo, específica o primeiro ano dos dados.
  • Deve ser informado no formato YYYY. Exemplo: 2014

month_start

  • Obrigatório para os sistemas SIH, CNES e SIA.
  • Numérico.
  • Em um período de tempo, específica o primeiro mês dos dados.
  • Deve ser informado no formato MM. Exemplo: 1 para janeiro.

year_end

  • Obrigatório.
  • Numérico.
  • Em um período de tempo, específica o último ano dos dados.
  • Deve ser informado no formato YYYY. Exemplo: 2014

month_end

  • Obrigatório para os sistemas SIH, CNES e SIA.
  • Numérico.
  • Em um período de tempo, específica o último mês dos dados.
  • Deve ser informado no formato MM. Exemplo: 1 para janeiro.

uf

  • Obrigatório. Por padrão utiliza uf = "all", acessando arquivos de todas as UFs.
  • Para especificar um estado, utilize a sigla em maiúsculo do mesmo. Por exemplo: uf = "MG".
  • Os sistemas SIM-DOFET, SIM-DOEXT, SIM-DOINF e SIM-DOMAT não são fornecidos por UF pelo DataSUS. Nestes casos, este argumento é ignorado.
  • A especificação de uf diz respeito a UF de processamento de dados. A UF de residência do caso, por exemplo, pode ser diferente.

information_system

  • Obrigatório.
  • Aceita: SIM-DO, SIM-DOFET, SIM-DOEXT, SIM-DOINF, SIM-DOMAT, SINASC, SIH-RD, SIH-RJ, SIH-SP, SIH-ER, CNES-LT, CNES-ST, CNES-DC, CNES-EQ, CNES-SR, CNES-HB, CNES-PF, CNES-EP, CNES-RC, CNES-IN, CNES-EE, CNES-EF, CNES-GM, SIA-AB, SIA-ABO, SIA-ACF, SIA-AD, SIA-AN, SIA-AM, SIA-AQ, SIA-AR, SIA-ATD, SIA-PA, SIA-PS, SIA-SAD.

vars

  • Opcional. Como padrão, mantém todas as variáveis do banco.
  • Para especificar as variáveis de interesse, informe um vetor. Exemplo: vars = c("SEXO", "CAUSABAS").

Detalhes

  • Para a utilização desta função é necessário que o computador esteja conectado à Internet e que o site FTP do DataSUS esteja funcionando corretamente.
  • Ao tentar realizar o download de dados de um período em que não haja dados disponíveis ou se ocorrer alguma falha na Internet durante o processo de download, a função irá realizar o download dos dados que estejam disponíveis e informar quais arquivos não puderam ser baixados. Esteja atento às mensagens do processo de download.
  • Esta função baixa os arquivos DBC do site do DataSUS para uma pasta temporária e os lê através do pacote read.dbc.
  • Após o download, os arquivos DBC são apagados do computador, restando apenas o data.frame de descarga especificado no R.
  • Alguns sistemas de informação apresentam variáveis diferentes no decorrer dos anos. Ao realizar o download de dados nestes períodos, a função acrescenta as variáveis novas preenchendo automaticamente com NA os registros de anos em que ela não existia através da função plyr::rbind.fill().
Clone this wiki locally