These instructions will help you connect Bamboo to an Oracle 10g or 11g database. Oracle 9i is no longer a supported database for use with Bamboo and the 11.2.x drivers from Oracle do not support 9i.
Bamboo provides two ways to connect to an Oracle database — via JDBC or via a datasource. JDBC is generally simpler and is the recommended method.
![]() | Important For JDBC or JNDI connections, please ensure that the user connecting to the database will have total permissions over it. This includes DBMS_LOB package and other resources available. |
Please note, the JDBC driver for Oracle 10g/11g (Oracle 11.2.0.1.0) is bundled with Bamboo. You do not have to download and install the driver.
Configuring Oracle
- Ensure that you have a database instance available for Bamboo (either create a new one or use an existing one).
Within that database instance, create a user which Bamboo will connect as (e.g.
bamboo-user
).Remember this database user name, as it will be used to configure Bamboo's connection to this database.
When you create a user in Oracle, Oracle will create a 'schema' automatically.
create user bamboo-user identified by password;
Ensure that the user has the following permissions:
grant connect, resource, create table to bamboo-user;
Connecting via JBDC
To connect Bamboo to a Oracle database, via JDBC,
- Run the Setup Wizard and choose the 'Custom Installation' method.
- At the 'Choose a Database Configuration' step, choose 'External Database' and select 'Oracle 10g/11g' from the list.
- The 'Select Database Connection' screen will appear. Select 'Direct JDBC connection'.
- The 'Setup JDBC Connection' screen will appear as shown in the screenshot below.
- 'Driver Class Name' — Type the following:
oracle.jdbc.driver.OracleDriver
- 'Database URL' — Type the URL where Bamboo will access your database, e.g.
jdbc:oracle:thin:@localhost:1521:SID
. For syntax, please see the Oracle documentation. - 'Username' — Type the username that Bamboo will use to access your database.
- 'Password' — Type the password that Bamboo will use to access your database.
- 'Driver Class Name' — Type the following:
- Select the 'Overwrite existing data' checkbox if you wish Bamboo to overwrite any tables that already exist in the database.
- Click 'Continue' to finish specifying your connection settings.
Screenshot 1: 'Setup JDBC Connection (Oracle)'
Connecting via a datasource
To connect Bamboo to a Oracle database, via a datasource,
- Configure a datasource in your application server (consult your application server documentation for details). For the syntax of the JDBC URL to use, please see the Oracle documentation.
- Run the Setup Wizard and choose the 'Custom Installation' method.
- At the 'Choose a Database Configuration' step, choose 'External Database' and select 'Oracle 10g/11g' from the list.
- The 'Select Database Connection' screen will appear. Select 'Connect via a datasource (configured in the application server)'.
- The 'Setup Datasource Connection' screen will appear as shown in the screenshot below. In the 'JNDI name' field, type the JNDI name of your datasource, as configured in your application server.
If
java:comp/env/jdbc/DataSourceName
doesn't work, tryjdbc/DataSourceName
(and vice versa). - Select the 'Overwrite existing data' checkbox if you wish Bamboo to overwrite any tables that already exist in the database.
- Click 'Continue' to finish specifying your connection settings.
Screenshot 2: 'Setup Datasource Connection'
Attachments:


