Manage Excel Online Data in DBArtisan as a JDBC Source

The CData JDBC Driver for Excel Online seamlessly integrates Excel Online data into database management tools like DBArtisan by enabling you to access Excel Online data as a database. This article shows how to create a JDBC source for Excel Online in DBArtisan. You can then edit data visually and execute standard SQL.

Integrate Excel Online Data into DBArtisan Projects

Follow the steps below to register Excel Online data as a database instance in your project:

1. In DBArtisan, click Data Source -> Register Datasource.
2. Select Generic JDBC.
3. Click Manage.
4. In the resulting dialog, click New. Enter a name for the driver and click Add. In the resulting dialog, navigate to the driver JAR. The driver JAR is located in the lib subfolder of the installation directory.
5. In the Connection URL box, enter credentials and other required connection properties in the JDBC URL.

   You can connect to a workbook by providing authentication to Excel Online and then setting the following properties:

   • Workbook: Set this to the name or Id of the workbook.

     If you want to view a list of information about the available workbooks, execute a query to the Workbooks view after you authenticate.

   • UseSandbox: Set this to true if you are connecting to a workbook in a sandbox account. Otherwise, leave this blank to connect to a production account.

   You use the OAuth authentication standard to authenticate to Excel Online. See the Getting Started section in the help documentation for a guide. Getting Started also guides you through executing SQL to worksheets and ranges.

   Built-in Connection String Designer

   For assistance in constructing the JDBC URL, use the connection string designer built into the Excel Online JDBC Driver. Either double-click the JAR file or execute the jar file from the command-line.

   java -jar cdata.jdbc.excelonline.jar

   Fill in the connection properties and copy the connection string to the clipboard.

   Below is a typical connection string:

   jdbc:excelonline:InitiateOAuth=GETANDREFRESH
6. Finish the wizard to connect to Excel Online data. Excel Online entities are displayed in the Datasource Explorer.

You can now work with Excel Online data as you work with any other database. See the driver help documentation for more information on the queries supported by the Excel Online API.