Prepare, Blend, and Analyze Cosmos DB Data in Alteryx Designer

Alteryx is a software platform that allows people to work with data more easily. When paired with CData Connect Cloud, Alteryx provides instant access to Cosmos DB data from your data automation processes. This article demonstrates how to connect to Cosmos DB using Connect Cloud and work with Cosmos DB data in Alteryx.

CData Connect Cloud offers a dedicated SQL Server interface for Cosmos DB, facilitating data querying without the need for data replication to a native database. With built-in optimized data processing capabilities, CData Connect Cloud efficiently directs all supported SQL operations, including filters and JOINs, straight to Cosmos DB. This harnesses server-side processing to rapidly retrieve the desired Cosmos DB data.

Configure Cosmos DB Connectivity for Alteryx

Connectivity to Cosmos DB from Alteryx is made possible through CData Connect Cloud. To work with Cosmos DB data from Alteryx, we start by creating and configuring a Cosmos DB connection.

1. Log into Connect Cloud, click Connections and click Add Connection
2. Select "Cosmos DB" from the Add Connection panel
3. Enter the necessary authentication properties to connect to Cosmos DB.

   To obtain the connection string needed to connect to a Cosmos DB account using the SQL API, log in to the Azure Portal, select Azure Cosmos DB, and select your account. In the Settings section, click Connection String and set the following values:

   • AccountEndpoint: The Cosmos DB account URL from the Keys blade of the Cosmos DB account
   • AccountKey: In the Azure portal, navigate to the Cosmos DB service and select your Azure Cosmos DB account. From the resource menu, go to the Keys page. Find the PRIMARY KEY value and set AccountKey to this value.
4. Click Create & Test
5. Navigate to the Permissions tab in the Add Cosmos DB Connection page and update the User-based permissions.

Connect to Cosmos DB from Alteryx

Once you establish a connection to Cosmos DB in Connect Cloud, you are ready to work with Cosmos DB data in Alteryx. To begin, download the ODBC Driver for CData Connect.

1. In the ODBC Driver for CData Connect, select OAuth and click Test Connection. Then enter your CData Connect Cloud Credentials and Sign in.
2. Open Alteryx Designer and create a new workflow.
3. Drag and drop a new input data tool onto the workflow.
4. Click the drop down under Connect a File or Database and select the Data sources tab.
5. Navigate to the end of the page and click on ODBC under Generic connection.
6. Select the DSN that you configured for use in Alteryx.
7. In the wizard that opens, drag and drop the table to be queried in the Query Builder box. Select the fields by checking the boxes that you wish to include in your query. Where possible, the complex queries generated by the filters and aggregations will be pushed down to your data source, while any unsupported operations (which can include SQL functions and JOIN operations) will be managed client-side by the CData SQL engine embedded in the connector.

To further customize the dataset, you can open the SQL Editor and modify the query manually, adding clauses, aggregations, and other operations to ensure that you are retrieving exactly the data desired.

With the query defined, you are ready to work with your data in Alteryx Designer.

Get CData Connect Cloud

To get live data access to 100+ SaaS, Big Data, and NoSQL sources directly from your SQL Server database, try CData Connect Cloud today!