Bancos de Dados - Dashboards no Sankhya Om

Para a criação de dashboards você pode utilizar gerenciadores de bancos de dados externos ao sistema Sankhya Om, sendo eles o PostgreSQL, Firebird, DB2 e SQL Server. No entanto, é necessário que eles estejam em suas versões mais recentes.

Para conectar com os bancos de dados, o Sankhya Om necessita do driver de conexão JDBC, para isso antes de dar início, acesse a página oficial do fabricante responsável pelo banco de dados e na área de downloads baixe a versão mais recente do driver. Feito o download, copie o Jar do driver para o servidor, no caminho $jboss\server\default\lib, em seguida no caminho $jboss\server\default\deploy configure o "arquivo mge-ds.xml".

Arquivo mge-ds.xml                                  Datasourse Oracle

Datasource MySQL                                    Datasource PostgreSQL v9.4

Datasource Firebird v2.5                           Datasource IBM DB2 v10.5

Datasource SQL Server v10.0

Wildfly:

Wildfly - Configuração...                           Driver JDBC para conexão com o banco de dados

Criação do Datasource                             Oracle

MySQL                                                          PosgreSQL

MS SQL Server                                           IBM DB2

Firebird

 

Arquivo mge-ds.xml

<?xml version="1.0" encoding="UTF-8"?>

<datasources>

<local-tx-datasource>

<jndi-name>MGEDS</jndi-name>

<connection-url>jdbc:oracle:thin:@SERVIDOR:PORTA:ORCL</connection-url>

<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>

<user-name>Usuário</user-name>

<password>senha</password>

<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

<new-connection-sql>select 1 from dual</new-connection-sql>

<min-pool-size>5<min-pool-size>

<max-pool-size>5</max-pool-size>

<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>

<local-tx-datasource>

Configuração da string de conexão

A partir desta etapa, adicione ao Datasource a configuração para conexão com banco de dados; cada banco de dados possui seu próprio padrão de conexão; citaremos o que será necessário para realizar tal configuração, sendo que todas essas configurações são inseridas em um único arquivo mge-ds.xml criado pelo próprio Sankhya Om no diretório $jboss\server\default\deploy.

[voltar ao topo]

Datasourse Oracle - Dados para conexão - Oracle

<?xml version="1.0" encoding="UFT-8"?>

<datasources>

<local-tx-datasource>

<jndi-name>MGEDS</jndi-name>

<connection-url>jdbc:oracle:thin:@192.168.0.210:1521:ORCL</connection-url>

<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>

<user-name>Usuário</user-name>

<password>senha</password>

<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

<new-connection-sql>select 1 from dual</new-connection-sql>

<min-pool-size>5</min-pool-size>

<max-pool-size>5</max-pool-size>

<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>

</local-tx-datasource>

[voltar ao topo]

Datasource MySQL - Dados para conexão - MySQL

<?xml version="1.0" encoding="UFT-8"?>

<datasources>

<local-tx-datasource>

<jndi-name>homologaMYSQL</jndi-name>

<connection-url>jdbc:mysql://localhost:3306/NOME-BANCO</connection-url>

<driver-class>com.mysql.jdbc.Driver</driver-class>

<user-name>Usuário</user-name>

<password>senha</password>

<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

<new-connection-sql></new-connection-sql>

<min-pool-size>5</min-pool-size>

<max-pool-size>5</max-pool-size>

<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>

</local-tx-datasource>

[voltar ao topo]

Datasource PostgreSQL v9.4 - Dados para conexão - PostgreSQL

<?xml version="1.0" encoding="UFT-8"?>

<datasources>

<local-tx-datasource>

<jndi-name>homologaPostgresql</jndi-name>

<connection-url>jdbc:postgresql://localhost:5432/postgres</connection-url>

<driver-class>org.postgresql.Driver</driver-class>

<user-name>Usuário</user-name>

<password>senha</password>

<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

<new-connection-sql></new-connection-sql>

<min-pool-size>5</min-pool-size>

<max-pool-size>5</max-pool-size>

<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>

