Wiki Markup
{scrollbar}

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

Panel
Oracle Informix Microsoft SQL Server JTurbo Inetdae MySQL MariaDB Essentia Postgres DB2 AS400

Panel
DB2 UDB Relativity Firebird SQLITE Pervasive FoxPro (FoxPro, Visual FoxPro, FoxBase, Clipper) Ingres DBF y Excel Drivers JDBC más utilizados#Access SAP HANA

Anchor

	oracle
	oracle

ORACLE

Clase:	oracle.jdbc.driver.OracleDriver
URL:	jdbc:oracle:thin:@{hostIP \| hostName}:port:SID

Default port: 1521

Ejemplo en O3Designer:

Warning

title	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

title	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

title	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

title	Oracle OCI

Configurar Driver OCI de Oracle

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) ) 
     )

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)))

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

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

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:

sqlserver.png [Conexion con driver SQLServer distribuido con O3]

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

title	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.

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

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

title	Driver

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

Note

title	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

server	Ideasoft Issue Tracking
columns	key,summary,type,created,updated,due,assignee,reporter,priority,status,resolution
serverId	bb6ce804-11cf-373f-895b-0b28b0ef6fc8
key	HD-8185

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

title	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
Protocolo:	postgresql
Parámetros:	//{hostIP \| hostName}:port[/database]

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"

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

Documentación (en sap.help.com - Connect to SAP HANA via JDBC)
En primer lugar se debe disponer del driver jdbc ngdbc.jar ubicado en la instalación de O3 en <o3bi>\classes\jdbc
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)

Ejemplo de string de conexión, donde se : //<nombre o IP del servidor SAP>:30015/nombre_base_de_datos Por más detalle, ver cómo conectar O3 con SAP HANA.

Versions Compared

Old Version 22

New Version 23

Key

ORACLE

Configurar Driver OCI de Oracle

INFORMIX