Explore Geographical Relationships in CircleCI Data with Power Map
The CData ODBC Driver for CircleCI is easy to set up and use with self-service analytics solutions like Power BI: Microsoft Excel provides built-in support for the ODBC standard. This article shows how to load the current CircleCI data into Excel and start generating location-based insights on CircleCI data in Power Map.
Create an ODBC Data Source for CircleCI
If you have not already, first specify connection properties in an ODBC DSN (data source name). This is the last step of the driver installation. You can use the Microsoft ODBC Data Source Administrator to create and configure ODBC DSNs.
Using API Key Authentication
CircleCI uses personal API tokens to authenticate API requests. To generate a personal API token, log in to your CircleCI account, navigate to User Settings > Personal API Tokens, and click Create New Token. Copy the token value immediately as it is only shown once.
After setting the following connection properties, you are ready to connect:
- AuthScheme: Set this to APIKey.
- APIKey: Set this to your CircleCI personal API token.
Example connection string:
Profile=C:\profiles\CircleCI.apip;AuthScheme=APIKey;ProfileSettings='APIKey=your_personal_api_token';
When you configure the DSN, you may also want to set the Max Rows connection property. This will limit the number of rows returned, which is especially helpful for improving performance when designing reports and visualizations.
When you configure the DSN, you may also want to set the Max Rows connection property. This will limit the number of rows returned, which is especially helpful for improving performance when designing reports and visualizations.
Import CircleCI Data into Excel
You can import data into Power Map either from an Excel spreadsheet or from Power Pivot. For a step-by-step guide to use either method to import CircleCI data, see the "Using the ODBC Driver" section in the help documentation.
Geocode CircleCI Data
After importing the CircleCI data into an Excel spreadsheet or into PowerPivot, you can drag and drop CircleCI entities in Power Map. To open Power Map, click any cell in the spreadsheet and click Insert -> Map.
In the Choose Geography menu, Power Map detects the columns that have geographic information. In the Geography and Map Level menu in the Layer Pane, you can select the columns you want to work with. Power Map then plots the data. A dot represents a record that has this value. When you have selected the geographic columns you want, click Next.
Select Measures and Categories
You can then simply select columns: Measures and categories are automatically detected. The available chart types are Stacked Column, Clustered Column, Bubble, Heat Map, and Region.