</local-tx-datasource>

[voltar ao topo]

Datasource Firebird v2.5 - Dados para conexão - Firebird v2.0/v2.5

<?xml version="1.0" encoding="UFT-8"?>

<datasources>

<local-tx-datasource>

<jndi-name>homologaFirebird</jndi-name>

<connection-url>jdbc:firebirdsql://localhost:3050/C:\ProgramFiles\Firebird\Firebird_2_5\examples\empbuid\EMPLOYEE.FDB</connection-url>

<driver-class>org.firebirdsql.jdbc.FBDriver</driver-class>

<user-name>Usuário</user-name>

<password>senha</password>

<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

<new-connection-sql></new-connection-sql>

<min-pool-size>5</min-pool-size>

<max-pool-size>5</max-pool-size>

<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>

</local-tx-datasource>

[voltar ao topo]

Datasource IBM DB2 v10.5 - Dados para conexão - IBM DB2 v10.5

<?xml version="1.0" encoding="UFT-8"?>

<datasources>

<local-tx-datasource>

<jndi-name>homologaDB2</jndi-name>

<connection-url>jdbc:db2://localhost:50000/SAMPLE</connection-url>

<driver-class>com.ibm.db2.jcc.DB2Driver</driver-class>

<user-name>Usuário</user-name>

<password>senha</password>

<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

<new-connection-sql></new-connection-sql>

<min-pool-size>5</min-pool-size>

<max-pool-size>5</max-pool-size>

<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>

</local-tx-datasource>

[voltar ao topo]

Datasource SQL Server v10.0 - Dados para conexão - SQL Server v10.0

<?xml version="1.0" encoding="UFT-8"?>

<datasources>

<local-tx-datasource>

<jndi-name>homologaSQLSERVER</jndi-name>

<connection-url>jdbc:sqlserver://localhost\SQLEXPRESS:1433</connection-url>

<driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>

<user-name>Usuário</user-name>

<password>senha</password>

<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>

<new-connection-sql></new-connection-sql>

<min-pool-size>5</min-pool-size>

<max-pool-size>5</max-pool-size>

<transaction-isolation>TRANSACTION_READ_COMMITTED</transaction-isolation>

</local-tx-datasource>

Finalizada a configuração, salve o arquivo.

No Sankhya Om, ao utilizar a tela Construtor de Componentes de BI para criação de um novo dashboard, na etapa destinada a "Editar/consultar a expressão", realize a escolha do banco de dados externo que foi anteriormente inserido no Datasource, através do ícone em destaque na imagem abaixo:

[voltar ao topo]

Wildfly - Configuração de Datasource

A configuração de um novo datasource para o Wildfly consiste na configuração do driver de conexão com o banco de dados (Driver JDBC para conexão com o banco de dados e Criação do Datasource, respectivamente) e na definição do datasource que na prática é um XML que define os dados de conexão com a base de dados.

O driver de conexão precisa ser definido uma única vez, portanto se já existir o driver no Wildfly, será necessário apenas seguir as instruções descritas no tópico Criação do Datasource.

Por padrão, o Wildfly que disponibilizamos já possui os drivers do Oracle, MS SQL e MySQL como módulos.

[voltar ao topo]

Driver JDBC para conexão com o banco de dados

Existem duas opções para configurar o driver de conexão com o banco de dados, são elas:

A. Utilizar um driver JDBC versão 4.0

Para isto, basta copiar o "arquivo.jar" referente ao seu driver JDBC 4.0 para a pasta:

WILDFLY_HOME/standalone/deployments

Observação: Se o jar for de uma versão anterior a 4.0, o Wildfly exibirá um erro de deploy do arquivo.jar.

B. Definir o driver JDBC como módulo do Wildfly

Para os passos a seguir, iremos considerar que o termo "meuBanco" é o nome identificador do seu banco de dados, deste modo:

1 – Crie a pasta WILDFLY_HOME/modules/custom/meuBanco/main

2 – Dentro da pasta "main" crie o arquivo module.xml que é o descritor do seu módulo.

