Data Sources

Visão Geral

Data Sources são conectores configuráveis dentro da plataforma que possibilitam a integração com sistemas externos para consulta, manipulação e sincronização de dados. A plataforma suporta múltiplos tipos de conectores, abrangendo APIs REST e bancos de dados relacionais e não relacionais, garantindo flexibilidade para atender diferentes cenários de negócio.

Tipos de Data Sources Suportados

REST API

• Permite a configuração completa de conexões RESTful, incluindo:
  • Definição do endpoint base
  • Configuração de métodos HTTP (GET, POST, PUT, DELETE, etc.)
  • Cadastro de endpoints específicos para diferentes operações
  • Suporte a múltiplos tipos de autenticação, tais como: Basic Auth, OAuth 2.0, API Keys, Token Bearer, entre outros
  • Customização de headers e parâmetros de consulta
  • Possibilidade de testes de conexão e de chamadas específicas diretamente na interface

Bancos de Dados Não Relacionais

• MongoDB
  • Permite configuração detalhada de collections e operações CRUD:
    • findOne — busca de um único documento
    • find — busca de múltiplos documentos
    • insert — inserção de documentos
    • update — atualização de documentos
    • delete — remoção de documentos
  • Configuração de filtros, projeções e ordenações para consultas
  • Testes de conexão e validação dos comandos configurados

Bancos de Dados Relacionais

• OracleDB, SQL Server, MySQL (e outros compatíveis)
  • Permite configuração de conexões utilizando drivers nativos e parametrização avançada
  • Cadastro e execução de queries dinâmicas ou estáticas
  • Suporte a stored procedures e scripts complexos conforme o banco suportar
  • Realização de testes de conexão para validação antes da utilização em produção

Interface de Gerenciamento

Cada data source possui uma interface dedicada para:

• Configuração dos parâmetros de conexão (host, porta, credenciais, opções específicas)
• Definição e gerenciamento dos elementos que compõem o conector (endpoints, queries, collections, etc.)
• Execução de testes de conexão e chamadas para validar a configuração
• Monitoramento básico do status de conexão

Segurança e Governança

Credenciais

• As credenciais utilizadas na tela de teste de conexão dos conectores não são utilizadas em integrações ou gateways em produção.
• Para garantir segurança e controle de acesso, é necessário criar credenciais específicas na tela de Credentials da plataforma.
• Essas credenciais devem ser vinculadas a um tenant, garantindo que cada ambiente tenha seu controle isolado e seguro.
• Essa separação assegura que dados sensíveis não fiquem expostos em testes e que o uso em produção seja sempre autorizado e auditado.

Processo para Solicitação de Novos Conectores

Caso seja necessário suportar um novo tipo de conector que não esteja disponível na plataforma, o seguinte processo deve ser seguido:

• A solicitação deve ser registrada através de um ticket direcionado ao time Kruzer.
• O time realizará uma análise técnica e de viabilidade da demanda.
• Se a solicitação for aprovada, o desenvolvimento do novo conector será realizado em até uma semana útil.
• Após desenvolvimento, o conector passará por fase de testes e homologação antes de ser disponibilizado em produção.

Considerações Operacionais

• A correta configuração dos data sources é fundamental para a estabilidade e eficiência das integrações.
• Recomenda-se testar exaustivamente as conexões e operações configuradas antes de ativar integrações em ambientes produtivos.
• É possível versionar configurações e manter histórico para auditoria e rollback.

Exemplos de Uso

• Consumo de APIs REST de sistemas externos para sincronização de dados cadastrais.
• Consulta e atualização de coleções MongoDB para gerenciamento de informações não estruturadas.
• Execução de queries SQL para extração e transformação de dados em bancos relacionais.

---