Skip to content
Snippets Groups Projects
Unverified Commit fcca95a0 authored by Cam Saül's avatar Cam Saül
Browse files

Oracle driver documentation :page_with_curl: [ci skip]

parent db05cdce
No related branches found
No related tags found
No related merge requests found
......@@ -20,7 +20,7 @@ Now you’ll see a list of your databases. To connect another database to Metaba
* SQL Server
* Driud
* Crate
* Oracle
* [Oracle](databases/oracle.md)
To add a database, you'll need its connection information.
......
## Working with Oracle in Metabase
Starting in v0.20.0, Metabase provides a driver for connecting to Oracle databases. Under the hood, Metabase uses to Oracle's JDBC driver; due to licensing restrictions, we can't
include ship it as part of Metabase. Luckily, downloading it yourself and making it available to Metabase is straightforward and only takes a few minutes.
### Downloading the Oracle JDBC Driver JAR
You can download the JDBC driver from [Oracle's JDBC driver downloads page](http://www.oracle.com/technetwork/database/features/jdbc/default-2280470.html).
Head to this page, accept the license agreement, and download `ojdbc7.jar`:
![Oracle JDBC Download](../images/oracle_jdbc_download.png)
Before downloading this JAR you may need to sign up for a free account with Oracle.
### Adding the Oracle JDBC Driver JAR to the Metabase Plugins Directory
Metabase will automatically make the Oracle driver available if it finds the Oracle JDBC driver JAR in the Metabase plugins directory when it starts up.
All you need to do is create the directory and move the JAR you just downloaded into it.
By default, the plugins directory is called `plugins`, and lives in the same directory as the Metabase JAR.
For example, if you're running Metabase from a directory called `/app/`, you should move the Oracle JDBC driver JAR to `/app/plugins/`:
```bash
# example directory structure for running Metabase with Oracle support
/app/metabase.jar
/app/plugins/ojdbc7.jar
```
If you're running Metabase from the Mac App, the plugins directory defaults to `~/Library/Application Support/Metabase/Plugins/`:
```bash
# example directory structure for running Metabase Mac App with Oracle support
/Users/camsaul/Library/Application Support/Metabase/Plugins/ojdbc7.jar
```
Finally, you can choose a custom plugins directory if the default doesn't suit your needs by setting the environment variable `MB_PLUGINS_DIR`.
docs/administration-guide/images/oracle_jdbc_download.png

26.8 KiB

0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment