Page tree

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 120 Next »

Configuração do arquivo my.properties do Agent

Produto:

TOTVS Smart Analytics

Ocorrência:

Como configurar o arquivo my.properties para a execução do Agent?

Passo a passo:

A seguir, a relação dos parâmetros existentes no Agent e como preenchê-los no arquivo do my.properties:

Parâmetros obrigatórios:

1. Estes parâmetros realizam a conexão com a nuvem do GoodData e com o projeto de ETL do Smart Analytics.

E-mail completo do usuário:

Parâmetro: gdc.username

Exemplo: gdc.username = [email protected]

Observação: Este usuário deve ser Administrador no GoodData.

Senha do GoodData:

Parâmetro: gdc.password

Exemplo: gdc.password = senha

URL de envio do arquivo compactado para o GoodData:

Parâmetro: gdc.upload_url

Exemplo: gdc.upload_url = https://na1-di.gooddata.com/project-uploads/<Project_ID>/today/

Observação: Saiba como obter o valor do Project_ID em: Como obtenho o valor do Project_ID e do Process_ID

URL de execução do ETL do TOTVS Smart Analytics:

Parâmetro: gdc.etl.process_url

Exemplo: gdc.etl.process_url = https://na1.gooddata.com/gdc/projects/<Project_ID>/dataload/processes/<Process_ID>/

Observação: Saiba como obter o valor do Project_ID e/ou do Process_ID em: Como obtenho o valor do Project_ID e do Process_ID

Parâmetro referente à execução do graph que inicia o ETL do Smart Analytics:

Parâmetro: gdc.etl.graph

Exemplo: gdc.etl.graph = Totvs Smart Analytics v11/graph/MAIN_JOB.grf

Observação: Geralmente, este parâmetro não deve ser alterado. Para checar a necessidade de mudá-lo, acesse o seguinte documento: erro 404 Not Found.


2. Os parâmetros abaixo se referem ao Java Database Connectivity (JDBC). Cada Banco de Dados possui sua própria configuração, aqui seguem os mais utilizados. Para mais exemplos de JDBC consulte o item: erros de JDBC.

Diretório e .JAR do Banco de Dados utilizado:

Parâmetro: jdbc.driver_path

Exemplo: jdbc.driver_path = C:/jdbc/sqljdbc4.jar

Observação: Este .jar não é o arquivo do Agent e sim o arquivo do Banco de Dados. Cada banco de dados possui seu próprio .jar. Se necessário, consulte o fabricante do software para solicitá-lo.

Driver de conexão do JDBC:

Parâmetro: jdbc.driver

Exemplo: jdbc.driver= com.microsoft.sqlserver.jdbc.SQLServerDriver

Observação: Cada banco de dados possui a sua própria conexão de driver. Segue abaixo as possíveis conexões nos principais bancos de dados:

  •  IBM DB2: 

jdbc.driver = com.ibm.db2.jdbc.app.DB2Driver

  • Oracle Thin:

jdbc.driver=oracle.jdbc.driver.OracleDriver

  • PostgreSQL (a partir da v7.0):

jdbc.driver=org.postgresql.Driver

  • Microsoft SQL Server 2000 (Microsoft Driver):

jdbc.driver=com.microsoft.sqlserver.jdbc.SQLServerDriver

  • Progress (OpenEdge):

jdbc.driver=com.ddtek.jdbc.openedge.OpenEdgeDriver


Para solicitar o driver do banco de dados e obter mais informações, consulte o fabricante do software.

URL de conexão do JDBC com o Banco de Dados:

Paramentro: jdbc.url

Exemplo: jdbc.url= jdbc:microsoft:sqlserver://localhost;DatabaseName=FluigSmartData

Observação: Cada Banco de Dados possui a sua própria URL de conexão. Segue abaixo as possíveis URLs dos principais Bancos de Dados:

  • IBM DB2

jdbc.url=jdbc:db2://<HOST>:<PORT>/<DB>

  • Oracle Thin

jdbc.url=jdbc:oracle:thin:@<HOST>:<PORT>:<SID>

  • PostgreSQL (v7.0 and later)

jdbc.url=jdbc:postgresql://<HOST>:<PORT>/<DB>

  • Microsoft SQL Server 2000 (Microsoft Driver)

jdbc.url=jdbc:microsoft:sqlserver://<HOST>;DatabaseName=<DB>

  • Progress (OpenEdge)

jdbc.url=jdbc:datadirect:openedge://<HOST>;databaseName=<DB>

Usuário do Banco de Dados:

Parâmetro: jdbc.username

Exemplo: jdbc.username = usuário

Senha do Banco de Dados:

Parâmetro: jdbc.password

Exemplo: jdbc.password = senha

Observação: Os demais itens NÃO devem sofrer alterações, exceto se ocorrer uma atualização do Agent ou solicitação pela área de inovação de B.A.

