Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

La que sigue es una lista de drivers JDBC usados con mayor frecuencia. Para cada uno se especifica el nombre de la clase y la sintaxis para su URL jdbc.

Importante: Recordar cómo se divide la URL jdbc para colocarla en la definición de la conexión en O3Designer.

Dada la url  jdbc:<sub-protocol>:<driver & database specific parameters>,  luego en el panel de conexión se coloca lo siguiente:

Protocolo: <sub-protocol>

Parámetros: <driver & database specific parameters>

Por ejemplo, la url  de MySql  jdbc:mysql://{hostIP | hostName}:port/database se dividiría así:

Protocolo: mysql

Parámetros: //{hostIP | hostName}:port/database


Anchor
oracle
oracle

ORACLE

Clase:

oracle.jdbc.driver.OracleDriver

URL:

jdbc:oracle:thin:@{hostIP | hostName}:port:SID

Default port: 1521

Ejemplo en O3Designer:

Warning

Cambio en driver de Oracle

A partir de la versión del driver para Oracle 11, no existe más la clase oracle.jdbc.driver.OracleDriver.
Se debe usar la clase oracle.jdbc.OracleDriver en su lugar.
Los drivers para la version 10g ya traen las 2 versiones de la clase, asi que se debe hacer el cambio desde ahora.

Note

Problemas con el idioma del puesto cliente al conectarse a Oracle

Hemos experimentado inconvenientes al chequear la conexión a Oracle desde O3Studio, utilizando el driver ojdbc14.jar. El problema se visualiza a través del siguiente error: "ORA-00604 "error ocurred at recursive SQL leel"... ORA-12705 "cannot access NLS data files or invalid environment".

Otra situación donde es necesario aplicar la misma solución se detectó en consultas SQL utilizando driver ojdbc6 sobre Oracle 11g, en las cuales no se resuelven las conversiones numéricas y se visualiza el siguiente error: "ORA-01722: número no válido".

Solución: Modificar el Regional Setting en el puesto cliente, seteando Estándares y Formatos: Inglés (Estados Unidos) y Ubicación: Estados Unidos. Por ejemplo, indicando -Duser.language=en -Duser.region=US en las componentes de O3Studio.

Note

Problemas con la zona horaria del puesto cliente al conectarse a Oracle

Hemos experimentado inconvenientes al chequear la conexión o verificar un modelo desde O3Studio, utilizando diferentes driver. El problema se visualiza a través del siguiente error: "ORA-01882: timezone region not found".
Solución: Sí los componentes O3Designer, y O3Builder se ejecutan utilizando los archivos .exe, se debe agregar la siguiente property en los archivos Designer.lax, Builder.lax (versiones <= 5.3), o Designer.vmoptions, Builder.vmoptions (versiones >= 5.4):
 
-Duser.timezone="GMT-3"
 
Sí se ejecutan utilizando los archivos .sh, se deben editar (designer.sh, builder.sh) y agregar la siguiente property:
PROPERTIES="$PROPERTIES -Duser.timezone=GMT-3"
 
Sí se ejecutan utilizando los archivos .bat, se deben editar (Designer.bat, Builder.bat) y agregar la siguiente property:
set PROPERTIES=%PROPERTIES% -Duser.timezone=GMT-3

Note

Oracle OCI

Configurar Driver OCI de Oracle

(tick) Para reemplazar el driver JDBC por el driver OCI de Oracle se debe realizar lo siguiente:

 

Agregar el directorio a una variable de entorno de nombre TNS_ADMIN 

el contenido del archivo debe ser

1

2

3

4

5

6

7

ALIAS_NAME =

   (DESCRIPTION =

          (ADDRESS_LIST =

                   (ADDRESS = (PROTOCOL = TCP) (HOST = @hostname) (PORT = @port))

          )

          (CONNECT_DATA = (SERVICE_NAME = @service_name) )

     )

Note

Donde: 

ALIAS_NAME es un nombre que se utiliza en el string de conexión
@hostname es la dirección de la base de datos
@port es el puerto donde escucha la base de datos (por defecto 1521)
@service_name es el nombre del servicio de la base de datos 

Para configurar el pool de conexiones en el servidor de aplicaciones OC4J utilizar la cadena de conexión

jdbc:oracle:oci:@ALIAS_NAME

o también es posible con

jdbc:oracle:oci:@(DESCRIPTION= 
  (ADDRESS=(PROTOCOL=TCP)(HOST=@hostname) 
    (PORT= @port)) 
    (CONNECT_DATA=(SERVICE_NAME=@service_name)))

 


(tick) A configurar en O3:

