search shadow

Menu

Articles in this section

See more

Amazon QuickSight Connector Guide Follow

amazon.png

Index

  1. Introduction
  2. Account Creation
  3. Activation
  4. User Panel
  5. QuickSight Setup
  6. How to Uninstall the app
  7. Beta HubSpot APIS
  8. Opt-In Tables
  9. Data Sync
  10. Data Security

Introduction

The Datawarehouse.io HubSpot Amazon Quicksight Connector helps users analyze their HubSpot data fluently within Amazons cloud-native BI App. This application consists of data synchronization between HubSpot and Azure SQL databases, as well as Schema Replication. 

 

Account Creation

1. Create an account at https://datawarehouse.io/account/ 

2. To connect to your app of choice visit the following link and select the app you wish you use. (https://datawarehouse.io/products/).

3. Click the get started link on the app product page.

4. You will be re-directed to an authentication page. Please click the Authorize button.

5. Login to HubSpot if you are not already logged in and select the HubSpot account you wish to connect too.

6. Authorize the app to connect to your HubSpot portal by clicking the Connect App button.

7. You are then re-directed to the checkout screen. Please fill out all required information in order to activate your service.

 

Activation

Once you have successfully signed up, we will activate your user. Upon Activation one Azure SQL DB will be created with the user's data. An email will then be sent to you with your server information.

 

User Panel

You can visit https://datawarehouse.io/account/my-app-information-item/ to perform the following self service administrative actions for your connector database. 

  • Re-send your credentials to the email address associated with your order.
  • Reset the password of your connector database
  • Update your Order information
    • Email
    • First Name
    • Last Name
    • Company Name
  • Change your Database information
    • Database Name
    • Database Username

 

 

 

Quicksight Setup

1. Start Quicksight and select Datasets. Then select New Dataset.

 

mceclip1.png

 

2. Select SQL Server as the data source.

 

mceclip2.png

 

3. Amazon Quicksight uses JDBC as the authentication method to connect to an Azure MS SQL Server.

In order to connect correctly you must enter your Username into the Username box using the following convention "YourUserName@YourServerName"

"YourUsername" is your connector user name and "YourServerName" is your connector server name. You must put the @ sign between them in the Username section as shown below in order to connect.

In the Port field please enter port 1433

 

mceclip0.png

 

4. After you connect your database to Quicksight you can begin setting up the relationships between the data tables as needed. HubSpot stores all of its data in separate tables and our app replicates that structure. So in order to see certain labels you have to join tables using the keys listed in the ERD that can be found here. https://support.datawarehouse.io/hc/en-us/articles/360054107794-Datawarehouse-io-HubSpot-Connector-ERD 

 

To learn about how to do joins in Quicksight visit this link. https://docs.aws.amazon.com/quicksight/latest/user/joining-data.html 

 

How to Uninstall the app

*Please note this does not cancel your subscription. To do that please visit https://datawarehouse.io/account/view-subscription

1.  Open up the HubSpot Portal that you have installed the app in. In the top right section of HubSpot click on the house icon.

2. A menu will drop down. Click on the Connected apps link.

 

mceclip0.png

3.  Then click on the actions button for the HubSpot Amazon Quicksight Connector. And click uninstall.

 

Beta HubSpot Apis

This app utilizes the following beta APIs

ContactWebEvents data table that contains web analytics history for Contacts is powered by the beta API listed below. https://developers.hubspot.com/docs/api/events/web-analytics

Feedback Submissions data table that contains Feedback Submission data is powered by the beta API listed below.

https://developers.hubspot.com/docs/api/crm/feedback-submissions 

ChatflowThread and ChatflowMessage data tables contain Chatflows data and is powered by the beta API listed below.

https://developers.hubspot.com/docs/api/conversations/conversations 

More information about beta APIs can be found in this supporting documentation.

 

Opt-In Tables

The following tables are opt-in as they are advanced and are large data sets and can take up a significant amount of storage and API Calls. Submit a support request with your database name or email help@datawarehouse.io to ask for these to be enabled. There is no additional cost to enable these tables. 

 

ContactWebEvents

CustomEvent

ContactSubscriptionType

ChatflowThread

ChatflowMessage

TicketPropertiesHistory

DealPropertiesHistory

ContactPropetiesHistory

CompanyPropertiesHistory

EngagementsHistory

 

Data Sync

Data syncing will be done at intervals determined by your plan.

Please allow at least 24-48 hours from activation for the initial database to be built. Once it is built it will refresh at the rate determined by your plan.

 

Data Security

  • Only you will have "read only" access to your database. You can make changes in Quicksight, but they will not be reflected in HubSpot.
  • User authentication for HubSpot is done using OAuth 2.0 protocol as per the best practice in industry.
  • This application is GDPR Compliant. 
  • If you have trouble accessing the database due to your internal firewall restrictions please have your IT department open outbound TCP Port 1433
  • If there is information missing from a property it could be because that fields is improperly configured in HubSpot.

Related articles