<?xml version="1.0" encoding="UTF-8"?>

<module xmlns="urn:jboss:module:1.1" name="custom.meuBanco">

 <resources>

         <resource-root path="meuBanco.jar"/>

 </resources>

 <dependencies>

         <module name="javax.api"/>

         <module name="javax.transaction.api"/>

 </dependencies>

</module>

Observações:

• O nome para seu módulo deve ser sugestivo e não pode conter caracteres especiais ou espaços;
• O jar do driver JDBC deve ficar na pasta main, juntamente ao module.xml; certifique-se que o nome do jar é o mesmo definido dentro do XML.

[voltar ao topo]

Criação do Datasource

O Datasource é um XML que descreve as configurações e os dados de conexão com a base de dados. O arquivo deve ter o nome terminado em "-ds.xml" (teste-ds.xml, treina-ds.xml, integracao-ds.xml) e deve ser salvo em:

WILDFLY_HOME/standalone/deployments

A seguir estão disponibilizados os modelos conforme cada banco de dados.

[voltar ao topo]

Oracle

<?xml version="1.0" encoding="UTF-8"?>

<datasources xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

 xsi:noNamespaceSchemaLocation="http://www.ironjacamar.org/schema/

 datasources_1_0.xsd">

 <datasource jndi-name="java:/OracleDS" pool-name="OracleDS">

         <connection-url>jdbc:oracle:thin:@IP_OU_HOST:1521:SID_DA_BASE</connection-url>

         <connection-property name="v$session.program">IronJacamar</connection-property>

         <driver-class>oracle.jdbc.driver.OracleDriver</driver-class>

         <security>

                 <user-name>x</user-name>

                 <password>y</password>

         </security>

         <validation>

         <valid-connection-checker

                 class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleValidConnectionChecker">

         </valid-connection-checker>

                 <stale-connection-checker

                         class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleStaleConnectionChecker">

                 </stale-connection-checker>

                         <exception-sorter

                                 class-name="org.jboss.jca.adapters.jdbc.extensions.oracle.OracleExceptionSorter"></exception-sorter>

                 </validation>

 </datasource>

</datasources>

[voltar ao topo]

MySQL

<?xml version="1.0" encoding="UTF-8"?>

<datasources xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

 xsi:noNamespaceSchemaLocation="http://www.ironjacamar.org/schema/

 datasources_1_0.xsd">

 <datasource jndi-name="java:/MySqlDS" pool-name="MySqlDS">

         <connection-url>jdbc:mysql://mysql-hostname:3306/nome_bd</connection-url>

         <driver-class>com.mysql.jdbc.Driver</driver-class>

         <security>

                 <user-name>x</user-name>

                 <password>y</password>

         </sec<datasource jndi-name="java:jboss/datasources/SantaRosa" pool-name="SantaRosaDS" enabled="true" jta="true" use-java-context="true" use-ccm="true">

                  <connection-url>jdbc:firebirdsql:localhost/3050:C:/SantaRosa/sicoi.gdb?charSet=ISO-8859-1</connection-url>

                  <driver>firebirdsql</driver>

                  <security>

                    <user-name>SYSDBA</user-name>

                    <password>masterkey</password>

                  </security>

                  <statement>

                      <prepared-statement-cache-size>100</prepared-statement-cache-size>

                      <share-prepared-statements/>

                  </statement>

              </datasource>

<driver name="firebirdsql" module="org.firebirdsql">

                    <xa-datasource-class>org.firebirdsql.pool.FBConnectionPoolDataSource</xa-datasource-class>

                  </driver>urity>

         <validation>

                 <valid-connection-checker

                         class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLValidConnectionChecker">

                 </valid-connection-checker>

                 <exception-sorter

                         class-name="org.jboss.jca.adapters.jdbc.extensions.mysql.MySQLExceptionSorter">

                 </exception-sorter>

         </validation>

 </datasource>

</datasources>

[voltar ao topo]

PosgreSQL

<?xml version="1.0" encoding="UTF-8"?>