Para generar los cubos es necesario crear una carpeta en: %IDEASOFT_HOME%\classes\jdbc\lib, en esta carpeta agregar las dll's de Oracle indicadas según la versión el motor en uso y modificar el archivo settings.bat(windows), la linea: 

set PROPERTIES=%PROPERTIES% -Djava.library.path=%IDEASOFT_HOME%\classes\bin;%IDEASOFT_HOME%\classes\bin64 
por 
set PROPERTIES=%PROPERTIES% -Djava.library.path=%IDEASOFT_HOME%\classes\bin;%IDEASOFT_HOME%\classes\bin64;%IDEASOFT_HOME%\classes\jdbc\lib 


(tick) Bajar las dll OCI necesarias del siguiente link(windows), sino bajar los drivers correspondientes desde el siguiente enlace: http://www.oracle.com/technetwork/database/features/instant-client/index-097480.html

(tick) Copiar los driver bajados en el paso anterior en la ruta correspondiente, creada para tal fin.

Nota: Esta es toda la información que se tiene para realizar la conexión con OCI, no hay antecedentes de este tipo de configuraciones en clientes hasta el momento.


Anchor
informix
informix

INFORMIX

Clase:

com.informix.jdbc.IfxDriver

URL:

jdbc:informix-sqli://{hostIP | hostName}:port[/database]:INFORMIXSERVER=serverName;[user=user;password=password][;name=value[;name=value]...]

Default port: 1533

Ejemplo en O3Designer:

Driver:

com.informix.jdbc.IfxDriver

Protocolo:

informix-sqli

Parámetros:

//{hostIP | hostName}:port[/database]:INFORMIXSERVER=serverName;[user=user;password=password][;name=value[;name=value]...]


Anchor
sqlserver
sqlserver

Microsoft SQL-SERVER

(Si la conexion es con Certificado leer el siguiente wiki)

SQL-SERVER 2000 y 2005

La informacion siguiente es para el driver distribuido con O3, implementado por el archivo sqljdbc-1.0.809.102.jar, ubicado en el directorio <O3>\classes\jdbc.

Clase:

com.microsoft.sqlserver.jdbc.SQLServerDriver

URL:

jdbc:sqlserver://{hostIP | hostName}[;DatabaseName =value[;property=value]...]

Default port: 1433

Ejemplo en O3Designer:

La informacion siguiente es para el driver distribuido por Microsoft, que consiste en los archivos msbase.jar, mssqlserver.jar y msutil.jar (deben estar instalados en <O3>\classes\jdbc).

Clase:

com.microsoft.jdbc.sqlserver.SQLServerDriver

URL:

jdbc:microsoft:sqlserver://{hostIP | hostName}[;DatabaseName =value[;property=value]...

Default port: 1433

Ejemplo en O3Designer:

Driver:

com.microsoft.sqlserver.jdbc.SQLServerDriver

Protocolo:

microsoft:sqlserver

Parámetros:

//{hostIP | hostName}[;DatabaseName =value[;property=value]...

Clase:

connect.microsoft.MicrosoftDriver

URL:

jdbc:ff-microsoft://{hostIP | hostName}:port/database

Ejemplo en O3Designer:

Driver:

connect.microsoft.MicrosoftDriver

Protocolo:

ff-microsoft

Parámetros:

//{hostIP | hostName}:port/database

Info

Conexión a instancia

En caso de tener que definir conexión a una instancia particular del servidor de base de datos, la sintaxis de parámetros es la siguiente:

//{hostIP | hostName}\instanceName[;DatabaseName =value[;property=value]...

Notar que se omite el puerto.

(info) debe estar corriendo el SQL Server Browser (es el servicio que acepta peticiones desde afuera de la instancia)

(warning) Si el string de conexión se debe definir en un archivo de properties, la \ antes del instanceName debe ser doble: \\instanceName

Note

Por defecto SQL Server 2005 Express no tiene conectividad por TCP/IP disponible luego de la instalación. Es necesario ir al SQL Server Configuration Manager. Bajo SQL Server 2005 Network Configuration, click en Protocols for SQLEXPRESS, click on TCP/IP para dejarlo disponible.
Para configurar un puerto en particular y deshabilitar la asignación dinámica, se debe ir al nodo TCP/IP, botón derecho sobre "IPAll" y abrir sus Propiedades. Se deja en blanco el valor de "TCP Dynamic Ports" y se adjudica el "TCP Port" al puerto que se crea conveniente. Lo más usual es utilizar el puerto 1433 ó el puerto 1593.

Reiniciar el servicio de BD para que los cambios tomen efecto


Anchor
jturbo
jturbo

