Enable the Cosmos DB JDBC Driver in KNIME

One of the strengths of the CData JDBC Driver for Cosmos DB is its cross-platform support, enabling integration with major BI tools. Follow the procedure below to access Cosmos DB data in KNIME and to create a chart from Cosmos DB data using the report designer.

Define a New JDBC Connection to Cosmos DB Data

1. Go to File -> Preferences -> KNIME -> Databases
2. Click Add File and add the cdata.jdbc.cosmosdb.jar. The driver JAR file is located in the lib subfolder of the installation directory.
3. Click Find driver classes
4. Set the ID and the Name of the connection (you can set any values you prefer for these fields as they are not restricted)
5. Set the URL template. A typical JDBC URL is provided below: jdbc:cosmosdb:AccountEndpoint=myAccountEndpoint;AccountKey=myAccountKey;

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

java -jar cdata.jdbc.cosmosdb.jar

Additionally, please refer to our documentation to learn more about Connection Properties

6. Click OK to close the configuration section.
7. Under Node Repository go to DB -> Connection -> drag and drop DB Connector. Double-click on it and change the driver name to the driver you just configured, in this case, Cosmos DB (ID: Cosmos DB). The Database URL should change automatically.
8. Click Apply and OK to save changes.
9. Right-click on the connector and select Execute. You will see that the connector will allow you to redirect to the browser where you will need to log in and allow access. After that, you will get connected successfully.

Now you can go to the Read/Write section in Node Repository and get a DB Query Reader, to be able to execute a query.

10. Double-click on your DB Query Reader and click the refresh button to load the metadata. Create an SQL Statement and click Evaluate. After clicking Evaluate you will be able to see the records requested. To learn more about the tables/views that are listed in our driver please refer to our Data Model.

Get Started Today

Download a free, 30-day trial of the CData JDBC Driver for Cosmos DB and start building Cosmos DB-connected charts and reports with KNIME. Reach out to our Support Team if you have any questions.