Follow the instructions below to connect Yellowfin to an Oracle database.
Yellowfin does not ship with the driver required for this connection due to licensing/paywall reasons. You will need to manually upload the driver through the Plugin Manager.
Click on the Create button and choose the data source option.
Select the database option.
When the New Connection popup appears, provide a name and description for your Oracle database.
Choose Oracle from the list of available database options. New configuration fields will appear on doing so.
Select the Include Schema in SQL checkbox to include the schema name when addressing database tables in SQL queries.
Specify how you want to connect by choosing one of the following connection methods:
SID: Select this option if you want to connect with the Oracle SID, which is a unique name that identifies your Oracle instance/database.
Service: Select this option to connect using the Oracle service name (TNS alias) and remotely connect to your Oracle instance.
TNSNAMES: This option should be selected if you want to connect by using the tnsnames.ora file.
If connecting with a SID or service name, continue with the following steps, otherwise skip to step 10 if you have chosen to connect using the tnsnames.ora file.
Next, enter the name or IP address of the server hosting the database.
The default port number for Oracle will automatically appear.
Provide the name of the database containing the data that you require.
Enter the value of the selected connection method (selected in step 6). E.g. if SID was chosen, provide the source ID number, or if TNSNAMES was selected, then provide the contents of your tnsnames.ora file.
Select the Use Custom Fetch Size checkbox if you want a select number of data rows to be retrieved from the database after a query is executed. Specify the number of rows.
Yellowfin will automatically select the correct JDBC driver to talk to your Oracle database.
Enter the username and password of your database account.
Once you have completed your connection information, you will have several options:
Advanced Connection Editor: This will take you to the Data Source page in the Admin Console and allow you to edit all the advanced options available for your database.
Test Connection: This will test the connection parameters you provided to ensure it can connect to your database. If the connection was successful, a message will appear.
Create View: This will save your connection and get you started on creating a view based on it.
Save & Close: This will allow you to save your connection and close the New Connection popup, returning you to the page you were on previously.
Cancel: This closes the New Connection popup without saving your connection, returning you to the page you were on previously.
We recommend testing your connection, and then saving it by clicking on the Save & Close button.