JTurbo

Clase:

com.ashna.jturbo.driver.Driver

URL:

jdbc:JTurbo://{hostIP | hostName}:port/database

Ejemplo en O3Designer:

Driver:

com.ashna.jturbo.driver.Driver

Protocolo:

JTurbo

Parámetros:

//{hostIP | hostName}:port/database


Anchor
inetdae
inetdae

Inetdae

Clase:

com.inet.tds.TdsDriver

URL:

jdbc:inetdae://{hostIP | hostName}:port?database=database

Ejemplo en O3Designer:

Driver:

com.inet.tds.TdsDriver

Protocolo:

inetdae

Parámetros:

//{hostIP | hostName}:port?database=database


Anchor
mysql
mysql

MySQL

Clase:

com.mysql.jdbc.Driver

URL:

jdbc:mysql://{hostIP | hostName}:port/database

Default port: 3306

Note

Driver

El licenciamiento del driver no permite distribución con productos comerciales por lo que debe descargarse su versión correspondiente.

utiliza Java 8 que no es soportado por esta versión de Jboss. Ver HD-8185

Note

MySql 8

Para versiones de MySql 8 es importante contar con la versión Connector/J 5.1.46 . Esto se debe a que esta versión de MySql utiliza Java 8 que no es soportado por esta versión de Jboss. Ver

Jira Legacy
serverIdeasoft Issue Tracking
columnskey,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverIdbb6ce804-11cf-373f-895b-0b28b0ef6fc8
key

Ejemplo en O3Designer:

Tips para MySQL 
Autollenado de campos

En el caso de utilizar versiones de MySQL donde el autollenado de los campos no resuelve los alias definidos en las consultas, se sugiere agregar el parámetro useOldAliasMetadataBehavior con valor verdadero como parte de la URL de conexión.
Ejemplo:   hostName:3306/DataBase?useOldAliasMetadataBehavior=true

Configuración de la conexión por consumo de memoria en el builder.

Ver las recomendaciones al momento de definir la conexión en el siguiente How To


Anchor
mariadb
mariadb

MariaDB

Clase:

org.mariadb.jdbc.Driver

URL:

jdbc:mariadb://{hostIP | hostName}:port/database

Default port: 3306

Ejemplo en O3Designer:

Note

Driver

El licenciamiento del driver no permite distribución con productos comerciales por lo que debe descargarse su versión correspondiente.

https://downloads.mariadb.org/client-java/

Anchor
essentia
essentia

Essentia

Clase:

intersoft.jdbc.EssentiaDriver

URL:

jdbc:essentia://{hostIP | hostName}:port/schema

Default port: 1700

Ejemplo en O3Designer:

Driver:

intersoft.jdbc.EssentiaDriver

Protocolo:

essentia

Parámetros:

//{hostIP | hostName}:port/schema


Anchor
postgres
postgres

POSTGRES

Clase:

com.postgresql.Driver
org.postgresql.Driver
org.postgresql.xa.PGXADataSource

URL:

jdbc:postgresql://{hostIP | hostName}:port[/database]

Default port: 5432

Ejemplo en O3Designer:

Driver:

com.postgresql.Driver u org.postgresql.Driver

Protocolo:

postgresql

Parámetros:

//{hostIP | hostName}:port[/database]

Para bajar el driver adecuado compatible  JDK/JVM  consultar la siguiente documentación: https://jdbc.postgresql.org/download.html

Caso especial: PIQL (driver postgres-ideafix), el driver es el de postgres con la única diferencia que se publica puerto por defecto en el puerto 7120

Note

Para el uso de un gran volumen de registros se recomienda pasarle dos parámetros al driver para una mayor eficiencia y performance (consulta se consuma en un cursor): Autocommit OFF y un FetchSize mayor a 0 en las opciones Avanzadas de la definción de la conexión


Anchor
db2as400
db2as400

DB2 as400

Clase:

com.ibm.as400.access.AS400JDBCDriver

URL:

jdbc:as400://{hostIP | hostName}/libreria

Ejemplo en O3Designer:

Driver:

com.ibm.as400.access.AS400JDBCDriver

Protocolo:

as400

Parámetros:

//{hostIP | hostName}/libreria


Anchor
db2udb
db2udb

DB2 UDB

Clase:

com.ibm.db2.jcc.DB2Driver

URL:

jdbc:db2://{hostIP|hostName}:port/database

Default port: 50000

Ejemplo en O3Designer:

Driver:

com.ibm.db2.jcc.DB2Driver

Protocolo:

db2

Parámetros:

//{hostIP|hostName}:port/database


Anchor
relativity
relativity