<datasources xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

 xsi:noNamespaceSchemaLocation="http://www.ironjacamar.org/schema/

 datasources_1_0.xsd">

 <datasource jndi-name="java:/PostgresDS" pool-name="PostgresDS">

         <connection-url>jdbc:postgresql://[servername]:[port]/[database name]</connection-url>

         <driver-class>org.postgresql.Driver</driver-class>

         <security>

                 <user-name>x</user-name>

                 <password>y</password>

         </security>

         <validation>

                 <valid-connection-checker

                         class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLValidConnectionChecker">

                 </valid-connection-checker>

                         <exception-sorter

                                 class-name="org.jboss.jca.adapters.jdbc.extensions.postgres.PostgreSQLExceptionSorter">

                         </exception-sorter>

         </validation>

 </datasource>

</datasources>

[voltar ao topo]

MS SQL Server

<?xml version="1.0" encoding="UTF-8"?>

<datasources xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

 xsi:noNamespaceSchemaLocation="http://www.ironjacamar.orgd/schema/atasources_1_0.xsd">

 <datasource jndi-name="java:/MSSQLDS" pool-name="MSSQLDS">

         <connection-url>

                 jdbc:microsoft:sqlserver://localhost:1433;DatabaseName=MyDatabase

         </connection-url>

         <driver-class>com.microsoft.sqlserver.jdbc.SQLServerDriver</driver-class>

         <security>

                 <user-name>x</user-name>

                 <password>y</password>

         </security>

         <validation>

                 <valid-connection-checker

                                 class-name="org.jboss.jca.adapters.jdbc.extensions.mssql.MSSQLValidConnectionChecker">

                 </valid-connection-checker>

         </validation>

 </datasource>

</datasources>

[voltar ao topo]

IBM DB2

<?xml version="1.0" encoding="UTF-8"?>

<datasources

 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

 xsi:noNamespaceSchemaLocation="http://www.ironjacamar.org/schema/datasources_1_0.xsd"

 >

 <datasource jndi-name="java:/DB2DS" pool-name="DB2DS">

         <connection-url>jdbc:db2:SUA_BASE_DE_DADOS</connection-url>

         <driver-class>COM.ibm.db2.jdbc.app.DB2Driver</driver-class>

         <security>

                 <user-name>USUARIO</user-name>

                 <password>SENHA</password>

         </security>

         <validation>

                 <valid-connection-checker

                         class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2ValidConnectionChecker">

                 </valid-connection-checker>

                 <stale-connection-checker

                         class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2StaleConnectionChecker">

                 </stale-class-connection-checker>

                 <exception-sorter

                         class-name="org.jboss.jca.adapters.jdbc.extensions.db2.DB2ExceptionSorter">

                 </exception-sorter>

         </validation>

 </datasource>

</datasources>

[voltar ao topo]

Firebird

<?xml version="1.0" encoding="UTF-8"?>

<datasources

 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

 xsi:noNamespaceSchemaLocation="http://www.ironjacamar.org/schema/datasources_1_0.xsd"

 >

<datasource jta="false" jndi-name="java:jboss/NOME_DATASROUCE" pool-name="NOME_DATASROUCE" enabled="false" use-ccm="false">

  <connection-url>jdbc:FirebirdSQL:name.serverfirebird.com.br:/path/to/database/data.fdb</connection-url>  

    <driver-class>org.firebirdsql.jdbc.FBDriver</driver-class>  

    <connection-property name="charSet">ISO8859-1</connection-property>

    <connection-property name="roleName">ROLE_APP</connection-property>

    <driver>jaybird-2.2.4.jar</driver>

    <security>  

            <user-name>userdb</user-name>  

            <password>passwddb</password>

    </security>  

    <validation>  

            <validate-on-match>false</validate-on-match>

            <background-validation>false</background-validation>  

    </validation>  

    <timeout>  

            <idle-timeout-minutes>1</idle-timeout-minutes>

    </timeout>

    <statement>  

            <share-prepared-statements>false</share-prepared-statements>

    </statement>  

</datasource>  

</datasources>

[voltar ao topo]