01. Objetivo

Este documento tem como objetivo orientar as áreas de negócio sobre como utilizar as classes do Datasul para extrair informações do Change Data Capture (CDC), garantindo que possam utilizar essa funcionalidade de maneira eficiente e segura. 

O CDC é um mecanismo que permite capturar e registrar alterações feitas nos dados do banco de dados, facilitando a extração e o processamento dessas informações.

02. Configuração do Ambiente

Para utilizar as classes do Datasul relacionadas ao CDC, é necessário garantir que:

  • O CDC esteja ativado no banco de dados Progress OpenEdge.

  • As permissões adequadas tenham sido concedidas ao usuário de acesso.

  • O ambiente Datasul esteja devidamente configurado.

03. Script Base

run_script_cdc.p

Inicialmente, para que se consiga rodar o programa script_cdc.p (que será detalhado mais abaixo) e fazer o resgate dos registros, deve obrigatoriamente criar o alias "dictdb", conforme abaixo:


script_cdc.p

Abaixo há o detalhamento dos parâmetros necessários para que seja possível instanciar a classe que irá conter os dados das tabelas:

  • racTenant (LONGCHAR): Tenant ID do RAC;
  • logicalDBName (CHARACTER): Nome lógico da base de dados;
  • tableName (CHARACTER): Nome da tabela;
  • dateFrom (DATETIME-TZ): Data de início das alterações;
  • dateTo (DATETIME-TZ): Data final das alterações;
  • filter (CHARACTER): Adição de filtro na query (Exemplo: "cod_status = 9")


No script abaixo disponibilizado, estamos instanciando a classe DataSyncExtract(), que é a classe que fará a inicialização dos dados das tabelas do CDC conforme parâmetros enviados:


Fazendo a instância corretamente conforme explicado acima, o objeto oJsonData irá conter um Json com o retorno dos registros conforme parâmetros enviados no método oExtractData:getDataFromTable.

04. Boas Práticas

  • Filtrar os dados: Sempre especifique um intervalo de tempo ou um critério de filtro para evitar extrações muito grandes.

  • Manter logs: Registre logs das execuções para auditoria e depuração.

  • Testar em ambiente de homologação: Antes de utilizar em produção, faça testes para validar os resultados.

05. Conclusão

Com essa documentação, as áreas de negócio podem utilizar as classes do Datasul de forma eficaz para extrair os dados do CDC.

O uso correto dessas classes permite uma melhor gestão das informações.