RELATIVITY

Clase:

relativity.jdbc.Driver

URL:

jdbc:relativity://{hostIP | hostName}:1583/ODBC

Ejemplo en O3Designer:

NOTA IMPORTANTE:

Agregarle a builder.bat y designer.bat la siguiente linea:

set PROPERTIES=%PROPERTIES% -Do3.sql.useSystemProp=false

Si se va a correr los que estan en <o3>/bin ... agregarle la siguiente linea tanto a Designer.lax como a Builder.lax:

o3.sql.useSystemProp=false

En GNU/Linux, UNIX,  AIX (entre otros) a los builder.sh, designer.sh :

PROPERTIES="$PROPERTIES -Do3.sql.useSystemProp=false"

 (warning) Service Pack para Relativity 11.00


Anchor
firebird
firebird

FIREBIRD

Clase:

org.firebirdsql.jdbc.FBDriver

URL:

jdbc:firebirdsql://{hostIP|hostName}:port/path_to_database

Default port: 3050

Ejemplo en O3Designer:

Driver:

org.firebirdsql.jdbc.FBDriver

Protocolo:

firebirdsql

Parámetros:

//{hostIP|hostName}:port/path_to_database


Anchor
sqlite
sqlite

SQLITE

Clase:

org.sqlite.JDBC

URL:

jdbc:sqlite:path_to_database

Ejemplo en O3Designer:

Driver:

org.sqlite.JDBC

Protocolo:

sqlite

Parámetros:

C:\SQLite\SampleDB.db


Anchor
pervasive
pervasive

PERVASIVE

Clase:

com.pervasive.jdbc.v2.Driver

URL:

jdbc:pervasive://{HOST}:{PORT}/{DB}

Ejemplo en O3Designer:

Driver:

com.pervasive.jdbc.v2.Driver

Protocolo:

pervasive

Parámetros:

//192.168.0.1:1583/bddatos


Anchor
foxpro
foxpro

FoxPro (FoxPro, Visual FoxPro, FoxBase, Clipper)

Clase:

jstels.jdbc.dbf.DBFDriver2

URL:

jdbc:jstels:dbf:c:/mydir/dbffiles

Ejemplo en O3Designer:

Driver:

jstels.jdbc.dbf.DBFDriver2

Protocolo:

jstels

Parámetros:

dbf:c:/mydir/dbffiles

Driver Modes

There are two main modes StelsEngine can run in: the mode with data caching and the mode with data swapping. Running in the first mode (default mode), the driver stores all tables in the RAM making it possible to achieve maximum performance. Keep in mind that Java Virtual Machine must have enough free memory allotted for storing large tables (use -Xms and -Xmx JVM options).

The second mode can be used to process large tables which cannot be fully stored in the RAM. To use this mode, set the driver property caching to false. There are also some properties for configuring this mode:

tempPath - directory where temporary files will be created (by default it is a OS temporary directory, specified by JVM environment variable "java.io.tmpdir").

maxRecordsInMemoryPerTable is used to define how many records should be saved in the RAM for each table (by default - 5000 records).

maxSwapStringSize - default size for string columns in swap files (by default - 50 characters).

Ejemplo de uso de parámetros en el string de conexión: dbf:c:/mydir/dbffiles?caching=false


Anchor
ingres
ingres

Ingres

Clase:

com.ingres.jdbc.IngresDriver

URL:

jdbc:ingres://{hostIP|hostName}:port/database

Default port: II7

Ejemplo en O3Designer:

Driver:

com.ingres.jdbc.IngresDriver

Protocolo:

ingres

Parámetros:

//localhost:II7/demodb;auto=multi

Asegurarse que la base de datos tenga el Data Access Server (DAS) habilitado.


Anchor
Access
Access

Access

Crear ODBC del sistema que apunte a el archivo de access

Ejemplo en O3Designer:

Driver:

sun.jdbc.odbc.JdbcOdbcDriver

Protocolo:

odbc

Parámetros:

"Nombre ODBC"


Anchor
dbfexcel
dbfexcel

Accediendo archivos DBF y EXCEL

Ver notas en sección HowTo Accediendo archivos DBF y Excel

Connector/J 5.1.46


Anchor
SAPHANA
SAPHANA

SAP HANA

La clase y sintaxis del string de conexión son los siguientes:

Clase

com.sap.db.jdbc.Driver

URL

jdbc:sap://<server host>:<port>[/?<options>]

Se deben especificar de esta manera en la conexión en el modelo multidimensional (O3 Designer)

Image RemovedImage Added

(info) Por más detalle, ver cómo conectar O3 con SAP HANA.