Parâmetros Opcionais:

Parâmetro de Usuário e Senha para acessar o ETL do Smart Analytics:

Parâmetro: gdc.etl.param.USER_PWD_SECURE_DI

Exemplo: gdc.etl.param.USER_PWD_SECURE_DI = email%40totvs.com.br:senha

Observação: Certos símbolos devem ser substituídos pelo seu código em hexadecimal, por exemplo o @ deve ser alterado por %40.

Verificação do status da tabela HJK mais de uma vez, por exemplo quando o Extrator e o Agent rodam paralelamente. Para isso pode-se utilizar estes parâmetros:

Parâmetro: gdc.hjkTrying

Exemplo: gdc.hjkTrying = <Valor01>, onde <Valor01> refere-se à quantidade de tentativas a serem efetuadas.


Parâmetro: gdc.hjkSecond

Exemplo: gdc.hjkSecond = <Valor02>, onde esse <Valor02> representa os segundos que o sistema deverá aguardar para executar a próxima tentativa.


Observação: Os parâmetros citados acima devem ser utilizados de forma conjunta.

Conversão de campos do tipo data para string. Isso é possível por meio dos parâmetros a seguir:

Parâmetro: gdc.jbdc.file_date

Exemplo: C:\<Caminho_arquivo>\DATE_FIELD.txt, onde <Caminho_arquivo> é o local do diretório onde encontra-se o arquivo DATE_FIELD.txt.


Parâmetro: gdc.jdbc.format_date

Exemplo: gdc.jdbc.format_date = <CONVERSAO>, onde <CONVERSAO> representa a função utilizada para conversão, que deve ser escolhida entre as duas opções abaixo. Esta função depende do Banco de Dados utilizado, por exemplo, se o Banco de Dados for o Oracle, deve-se utilizar a Opção 1, no caso do SQL Server, use a Opção 2.

  • Opção 1: To_Char(FIELD_DATE, 'yyyyMMdd')
  • Opção 2: Convert(VARCHAR(08), FIELD_DATE, 112)


Observação: Os parâmetros citados acima devem ser utilizados de forma conjunta.

Realizar múltiplas tentativas do upload dos arquivos CSVs. Por exemplo, no caso da conexão com a internet estar intermitente, portanto deve-se utilizar os parâmetros a seguir:

Parâmetro: gdc.uploadTrying

Exemplo: gdc.uploadTrying = <Valor>, onde <Valor> é a quantidade de tentativas a serem feitas para tentar subir os arquivos.


Parâmetro: gdc.uploadSecond

Exemplo: gdc.uploadSecond = <Valor>, onde esse <Valor> representa os segundos que o sistema deverá aguardar para a próxima tentativa.


Observação: Os parâmetros citados acima devem ser utilizados de forma conjunta.

Adição de Schema do Banco de Dados nas consultas:

Parâmetro: gdc.jdbc.alias

Exemplo: gdc.jdbc.alias = <SCHEMA> , onde <SCHEMA> indica o nome do schema utilizado no Banco de Dados.

Envio do arquivo compactado, contendo os arquivos CSVs para a nuvem do GoodData:

Parâmetro: gdc.upload

Exemplo: gdc.upload = <VALOR> , onde <VALOR> representa um valor booleano (TRUE ou FALSE). Sendo que TRUE envia arquivo para a nuvem e FALSE, não envia, mantendo-o apenas na pasta local.

Observação: O valor default deste parâmetro é TRUE. De preferência, use-o quando desejar não enviar o arquivo para a nuvem do GoodData.

Versão utilizada no projeto de ETL:

Parâmetro: gdc.version

Exemplo: gdc.version= <VALOR> , onde <VALOR> representa uma string que poderá conter o valor 11 ou 12, que é referente a versão do ETL utilizada.

Observação: O valor default deste parâmetro é 11. Isto significa que se não informar esse parâmetro no arquivo properties irá ser considerado a versão 11.

Execução de um App ou um conjunto de Apps específicos:

Parâmetro: gdc.etl.app.<Nome_do_App_Específico>=TRUE, onde <Nome_do_App_Específico> representa o nome do App específico a ser executado.

Exemplo: gdc.etl.app.COMERCIAL= TRUE

Lista de Apps disponíveis:

  • COMERCIAL
  • CONTROLADORIA
  • CRM
  • LOGISTICA
  • EDUCACIONAL
  • FINANCEIRO
  • SERVICOS
  • MATERIAIS
  • PRODUCAO
  • RH
  • VAREJO
  • SAUDE
  • VAREJO_SUPERMERCADOS
  • JURIDICO
  • HOTELARIA

Observação:

  • Para executar um conjunto de Apps, basta adicionar uma linha para cada App desejado.
  • Esse parâmetro está disponível a partir do Agent 2.0.0




  • No labels