Linha Microsiga Protheus

Árvore de páginas

Produto:

Microsiga Protheus® - TOTVS Fast 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 Fast 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://secure-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 Fast Analytics:

Parâmetro: gdc.etl.process_url

Exemplo: gdc.etl.process_url = https://secure.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 Fast Analytics:

Parâmetro: gdc.etl.graph

Exemplo: gdc.etl.graph = Totvs Fast Analytics/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: 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 a solicitação deste.

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 maiores informações e solicitação do driver do banco de dados, consulte o fabricante do software.


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

Parâmentro: jdbc.url

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

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:

Alterar o schema do Banco de Dados Oracle:

Parâmentro: jdbc.ORACLE_CURRENT_SCHEMA

Exemplo: jdbc.ORACLE_CURRENT_SCHEMA=SCOTT

Observação: Parâmetro necessário quando o usuário corrente não tem acesso as tabelas de outro schema.

Parâmetros SQL:

É possível adicionar parâmetros SQL nas queries, porém o TOTVS Fast Analytics® é case sensitive, dessa forma o nome do parâmetro ao ser configurado no arquivo my.properties deverá seguir o mesmo padrão existente na query. No arquivo my.properties estes parâmetros podem receber um conteúdo fixo ou funções do banco de dados.

Exemplo: 

Query com parâmetros de data inicial e final

Configuração dos parâmetros no arquivo my.properties