Connect to Adobe Analytics Data in as an External Source in Dremio

The CData JDBC Driver for Adobe Analytics implements JDBC Standards and allows various applications, including Dremio, to work with live Adobe Analytics 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 Adobe Analytics data as a part of your enterprise data lake. This article describes how to connect to Adobe Analytics data from Dremio as an External Source.

The CData JDBC Driver enables high-speed access to live Adobe Analytics data in Dremio. Once you install the driver, authenticate with Adobe Analytics and gain immediate access to Adobe Analytics data within your data lake. By surfacing Adobe Analytics data using native data types and handling complex filters, aggregations, & other operations automatically, the CData JDBC Driver grants seamless access to Adobe Analytics data.

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

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 Adobe Analytics to %DREMIO_HOME%/jars/3rdparty. You can use commands similar to the following:

ARP Connector

docker cp PATH\TO\dremio-adobeanalytics-plugin-20.0.0.jar dremio_image_name:/opt/dremio/jars/

JDBC Driver for Adobe Analytics

docker cp PATH\TO\cdata.jdbc.adobeanalytics.jar dremio_image_name:/opt/dremio/jars/3rdparty/

Connecting to Adobe Analytics

Adobe Analytics will now appear as an External Source option in Dremio. The ARP Connector built uses a JDBC URL to connect to Adobe Analytics 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 Adobe Analytics JDBC Driver. Double-click the JAR file or execute the jar file from the command line.

java -jar cdata.jdbc.adobeanalytics.jar

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

Adobe Analytics uses the OAuth authentication standard. To authenticate using OAuth, you will need to create an app to obtain the OAuthClientId, OAuthClientSecret, and CallbackURL connection properties. See the "Getting Started" section of the help documentation for a guide.

Retrieving GlobalCompanyId

GlobalCompanyId is a required connection property. If you do not know your Global Company ID, you can find it in the request URL for the users/me endpoint on the Swagger UI. After logging into the Swagger UI Url, expand the users endpoint and then click the GET users/me button. Click the Try it out and Execute buttons. Note your Global Company ID shown in the Request URL immediately preceding the users/me endpoint.

Retrieving Report Suite Id

Report Suite ID (RSID) is also a required connection property. In the Adobe Analytics UI, navigate to Admin -> Report Suites and you will get a list of your report suites along with their identifiers next to the name.

After setting the GlobalCompanyId, RSID and OAuth connection properties, you are ready to connect to Adobe Analytics.

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:adobeanalytics:RTK=5246...;GlobalCompanyId=myGlobalCompanyId; RSID=myRSID; OAuthClientId=myOauthClientId; OauthClientSecret=myOAuthClientSecret; CallbackURL=myCallbackURL;

Access Adobe Analytics as an External Source

To add Adobe Analytics as an External Source, click to add a new source and select AdobeAnalytics. Copy the JDBC URL and paste it into the New AdobeAnalytics Source wizard.

Save the connection and you are ready to query live Adobe Analytics data in Dremio, easily incorporating Adobe Analytics data into your data lake.

More Information & Free Trial

Using the CData JDBC Driver for Adobe Analytics in Dremio, you can incorporate live Adobe Analytics data into your data lake. Check out our CData JDBC Driver for Adobe Analytics page for more information about connecting to Adobe Analytics. Download a free, 30 day trial of the CData JDBC Driver for Adobe Analytics and get started today.