Learn how to add and manage data sources in Databox to simplify and enhance your reporting process.
Availability
Users, editors and admins
All accounts
Data sources are the locations or repositories from which Databox obtains data for you to visualize, analyze, enhance, and derive insights. They are the building blocks of Databox products.
While the terms integration and data source can sometimes be used interchangeably, they represent distinct entities in Databox. An integration is the software or system Databox connects to, while a data source is the specific content accessed within it.
Here are some examples to illustrate the difference:
- Google Analytics 4 (integration) 🡒 Property (data source)
- HubSpot CRM (integration) 🡒 Account (data source)
- Shopify (integration) 🡒 Store (data source)
- GitHub (integration) 🡒 Repository (data source)
- MySQL (integration) 🡒 Credentials (data source)
Add a data source
You can add a data source to your account from several locations:
- On the Data Manager > Available Integrations page, by clicking on the integration's tile
- On the Data Manager > Data Sources page
- On the Account Management > Data Manager > Data Sources page
Add a data source you have access to
The first data source of an integration is added when the connection is first established. If you haven't connected the integration yet, follow the steps outlined in this article.
If you have already connected the integration and want to add another data source from it, select the relevant connection from the list shown at the beginning. Then, follow the prompts and provide the requested information. Depending on the Integration, you may need to either grant consent for Databox to access your data or provide information to access a specific resource and/or authenticate on your behalf.
Add a data source you don't have access to
If you don't have direct access to the data source you want to add, you'll need assistance from someone who does. The steps vary depending on whether that person is already a user in your Databox account.
If they are already a user:
- Check if they have already connected the relevant integration to your account.
- If yes, use that connection to add the desired data source.
- If not, ask them to add a new connection and data source to the account.
If they are not yet a user:
- Add them as a user to the account and ask them to add a new connection and data source.
- Alternatively, Send your colleague a connect request via email by clicking on the link at the bottom of the new connection dialog.
Once access to the data source is validated, it will appear both on the Data Manager > Data Sources and Account Management > Data Manager > Data Sources pages. From there, you can manage all your data sources as needed.
Reconnect a data source
Access to a data source can sometimes be lost or revoked, resulting in an error when Databox attempts to sync data from that data source. This can happen for various reasons, including but not limited to:
- Changes in the connection owner's access or permissions
- Access revocation by the software provider
- Issues with the software provider
- Unknown errors
To reconnect a data source:
- Ensure the cause of the error is identified and resolved
- Navigate to Data Manager > Data Sources
- Locate the data source you want to reconnect
- Click on Reconnect
- Follow the prompts
Depending on the authentication type, you may need to grant consent again or confirm and/or input new credentials. Once completed, our system will establish a new connection, replacing the old one. The data source in error will become accessible to Databox again.
Frequently Asked Questions
Why can't I select a data source?
- Invalid user permissions
- Invalid resource permissions
- Billing/plan restrictions
- Incorrect credentials
- Network or infrastructure problems
- Unknown errors
To troubleshoot this issue, check the dedicated article for the relevant integration here or on the Metric Library. It may be a simple configuration or permission error, but if not, feel free to reach out to the Databox support team for assistance.
Still need help?
Contact us here or start a chat in Databox.