Bem-vindo ao repositório do projeto de Extração e Tratamento de Dados para Bancos de Dados Relacionais! Este projeto foi desenvolvido com o objetivo de facilitar a obtenção, tratamento e inclusão de dados provenientes do Cadastro Nacional da Pessoa Jurídica (CNPJ), um banco de dados gerenciado pela Secretaria Especial da Receita Federal do Brasil (RFB).
A fonte principal dos dados utilizados neste projeto é o Cadastro Nacional da Pessoa Jurídica (CNPJ), um banco de dados que armazena informações cadastrais das pessoas jurídicas e outras entidades de interesse das administrações tributárias da União, dos Estados, do Distrito Federal e dos Municípios. O Ministério da Fazenda, órgão da estrutura administrativa da República Federativa do Brasil, é responsável pela formulação e execução da política econômica e tem papel fundamental na gestão do Cadastro Nacional da Pessoa Jurídica.
O projeto oferece as seguintes funcionalidades principais:
-
Extração de Dados: Capacidade de acessar a fonte de dados do CNPJ e obter informações cadastrais das pessoas jurídicas e entidades correlatas.
-
Tratamento de Dados: Implementação de mecanismos para limpeza, transformação e preparação dos dados extraídos, assegurando a qualidade e consistência das informações.
-
Integração com Bancos de Dados Relacionais: Facilidade para incluir os dados tratados em um banco de dados relacional escolhido, como SQLite, MySQL ou PostgreSQL, tornando-os acessíveis para aplicações e análises.
Para utilizar o projeto, siga os passos a seguir:
- Clone o Repositório: Abra um terminal ou prompt de comando e execute o seguinte comando para clonar o repositório em sua máquina local:
git clone https://github.com/elizandrodantas/cnpj-data-go.git
- Navegue até o Diretório do Projeto: Acesse a pasta do projeto por meio do terminal, navegando para o diretório
cmd/cnpj-gov-go/
:
cd caminho/do/projeto/cmd/cnpj-data-go/
- Build com Go: Com o Go instalado em sua máquina, realize o build do projeto com o seguinte comando:
go build
Após a execução bem-sucedida do comando acima, será gerado um executável com o nome do projeto no diretório atual.
- Execução do Projeto: Agora que o projeto foi compilado, você pode executá-lo para iniciar o processo de extração e tratamento dos dados do CNPJ. Utilize o seguinte comando:
./cnpj-gov-go -D <driver> -host <host> -user <usuario> -pass <senha> -port <porta> -dbname <nome_do_banco> -ssl <modo_ssl> -F <pasta>
As flags disponíveis são:
-D
: Flag para selecionar o driver do banco de dados a ser utilizado. Opções possíveis:sqlite3
,mysql
,postgres
. O padrão ésqlite3
caso não seja especificado.-host
: Host do banco de dados.-user
: Nome do usuário para autenticação no banco de dados.-pass
: Senha do usuário para autenticação no banco de dados.-port
: Porta para conexão com o banco de dados.-dbname
: Nome do banco de dados que será utilizado.-ssl
: Modo de conexão com SSL (caso seja necessário).-drop
: Essa flag é responsável por fazer um drop em todas as tabelas do banco de dados. Ao utilizar essa opção, todas as informações existentes nas tabelas serão apagadas.-F <pasta>
: Essa flag permite fazer a migração do banco de dados a partir de um arquivo ao invés de fazer o download padrão. Você deve passar o valor correspondente à pasta em que se encontram os bancos a serem migrados. Os bancos estão disponíveis em Dados Aberto -> Recursos.-ignore-create-table
: Ignora a criação das tabelas.
Nenhuma das flags é obrigatória. Caso você não forneça nenhuma delas, o projeto utilizará o banco de dados SQLite como padrão.
Se você deseja contribuir com melhorias, correções de bugs ou novas funcionalidades, fique à vontade para enviar um pull request.
Este projeto é distribuído sob a licença MIT
. Para mais detalhes, consulte o arquivo LICENSE
.