JDBC drivers reference
This reference will be removed from the product. For JDBC driver questions, contact your database vendor or the Support Portal.
This reference can change. Report issues using the Support Portal.
JDBC driver download links
AWS Aurora
Amazon
Aurora is MySQL- and PostgreSQL-compatible. Use the MySQL or PostgreSQL driver.
Neoview1
HP
Contact your local HP representative for information on this product.
1 Deprecated beginning in version 11.0.
Driver details by database
Amazon Redshift
Recommended Native Driver
Amazon Web Services
Company URL:
JDBC URL Syntax by Type:
jdbc:redshift://<endpoint>:<port>/<database>?tcpKeepAlive=true
Default Port:
5439
JDBC Class:
com.amazon.redshift.jdbc4.Driver
JDBC JAR File Name:
RedshiftJDBC4.jar
Comments:
Download and use only the RedshiftJDBC4.jar.
AWS Athena
Recommended Native Driver
Amazon Web Services
Company URL:
JDBC URL Syntax by Type:
jdbc:athena://WorkGroup=<workgroup>;Region=<region>;Catalog=<catalog>;Database=<database>;OutputLocation=<outputlocation>;CredentialsProvider=<credentialsprovider>
Default Port:
N/A
JDBC Class:
com.amazon.athena.jdbc.AthenaDriver
JDBC JAR File Name:
athena-jdbc-3.2.0-with-dependencies.jar
Comments:
Download the athena-jdbc-3.2.0-with-dependencies.jar file from https://downloads.athena.us-east-1.amazonaws.com/drivers/JDBC/3.2.0/athena-jdbc-3.2.0-with-dependencies.jar.
See https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default regarding credentials.
Cache (Caché)
Note: Deprecated beginning in version 11.0.
Recommended Native Driver
InterSystems
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:Cache://<server>[:<port>]/<namespace>
Default Port:
1972
JDBC Class:
com.intersys.jdbc.CacheDriver
JDBC JAR File Name:
cachedb.jar
CUBRID
Recommended Native Driver
CUBRID
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:cubrid:<server>:<port>: <databaseName>:<username>: <password> :[?<URL attribute>=<value> [&<URL attribute>=<value>] … ]
Default Port:
33000
JDBC Class:
cubrid.jdbc.driver.CUBRIDDriver
JDBC JAR File Name:
N/A
Comments:
Open source database highly optimized for Web applications.
Daffodil DB
Recommended Native Driver
Daffodil Software
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:daffodilDB://<server>[:<port>]/<databaseName>
Embedded
jdbc:daffodilDB_embedded:<databaseName>
Default Port:
3456
N/A
JDBC Class:
in.co.daffodil.db.rmi.RmiDaffodilDBDriver
in.co.daffodil.db.jdbc.DaffodilDBDriver
JDBC JAR File Name:
DaffodilDB_client.jar
DaffodilDB_Embedded.jar,
DaffodilDB_Common.jar
Comments:
Open source database.
DB2 AS/400
Recommended Native Driver
IBM
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:as400://<server>naming=sql;errors=full
Default Port:
N/A
JDBC Class:
com.ibm.as400.access.AS400JDBCDriver
JDBC JAR File Name:
jt400.jar
DB2 Universal Database
Recommended Native Driver
IBM
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:db2://<server>[:<port>]/<databaseName>[:<URL attribute>=<value>;<URL attribute>=<value>]
Default Port:
50000
JDBC Class:
com.ibm.db2.jcc.DB2Driver
JDBC JAR File Name:
db2jcc4.jar
Firebird
Recommended Native Driver
Firebird Foundation
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:firebirdsql:<server>[/<port>]:/<database-file>
(JDBC Type 4, official format)
Server
jdbc:firebirdsql://<server>[:<port>]/<database-file>
(JDBC Type 4, compatibility format)
Server
jdbc:firebirdsql:native//<server>[/<port>]:/<database-file>
(JDBC Type 2, compatibility format)
Server
jdbc:firebirdsql:native://<server>[:<port>]/<database-file>
JDBC Type 2, compatibility format. Requires libraries)
Embedded
jdbc:firebirdsql:embedded:/<local-database-file>
(JDBC Type 2, compatibility format. Requires libraries)
Default Port:
3050
3050
3050
3050
N/A
JDBC Class:
org.firebirdsql.jdbc.FBDriver
JDBC JAR File Name:
jaybird-full-xxx.jar
Shipped with Pentaho products:
Pentaho Data Integration
FrontBase
Recommended Native Driver
FrontBase
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:FrontBase://<host>[:<port>]/<databaseName>
Default Port:
N/A
JDBC Class:
com.frontbase.jdbc.FBJDriver
JDBC JAR File Name:
frontbasejdbc.jar
Google BigQuery
Recommended Native Driver
Google BigQuery
For installation instructions, see Google BigQuery.
Company URL:
Default Port:
443
Greenplum
Recommended Native Driver
Greenplum
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:postgresql://<server>[:<port>]/<databaseName>
Default Port:
5342
JDBC Class:
org.postgresql.Driver
JDBC JAR File Name:
postgresql-8.x-xxx.jdbc4.jar
Comments:
Greenplum uses the Postgresql JDBC driver.
H2 Database
Recommended Native Driver
H2
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:h2:tcp://server[:port]/file-path
Embedded
jdbc:h2:file-name
Default Port:
9092
N/A
JDBC Class:
jdbc:h2:tcp://server[:port]/file-path
org.h2.Driver
JDBC JAR File Name:
h2-x.x.xxx.jar
Shipped with Pentaho products:
Pentaho Server
Pentaho Data Integration
Pentaho Metadata Editor
Pentaho Report Designer
Comments:
Open source Java SQL database.
Hive
Note: Deprecated beginning in version 11.0.
Recommended Native Driver
Apache
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:hive://<server>[:<port>]/default
Default Port:
10000
JDBC Class:
org.apache.hadoop.hive.jdbc. HiveDriver
JDBC JAR File Name:
pentaho-hadoop-shims-common-fragment-Vx-x.x.x.jar
Shipped with Pentaho products:
Pentaho Server
Pentaho Data Integration
Pentaho Metadata Editor
Pentaho Report Designer
Comments:
The pentaho-hadoop-shims-common-fragment-Vx-x.x.x.jar library includes a proxy driver. The actual Hive JDBC implementation for the specific distribution and version of Hadoop is located in the Pentaho driver for that distro. See the Install Pentaho Data Integration and Analytics document for more information.
Hive does not support the full SQL capabilities. It uses a subset and is more accurately referred to as HiveQL.
Hive2
Recommended Native Driver
Apache
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:hive2://<server>[:<port>]/<db>
Default Port:
10000
JDBC Class:
org.apache.hive.jdbc. HiveDriver
JDBC JAR File Name:
pentaho-hadoop-shims-common-fragment-Vx-x.x.x.jar
Shipped with Pentaho products:
Pentaho Server
Pentaho Data Integration
Pentaho Metadata Editor
Pentaho Report Designer
Comments:
The pentaho-hadoop-shims-common-fragment-Vx-x.x.x.jar library includes a proxy driver. The actual Hive JDBC implementation for the specific distribution and version of Hadoop is located in the Pentaho driver for that distro. See the Install Pentaho Data Integration and Analytics document for more information.
Hive2 does not support the full SQL capabilities. It uses a subset and is more accurately referred to as HiveQL.
HSQLDB
Recommended Native Driver
HyperSQL
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:hsqldb:hsql://<server>[:<port>]/<databaseName>
Embedded Memory
jdbc:hsqldb:mem:<databaseName>
Embedded File
jdbc:hsqldb:file:<database-file>
Default Port:
9001
N/A
N/A
JDBC Class:
org.hsqldb.jdbcDriver
JDBC JAR File Name:
hsqldb.jar
Shipped with Pentaho products:
Pentaho User Console
Pentaho Server
Pentaho Aggregation Designer
Pentaho Data Integration
Pentaho Metadata Editor
Pentaho Report Designer
Impala
Recommended Native Driver
Cloudera
Company URL:
Driver URL:
Built in
JDBC URL Syntax by Type:
jdbc:hive2://<server>[<port>]/;auth=noSasl
Default Port:
21050
JDBC Class:
org.apache.hadoop.hive.jdbc. HiveDriver
JDBC JAR File Name:
pentaho-hadoop-shims-common-fragment-Vx-x.x.x.jar
Shipped with Pentaho products:
Pentaho Server
Pentaho Data Integration
Pentaho Metadata Editor
Pentaho Report Designer
Comments:
The pentaho-hadoop-shims-common-fragment-Vx-x.x.x.jar library isncludesa proxy driver. The actual Hive JDBC implementation for the specific distribution and version of Hadoop is located in the Pentaho driver for that distro. See the Install Pentaho Data Integration and Analytics document for more information.
Hive does not support the full SQL capabilities. It uses a subset and is more accurately referred to as HiveQL.
Informix
Recommended Native Driver
IBM
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:informix-sqli://<server>[:<port>]/<databaseName>:informixserver= <dbservername>
Default Port:1533
JDBC Class:
com.informix.jdbc.IfxDriver
JDBC JAR File Name:
ifxjdbc.jar
Ingres
Note: Deprecated beginning in version 11.0.
Recommended Native Driver
Actian
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:ingres://<server>[:<port>]/<databaseName>
Default Port:
21071
JDBC Class:
com.ingres.jdbc.IngresDriver
JDBC JAR File Name:
iijdbc.jar
Comments:
Open source relational database management system.
InterBase
Note: Deprecated beginning in version 11.0.
Recommended Native Driver
Embarcadero
Company URL:
Driver URL:
N/A
JDBC URL Syntax by Type:
Server
jdbc:interbase://<server>/<full_db_path>
Default Port:
N/A
JDBC Class
interbase.interclient.Driver
JDBC JAR File Name:
interclient.jar
jTDS Free MS SQL Sybase
Note: Deprecated beginning in version 11.0.
Recommended Native Driver
jTDS
Company URL:
Driver URL:
N/A
JDBC URL Syntax by Type:
SQL Server
jdbc:jtds:<server_type>//<server>[:<port>][/<database>][;<property>=<value>[;...]]]
Sybase
jdbc:jtds:<server_type>://<server>[:<port>][/<database>]
Default Port:
1433
7100
JDBC Class:
interbase.interclient.Driver
JDBC JAR File Name:
jtds-x.x.x.jar
Shipped with Pentaho products:
Pentaho User Console
Pentaho Server
Pentaho Aggregation Designer
Pentaho Data Integration
Pentaho Metadata Editor
Pentaho Report Designer
MariaDB
Recommended Native Driver
JDBC URL Syntax by Type:
Server
jdbc:mariadb://<hostname>[,<failoverhost>][:<port>] /<dbname>[?<URL attribute>=<value>[&<URL attribute>=<value>] ... ]
Default Port:
3306
JDBC Class:
org.mariadb.jdbc.Driver
JDBC JAR File Name:
mariadb-java-client-2.1.2.jar
MaxDB
Recommended Native Driver
SAP
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:sapdb://<server>[:<port>]/<databaseName>
Default Port:
7210
JDBC Class:
com.sap.dbtech.jdbc.DriverSapDB
JDBC JAR File Name:
sapdbc.jar
Comments:
Database management system developed and supported by SAP AG.
Mckoi SQL Database
Recommended Native Driver
Mckoi
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:mckoi://<server>[:<port>][/<schema>]/
Default Port:
9157
JDBC Class:
com.mckoi.JDBCDriver
DBC JAR File Name:
mckoidb.jar
Comments:
Open source SQL database written in Java.
Mimer
Recommended Native Driver
Mimer Information Technology
Company URL:
Driver URL:
N/A
JDBC URL Syntax by Type:
Server
jdbc:mimer:<protocol>://<server>[:<port>]/<database>
Default Port:
1360
JDBC Class:
com.mimer.jdbc.Driver
JDBC JAR File Name:
mimer.jar
MySQL
Recommended Native Driver
Oracle
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:mysql://<hostname>[,<failoverhost>][:<port>] /<dbname>[?<URL attribute>=<value>[&<URL attribute>=<value>] ... ]
Default Port:
3306
JDBC Class:
com.mysql.jdbc.Driver (official class name)
org.gjt.mm.mysql.Driver (older class name)
JDBC JAR File Name:
mysql-connector-java-8.0.26 (official JAR filename)
mysql-connector-java-5.x.xx-bin.jar (older JAR filename)
Comments: Version 8.026 is certified, version 5.7 is supported.
Neoview
Note: Deprecated beginning in version 11.0.
Recommended Native Driver
HP
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:hpt4jdbc://<system>[:<port>]/[:][<URL attribute>=<value>[;<URL attribute>=<value> …]
Default Port:
18650
JDBC Class:
com.hp.t4jdbc.HPT4Driver
JDBC JAR File Name:
N/A
Netezza
Recommended Native Driver
IBM
Company URL:
Driver URL:
N/A
JDBC URL Syntax by Type:
jdbc:netezza://<server>[:<port>]/<database>
Default Port:
5480
JDBC Class:
org.netezza.Driver
JDBC JAR File Name:
N/A
OpenBase SQL
Recommended Native Driver
OpenBase International
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:openbase://<server>/<databaseName>
Default Port:
N/A
JDBC Class:
com.openbase.jdbc.ObDriver
JDBC JAR File Name:
OpenBaseJDBC.jar
Oracle
Recommended Native Driver
Oracle
Company URL:
JDBC URL Syntax by Type:
Thin Server
jdbc:oracle:thin:@<server>[:<port>]: <sid>
OCI Server
jdbc:oracle:oci:@<server>[:<port>]: <sid>
Default Port:
1521
JDBC Class:
oracle.jdbc.driver.OracleDriver
oracle.jdbc.OracleDriver
JDBC JAR File Name:
ojdbcx.jar
orai18n.jar
Comments:
The OCI server requires OCI libraries.
Pervasive
Recommended Native Driver
Pervasive
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:pervasive://<server>[:<port>]/<datasource>
Default Port:
1583
JDBC Class:
com.pervasive.jdbc.v2.Driver
JDBC JAR File Name:
N/A
Shipped with Pentaho products:
Pentaho Data Integration
Pentaho Report Designer
Comments:
The data source is the ODBC DSN.
PostgreSQL
Recommended Native Driver
PostgreSQL Global Development Group
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:postgresql://<server>[:<port>]/<databaseName>
Default Port:
5342
JDBC Class:
org.postgresql.Driver
JDBC JAR File Name:
postgresql-9.x-xxx.jdbc4.2.jar
Shipped with Pentaho products:
Pentaho Data Integration
Pentaho Report Designer
SAP ASE (formerly Sybase ASE)
Note: Deprecated beginning in version 11.0.
Recommended Native Driver
SAP
Company URL:
Driver URL:
The jConnect JDBC driver can only be installed from the SAP Adaptive Server Enterprise Installer. See the SAP website for more information.
JDBC URL Syntax by Type:
Server
jdbc:sybase:Tds:<server>[:<port>]/<databaseName>
Default Port:
5000
JDBC Class:
com.sybase.jdbc4.jdbc.SybDriver
JDBC JAR File Name:
N/A
Comments:
The open source jTDS driver works with SAP ASE (formerly Sybase) as well. Note that although you can use jTDS open source JDBC driver, we recommend that you use the SAP-supplied JDBC driver instead. Connections might not work reliably if you use the jTDS JDBC driver.
SAP DB
Recommended Native Driver
SAP DB
Company URL:
N/A
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:sapdb://<server>/<database_name>
Default Port:
N/A
JDBC Class:
com.sap.dbtech.jdbc.DriverSapDB
JDBC JAR File Name:
sapdbc-x.x.x.jar
Shipped with Pentaho products:
Pentaho Data Integration
Comments:
FREE Enterprise Open Source Database.
SAP HANA
Recommended Native Driver
SAP HANA
Company URL:
Driver URL:
For SAP customers, the driver is part of your client tools. Contact your SAP representative for more information.
JDBC URL Syntax by Type:
Server
jdbc:sap://<server>:<port>/?autocommit=false
Default Port:
30015
JDBC Class:
com.sap.db.jdbc.Driver
JDBC JAR File Name:
ngdbc.jar
Comments:
Note that the default port number is '30015' where '00' is the instance of the machine you are connecting to. For example, you can connect to the same machine using '30015', '30115', or '31015'.
SAP SQL Anywhere
Recommended Native Driver
SAP
Company URL:
Driver URL:
The jConnect JDBC driver can only be installed from the SAP Adaptive Server Enterprise Installer. Visit the SAP website for more information.
JDBC URL Syntax by Type:
Server
jdbc:sybase:Tds:<server>[:<port>]/<databaseName>
Default Port:
2638
JDBC Class:
com.sybase.jdbc4.jdbc.SybDriver
JDBC JAR File Name:
N/A
Comments:
This open source jTDS driver works with SAP ASE (formerly Sybase) as well. Note that although you can use jTDS open source JDBC driver, we recommend that you use the SAP-supplied JDBC driver instead. Connections might not work reliably if you use the jTDS JDBC driver.
SmallSQL
Recommended Native Driver
SmallSQL
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Embedded
jdbc:smallsql:databaseName[?URL attribute=value[URLattribute=value]…]
Default Port:
N/A
JDBC Class:
smallsql.database.SSDriver
JDBC JAR File Name:
smallsql.jar
Comments
Java desktop SQL database engine.
Snowflake
Recommended Native Driver
Snowflake
Company URL:
JDBC URL Syntax by Type:
Embedded
jdbc❄️//<account_name>.snowflakecomputing.com/?<connection_params>
Default Port:
443
JDBC Class:
net.snowflake.client.jdbc.SnowflakeDriver
JDBC JAR File Name:
snowflake-jdbc-3.6.28.jar
Comments: Version 3.13.10 is the minimum version supported. Version 3.13.30 is certified. If timeout errors occur, see Pentaho Data Integration to troubleshoot.
SQLite
Recommended Native Driver
Xerial
Company URL:
N/A
JDBC URL Syntax by Type:
Server
jdbc:sqlite:<filename.db>
Default Port:
N/A
JDBC Class:
org.sqlite.JDBC
JDBC JAR File Name:
sqlite-jdbc-x.x.x.jar
Shipped with Pentaho products:
Pentaho Data Integration
SQL Server
Recommended Native Driver
Microsoft
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:sqlserver://<server>[:<port>];DatabaseName= <databaseName>
Default Port:
1433
JDBC Class:
com.microsoft.sqlserver.jdbc. SQLServerDriver
JDBC JAR File Name:
sqljdbc4.jar
Comments:
The open source jtds driver also works with MSSQL.
Teradata
Please see the Teradata JDBC Driver Reference for information about required drivers.
Teradata
Company URL:
JDBC URL Syntax by Type:
Server
jdbc:teradata://<dbshost>[/<URL attribute>[;<URL attribute>]…]
Default Port:
N/A
JDBC Class:
com.teradata.jdbc.TeraDriver
JDBC JAR File Name:
terajdbc4.jar
tdgssconfig.jar
Vertica
Note: Deprecated beginning in version 11.0.
Recommended Native Driver
HP
Company URL:
Driver URL:
JDBC URL Syntax by Type:
Server
jdbc:vertica://<server>[:<port>]/<databaseName>
Default Port:
5433
JDBC Class:
com.vertica.Driver
JDBC JAR File Name:
N/A
Install drivers with the JDBC distribution tool
To connect to a database, including the Pentaho Repository database, download and install the JDBC driver:
In the appropriate Pentaho component directories.
In the web application server that hosts Pentaho Server.
Due to licensing restrictions, Pentaho cannot redistribute some third-party database drivers. You must download and install those drivers yourself.
Download the JDBC driver JAR from your database vendor or a third-party driver developer.
Copy the JDBC driver JAR to
pentaho/jdbc-distribution.Open a command prompt or shell, then run one of these commands:
Windows:
distribute-files.bat <jdbc-driver-jar>Linux:
./distribute-files.sh <jdbc-driver-jar>
If you ran this utility during installation, continue with your install steps.
If you ran this utility to connect to a new repository:
Restart Pentaho Server and the design tools.
Try the connection again.
If the connection still fails, verify driver locations below.
Pentaho Server
pentaho/server/pentaho-server/tomcat/lib
Pentaho Data Integration (Spoon)
pentaho/design-tools/data-integration/lib
Pentaho Report Designer (PRD)
pentaho/design-tools/report-designer/lib/jdbc
Pentaho Aggregation Designer (PAD)
pentaho/design-tools/aggregation-designer/drivers
Pentaho Schema Workbench (PSW)
pentaho/design-tools/schema-workbench/drivers
Pentaho Metadata Editor (PME)
pentaho/design-tools/metadata-editor/libext/JDBC
Last updated
Was this helpful?

