Connect to Talkdesk Data as an External Source in Dremio
The CData JDBC Driver for Talkdesk implements JDBC Standards and allows various applications, including Dremio, to work with live Talkdesk data. Dremio is a data lakehouse platform designed to empower self-service, interactive analytics on the data lake. With the CData JDBC driver, you can include live Talkdesk data as a part of your enterprise data lake. This article describes how to connect to Talkdesk data from Dremio as an External Source.
The CData JDBC Driver enables high-speed access to live Talkdesk data in Dremio. Once you install the driver, authenticate with Talkdesk and gain immediate access to Talkdesk data within your data lake. By surfacing Talkdesk data using native data types and handling complex filters, aggregations, & other operations automatically, the CData JDBC Driver grants seamless access to Talkdesk data.
Prerequisites
This article assumes you are utilizing Docker to run Dremio. You can create a Docker container with the Dremio service using a command similar to the follow:
docker run -d --name dremio -p 9047:9047 -p 31010:31010 dremio/dremio-oss
Where dremio is the name of the container, 9047 is the container's port for the Dremio web interface and 31010 is the port that maps to the Dremio query service. dremio/dremio-oss specifies the image to use.
Build the ARP Connector
To use the CData JDBC Driver in Dremio, you need to build an Advanced Relation Pushdown (ARP) Connector. You can view the source code for the Connector on GitHub or download the ZIP file (GitHub.com) directly. Once you copy or extract the files, run the following command from the root directory of the connector (the directory containing the pom.xml file) to build the connector.
mvn clean install
NOTE: The CData ARP Connectors are build to be compiled with Java 11. Be sure to install Java 11 and use the correct version. You can update your Java version using a command similar to the following:
sudo update-alternatives --config java
Once the JAR file for the connector is built (in the target directory), you are ready to copy the ARP connector and JDBC Driver to your Dremio instance.
Installing the Connector and JDBC Driver
Install the ARP Connector to %DREMIO_HOME%/jars/ and the JDBC Driver for Talkdesk to %DREMIO_HOME%/jars/3rdparty. You can use commands similar to the following:
ARP Connector
docker cp PATH\TO\dremio-talkdesk-plugin-{DREMIO_VERSION}.jar dremio_image_name:/opt/dremio/jars/
JDBC Driver for Talkdesk
docker cp PATH\TO\cdata.jdbc.talkdesk.jar dremio_image_name:/opt/dremio/jars/3rdparty/
Connecting to Talkdesk
Talkdesk will now appear as an External Source option in Dremio. The ARP Connector built uses a JDBC URL to connect to Talkdesk data. The JDBC Driver has a built-in connection string designer that you can use (see below).
Built-in Connection String Designer
For assistance in constructing the JDBC URL, use the connection string designer built into the Talkdesk JDBC Driver. Double-click the JAR file or execute the jar file from the command line.
java -jar cdata.jdbc.talkdesk.jar
Fill in the connection properties and copy the connection string to the clipboard.
Talkdesk uses the OAuth 2.0 Client Credentials grant. There is no browser-based authorization step and no callback URL.
Set the following connection properties:
- AccountName: The name of your Talkdesk account.
- Region: The region where your Talkdesk instance is deployed. Supported values are US (default), EU, CA, AU, UK, and FedRamp.
- OAuthClientId: The Client Id assigned when you registered your custom OAuth application.
- OAuthClientSecret: The Client Secret assigned to your custom OAuth application.
Creating a Custom OAuth Application
- Log in to your Talkdesk account and select OAuth Clients from the navigation menu.
- Click Create OAuth Client and give the client a descriptive name.
- Set Grant Type to Client Credentials.
- Click Add scopes and select the scopes for the data you want to access.
- Click Create and copy the Client Id and Client Secret.
When you connect, the driver automatically requests an access token from Talkdesk, caches it, and refreshes it when it expires. Make sure the scopes selected for the application match the views you plan to query, or the token request can fail.
NOTE: To use the JDBC Driver in Dremio, you will need a license (full or trial) and a Runtime Key (RTK). For more information on obtaining this license (or a trial), contact our sales team.
Add the Runtime Key (RTK) to the JDBC URL. You will end up with a JDBC URL similar to the following:
jdbc:talkdesk:RTK=5246...;AccountName=myAccount;Region=US;OAuthClientId=myClientId;OAuthClientSecret=myClientSecret;
Access Talkdesk as an External Source
To add Talkdesk as an External Source, click to add a new source and select Talkdesk. Copy the JDBC URL and paste it into the New Talkdesk Source wizard.
Save the connection and you are ready to query live Talkdesk data in Dremio, easily incorporating Talkdesk data into your data lake.
More Information & Free Trial
Using the CData JDBC Driver for Talkdesk in Dremio, you can incorporate live Talkdesk data into your data lake. Check out our CData JDBC Driver for Talkdesk page for more information about connecting to Talkdesk. Download a free, 30 day trial of the CData JDBC Driver for Talkdesk and get started today.