Execução TOTVS Fast Analytics®
Linha de Produto: | Microsiga Protheus® |
Segmento: | Serviços |
Módulo: | TOTVS Fast Analytics® |
Requisito/Story/Issue (informe o requisito relacionado): | DSERBA1-1449 |
País(es): | Brasil |
Banco(s) de Dados: | Microsoft SQL Server® e Oracle® |
Tabelas Utilizadas: | I01 - Consultas do TOTVS Fast Analytics® |
Sistema(s) Operacional(is): | Windows® e Linux® |
Descrição
O TOTVS Fast Analytics® têm como objetivo a extração de informações relevantes por meio de consultas pré-definidas para apresentá-las aos nossos clientes na plataforma Gooddata®.
O Agent executará a extração de dados, geração dos arquivos .csv e envio para o GoodData® executando os seguintes passos:
- Leitura das queries de arquivo .zip ou caso não esse não exista à partir da da tabela de consultas - I01.
- Execução das queries obtidas para geração dos arquivos .csv
- Caso haja alguma inconsistência na execução de um consulta, o processo de execução não será interrompido. E o erro será registrado no arquivo de log.
- Envio dos arquivos .csv para o GoodData®.
- Execução do Main Job para atualização dos graphs do GoodData®.
As consultas da tabela I01 podem ser parametrizadas através do arquivo de configurações my.properties, essa funcionalidade permite uma flexibilidade na execução das consultas, pois o usuário pode informar os valores que atendem seu cenário.
Cada parâmetro deve estar entre "<<" e ">>" .
Um exemplo de parametrização seria o período de execução das tabelas fato, onde poderia ser informado um parâmetro do tipo date de início e fim que aquela entidade carregaria os dados. Nesse contexto, um exemplo de período seria:
Select * from tabela_fato where data between <<data_de>> and <<data_ate>>
No arquivo de configuração my.properties, esses parâmetros devem ser informados da seguinte maneira:
- param.data_de=20170101
- param.data_ate=20171005
Procedimento para Implantação
Para que o sistema seja atualizado é necessário realizar o download do pacote mais atualizado do TOTVS Fast Analytics®.
- Os arquivos my.properties, log4j.properties e Run.bat também devem estar nesse diretório.
Procedimento para configuração dos parâmetros
Abra o arquivo my.properties com um editor de textos. Configure os parâmetros de data de início e fim da extração. Exemplo:
Parâmetro
Valor
param.START_DATE
'20170101'
param.FINAL_DATE
'20171231'
param.EXTRACTION_DATE '20171912'
Procedimento para utilização
- No diretório do Agent, execute o Run.bat.
- Se informado o parâmetro gdc.query_zip no arquivo my.properties a extração ocorrerá com base no .zip, caso contrário serão lidas as consultas gravadas na tabela I01.
Para acompanhar os passos da leitura das consultas, é possível abrir o arquivo agent.log que está contido no diretório log.
No log serão exibidos pontos informativos de início e fim dos processos do Agent, além da impressão dos parâmetros inseridos no arquivo my.properties e o tempo de execução das consultas, caso o log do Agent esteja em modo debug. - Aguarde a finalização do processo.