Import data from Heroku PostgreSQL

If you have your data stored in Heroku PostgreSQL​ Cloud Database, then you can easily import your data into Zoho Analytics for reporting & analysis. Zoho Analytics allows you to either import the data into Zoho Analytics or connect directly with the Heroku PostgreSQL server.

  • Data Import: Data in Heroku PostgreSQL will be imported and stored in Zoho Analytics. You can setup periodic schedules to fetch the latest data automatically from your Heroku PostgreSQL database. Report loading time will be faster as the data is stored in Zoho Analytics.
  • Live Connect: In this mode, data will not be fetched from Heroku PostgreSQL and stored in Zoho Analytics. Instead for the reports that you create Zoho Analytics will generate appropriate queries that will connect the required data live from Heroku PostgreSQL to Zoho Analytics and show you the report. In this case the loading time will directly depend on the performance of Heroku PostgreSQL. 

Please note that the Live Connect option is exclusively available for paid plans and trials only. Refer to the Live Connect section to learn.

Data Import

  1. How do I import data from the Heroku PostgreSQL database?
  2. How can I edit the setup?
  3. How long does it take for the data to be imported into Zoho Analytics?
  4. Can I import data from Views created in Heroku PostgreSQL (apart from Tables) into Zoho Analytics?
  5. Will foreign keys defined between my tables in the Heroku PostgreSQL database be linked in Zoho Analytics as well?
  6. Can I change the data type of the columns in Zoho Analytics?
  7. I have connected to a database and imported a few tables into Zoho Analytics. Can I add more tables from the same source to the existing connection?
  8. Can I import data from Heroku PostgreSQL database table into an existing table in Zoho Analytics?
  9. I have synced data from a database into a table. Can I change the data source of this table?
  10. Can I import data from my Heroku PostgreSQL database into an existing Zoho Analytics workspace?
  11. Can I synchronize the data from my Cloud Database instantly?
  12. The Last Data Sync Status in Datasources page shows Sync Failed. How do I resolve it?
  13. How do I remove the Setup?

Live Connect [Beta]

  1. How do I connect live with the Heroku PostgreSQL database?
  2. How can I edit the live connect setup?
  3. How is Live Connect different from Data Import?
  4. How long does it take for me to visualize my data in Zoho Analytics?
  5. Will the reports/dashboards query hit my database server every time I open it or can it be cached in Zoho Analytics?
  6. Can I connect Views created in Heroku PostgreSQL (apart from Tables) to Zoho Analytics?
  7. Will foreign keys defined between my tables in the Heroku PostgreSQL database be linked in Zoho Analytics as well?
  8. Can I link the related tables, connected from the Cloud Database using the Live Connect option, in Zoho Analytics?
  9. I got an alert message "This view cannot be accessed due to some changes made in the table" while accessing my tables/reports in Zoho Analytics. What should I do?
  10. What is a Mismatch?
  11. When do Mismatches occur and how to resolve them?
  12. Can I synchronize a data table from my Cloud Database instantly?
  13. Can I connect the new columns added in my Heroku PostgreSQL database to Zoho Analytics?
  14. Can I change the data type of the columns in Zoho Analytics?
  15. Can I import data from other data sources into the same workspace that I have used to connect with Heroku PostgreSQL?
  16. Can I create Query Tables over the Heroku PostgreSQL data?
  17. What happens when I delete or rename the database in Heroku PostgreSQL?
  18. How do I delete a view from a workspace?
  19. How to restore a deleted view in the workspace?
  20. How do I remove the Setup?
  21. What are the limitations of Heroku PostgreSQL Live Connect?

Troubleshooting Tips

  1. I get an error message "Sorry, there is a problem in connecting to your cloud data source. Check your connection details and try again." What should I do?
  2. I am unable to find the Live Connect option while importing data into Zoho Analytics. What could be the possible reasons?

Data Import

 1. How do I import data from the Heroku PostgreSQL database?

2. How can I edit the setup?

3. How long does it take for the data to be imported into Zoho Analytics? 

After setup, you might have to wait sometime for the initial fetch to happen. This depends upon the amount of data to be imported into Zoho Analytics and also the response time of your Heroku PostgreSQL server. You will receive an email notification once the import is complete. Please note that, if you access the workspace before the initial fetch, it will not display any data.
​

4. Can I import data from Views created in Heroku PostgreSQL (apart from Tables) into Zoho Analytics?

Yes, you can import data from Tables as well as Views available in your Heroku PostgreSQL database into your Zoho Analytics workspace.

5. Will foreign keys defined between my tables in the Heroku PostgreSQL database be linked in Zoho Analytics as well? 

When importing multiple tables, the foreign keys defined between the tables in the Heroku PostgreSQL database will be linked in Zoho Analytics. The foreign keys will be created as Look-up columns in Zoho Analytics. 

If you import data from one table at a time (choosing single table option) then the foreign keys will not be defined. However, you can manually link the tables in Zoho Analytics using the Look-up column feature. Click here to learn about the Look-up column feature.

6. Can I change the data type of the columns imported in Zoho Analytics? 

Yes, you can change the data type of the columns imported into Zoho Analytics. However, it is necessary that the data type of your column is compatible with the data type of the column in your Heroku PostgreSQL database for successful data synchronizations. It is always recommended that you change the data type in both your Heroku PostgreSQL database as well as your Zoho Analytics workspace.

7. I have connected to a database and imported a few tables into Zoho Analytics. Can I add more tables from the same source to the existing connection?

Yes, you can add tables from the same source to the existing connection. Follow the below steps:

  1. From your Heroku PostgreSQL workspace, navigate to Create > New Table / Import Data.
  2. Click the Cloud Databases option. The Connect to Cloud Database wizard will open.
  3. From the Connection name drop down menu, select the existing Heroku PostgreSQL database name.
    ​
  4. The rest of the steps are similar to importing data from cloud database.
Note: In case you change the schedule interval while importing the tables, the same intervals will be applied to already imported tables as well.

8. Can I import data from Heroku PostgreSQL database table into an existing table in Zoho Analytics?

Yes, you can import data into an existing table if you are importing from the same source database as the imported table. 

Follow the below steps to import if the source is available in the same Heroku PostgreSQL database that is imported into the table. 

  1. From the required table, click Import Data > Import Data into this Table.
  2. Click Import Data > Import into this Table.
  3. The Select Data to Import tab of the Import wizard will open. 
  4. You can choose to import from the same or a different table using the Select Table option or import using the Custom Query.
    ​ 

9. I have synced data from a database into a table. Can I change the data source of this table? 

Yes, you can change the data source of a table, into which the Heroku PostgreSQL database has been synced. To do this,

  1. Open the workspace.
  2. Click the Data Sources tab from the left bar. 
  3. All the data sources for this workspace will be listed. Click the data source you want to edit.
  4. The Data Sources page will open. Click the Edit Connection link.
  5. In the Cloud Database - Edit Connection dialog that opens, modify the data source.
    ​
  6. Click Save to implement the changes made.

10. Can I import data from my Heroku PostgreSQL database into an existing Zoho Analytics workspace?

Yes. Follow the below steps to import data into an existing workspace:

  1. Open the workspace into which you wish to import the data.
  2. Navigate through Create > New Table / Import Data. 
  3. Click the Cloud Databases option.
  4. Configuring the import will be similar to the steps followed in this presentation.

Configuring the import will be similar to the steps followed in this presentation.

11. Can I synchronize the data from my Cloud Database instantly?  

Yes, you can synchronize your data from Cloud Database instantly when needed. 

To synchronize your data instantly:

  1. Open the required workspace.
  2. From the home page, click the Data Sources tab. 
  3. In the Data Sources page that opens, click the Sync Now link.
Note: This option can be used to a maximum of five times per day.

12. The Last Data Sync Status in Datasources page shows Sync Failed. How do I resolve it?

You can resolve your sync failure by understanding the reason behind the failure. There are two methods to know the reason for the sync failure:

Method 1:

  1. Open the required workspace.
  2. Click the Data Sources tab from the left bar. 
  3. All the data sources for this workspace will be listed. Click the data source that has failed to sync.
  4. The Data Sources page will open. Click the View Last Import Details icon that appears on mouse over of each table row.
  5. The Import Details pop-up page will open. You will find the reason for your failure in the Details section. Take the necessary action based on the reason provided.​

You will find the reason for your failure in the Details section. Take the necessary action based on the reason provided.​

Method 2:

  1. Open the corresponding table.
  2. Navigate through Import Data > Last Import Details.
  3. The Import Details pop-up page will open. You will find the reason for your failure in the Details section. Take the necessary action based on the reason provided.​​
    ​

13. How do I remove the Setup?

To remove the setup,

  1. Open the required workspace.
  2. Click the Data Sources tab from the left bar.
  3. All the data sources for this workspace will be listed. Click the Heroku PostgreSQL data source that you want to remove.
  4. In the Data Sources tab that opens, click the Settings icon inline to the data source name on the right.
  5. Click the Remove Data Source option from the drop-down menu.
    ​

Please note that the data source connection will be removed, but the tables and the data will be retained in the workspace. As the data source connection is removed, no further synchronization will happen.  

Live Connect [Beta]

1. How do I connect live with the Heroku PostgreSQL database?

2. How can I edit the live connect setup?

 

3. How is Live Connect different from Data Import?

Tabulated below are the differences between the Data Import feature and Live Connect feature.

Data ImportLive Connect
Data in Heroku PostgreSQL will be imported and stored in Zoho Analytics.Data from Heroku PostgreSQL will be fetched live using appropriate reporting queries whenever you create or access a report in Zoho Analytics.
Filtered data set can be imported from Heroku PostgreSQL using customized queries.Custom Query feature is not available in Heroku PostgreSQL Live Connect. However, you can create Views in the source database and connect the same with Zoho Analytics.
Multiple data sources (apart from Heroku PostgreSQL) can be imported into the same workspace and they can be combined for reporting & analysis purpose.Cannot import data from any other data source into the same workspace in which Live Connect from Heroku PostgreSQL is setup.
Changes made to the columns such as addition/deletion will be synchronized automatically.Any changes such as column addition/deletion/renaming will not be reflected. You will have to manually map the data using the Sync Design option.
When importing multiple tables, the foreign keys defined between the tables in the Heroku PostgreSQL database will not be linked in Zoho Analytics. However, you can manually link the tables in Zoho Analytics using the Look-up column feature.Look-up relationship will be automatically created for tables that are linked via foreign keys in the Heroku PostgreSQL database. You can also manually link the tables in Zoho Analytics using Look-up column feature.
Users can create query tables.Users cannot create query tables.
Report loading time will be fast as the data is stored in Zoho Analytics.Report loading time directly depends on the Heroku PostgreSQL server response time and the amount of data in Heroku PostgreSQL.

4. How long does it take for me to visualize my data in Zoho Analytics?

As there is no data import process involved, the loading time depends upon the amount of data stored in your Heroku PostgreSQL database and also the response time of your Heroku PostgreSQL server.

5. Will the reports/dashboards query hit my database server every time I open it or can it be cached in Zoho Analytics?
(or) Can I store a cache of my data points in Zoho Analytics to get quick access to my views?

Zoho Analytics allows you to create a cache for the reports in your live connect database to reduce the query fetching time.

To enable cache for your live connect workspace, please follow the below steps:

  1. From your Workspace Explorer, click Settings from the side menubar.
  2. In the General - Workspace Settings page that opens, choose Yes for Enable Cache for this Workspace.
  3. Provide Cache Refresh Interval in Minutes.
  4. Click Save & Close.

A cache for the reports will be created for the Workspace.

Note:
  • Enabling cache will help create a cache for your reports in the workspace. This data will get updated periodically based on the time provided in the Cache Refresh Interval in Minutes. 
  • You can create a cache only for the reports, and not for tables in the workspace.
  • This option is available only for Live Connect.

6. Can I connect Views created in Heroku PostgreSQL (apart from Tables) to Zoho Analytics?

Yes, you can connect with both Views and Tables created in Heroku PostgreSQL to Zoho Analytics.

7. Will foreign keys defined between my tables in the Heroku PostgreSQL database be linked in Zoho Analytics as well?

Yes. In case you have linked two or more tables in your Heroku PostgreSQL database using foreign keys, they will be linked automatically using a Look-up column in Zoho Analytics as well. You can also manually create a lookup relationship among the imported tables in Zoho Analytics.

Note: The lookups created/modified in the added (linked with Zoho Analytics) tables will not be reflected in Zoho Analytics (even with Sync Design option). You need to manually create the lookup in Zoho Analytics. However, the lookup information will be created in Zoho Analytics when new tables are linked.

8. Can I link the related tables, connected from the Cloud Database using the Live Connect option, in Zoho Analytics?

Yes, you can link the related tables in Zoho Analytics using the lookup column feature. Learn more.

Note: 
  • You will not be able to create Query Tables if you have setup the workspace using the Heroku PostgreSQL Live Connect option as this option does not fetch and store the data locally in Zoho Analytics.
  • The Join Tables (lookup column) option will not be available in the Import Wizard. You can create a lookup relation only on the imported tables.

9. I got an alert message "This view cannot be accessed due to some changes made in the table" while accessing my tables/reports in Zoho Analytics. What should I do?

This alert message will be displayed when Zoho Analytics is not able to access the information from Heroku PostgreSQL. This could be because the tables/columns that you are trying to access in Zoho Analytics are deleted or renamed in Heroku PostgreSQL.

In this case, it is recommended that you remap the table/column. Refer to this presentation to know how to remap a table.

10. What is a Mismatch?

When you have created reports in Zoho Analytics over the tables or columns which no longer have a direct mapping in the Heroku PostgreSQL database, it will be listed as a mismatch. 

So, ensure that the tables/columns in the Zoho Analytics workspace and Heroku PostgreSQL database match. The tables/columns that do not match will be listed in the Mismatch tab of the Heroku PostgreSQL​​ Connection Settings page. Refer to the next question to know more about mismatch.

11. When do Mismatches occur and how to resolve them?

12. Can I synchronize a data table from my Cloud Database instantly?  

Yes, you can synchronize your data table from Cloud Database instantly when needed. 

To synchronize your data instantly:

  1. From the workspace explorer, click the Data Sources tab.
  2. You will get navigated to the Heroku PostgreSQL Connection Settings page. All the tables available in the workspace will be listed.
  3. Mouse over the required table. The option to sync the table will be displayed inline to the table name.
  4. Click the Sync link inline to the table name.
    ​
  5. The table data from the Cloud Database will get instantly synchronized in Zoho Analytics table. 
Note: You can also synchronize all the tables available in the workspace with your Heroku PostgreSQL data using the Sync Design button.

13. Can I connect new columns added in my Heroku PostgreSQL database to Zoho Analytics?

Yes, you can connect the new columns that are added in your Heroku PostgreSQL database to Zoho Analytics from the Heroku PostgreSQL​ Connection Settings page by following the below steps:

  1. From the workspace explorer, click the Data Sources tab.
  2. You will get navigated to the Heroku PostgreSQL Connection Settings page. All the tables available in the workspace will be listed.
  3. Mouse over the required table. The option to sync the table will be displayed inline to the table name.
  4. Click the Sync link.

The data added in the particular table in your data source will be synced here. You can also synchronize all the tables available in the workspace with your Heroku PostgreSQL data using the Sync Design button.

Note: If there exists a mismatch between the already available data in your Zoho Analytics workspace and your Heroku PostgreSQL database, Zoho Analytics will NOT be able to fetch the new column information. In this case, you need to first resolve the mismatches to connect to the new columns.

14. Can I change the data type of the columns in Zoho Analytics?

No, you cannot change the data type of the columns in Zoho Analytics.

15. Can I import data from other data sources into the same workspace that I have used to connect with Heroku PostgreSQL?

No, you cannot import data from other data sources into the same workspace that you have used to connect with Heroku PostgreSQL.

16. Can I create Query Tables over the Heroku PostgreSQL data?

No, you will not be able to create Query Tables if you have setup the workspace using the Heroku PostgreSQL Live Connect option. This is because this option does not fetch and store the data locally in Zoho Analytics. If you wish to create Query Tables, you can create the required query as a view in the data source and connect the same with Zoho Analytics.

17. What happens when I delete or rename the database in Heroku PostgreSQL?

When you delete or rename a database in Heroku PostgreSQL, Zoho Analytics loses its connectivity with Heroku PostgreSQL. Thereafter, a warning message, as shown below, would be displayed. This error message will also be displayed if there are any connectivity issues or if your Heroku PostgreSQL credentials have expired.
​

For more information regarding the same, refer to the Edit Connection presentation.

18. How do I delete a view from a workspace?

You can easily delete a view from a live connect workspace, by following the below steps:

  1. Click the More Actions icon that appears on mouse-over the view name.
  2. Click the Delete option from the drop-down menu.
  3. You can also delete multiple views by selecting all the views that you want to delete and clicking the Delete option from the top.

The deleted views will be successfully removed from the workspace and placed in Trash. You can restore the views within 45 days of deletion from the Trash. After the mentioned timeframe, the views will get deleted permanently.

19. How to restore a deleted view in the workspace?

You can restore a deleted view from the workspace trash. To restore a deleted view, 

  1. Open the trash by clicking the Trash icon on the left menubar of the workspace.
  2. All the deleted views will be listed here. You can restore the required view by clicking the Restore icon that appears on mouse-over the view.
  3. You can restore multiple views by selecting the required views and clicking the Restore option from the top.
    ​
Note:

  • You cannot have two or more of the same tables with the same name in a workspace, hence you cannot restore a table if you have connected to the same table from the source database.

  • When you have two or more of the same tables in the trash, you can restore only one table. This instance occurs when you import and delete the same table multiple times.

20. How do I remove the Setup?

You have to delete the workspace in Zoho Analytics to remove the connection setup. 

To delete the workspace,

  1. From your Zoho Analytics account, click the More Actions icon that appears on mouse hover adjacent to the workspace name that you want to delete.
  2. Click the Delete Workspace option from the drop-down menu.

21. What are the limitations of using the Heroku PostgreSQL Live Connect?

Given below are a few shortcomings that one might face while using the Heroku PostgreSQL​​ Live Connect option.

  • Data from your Heroku PostgreSQL database will NOT be locally stored in Zoho Analytics. Zoho Analytics will generate appropriate queries to fetch the required data live from Heroku PostgreSQL and show you the report. Hence, the loading time will directly depend on the performance of Heroku PostgreSQL.
  • Any changes such as column addition/deletion/renaming will not be mapped automatically. The user must manually map the updates made.
  • Users cannot combine data from other data sources into the same workspace in which you have connected the Heroku PostgreSQL database. 
  • Users cannot create query tables.
  • Users cannot change the data type of the columns in Zoho Analytics.

Troubleshooting Tips

1. I get an error message "Sorry, there is a problem in connecting to your cloud data source. Check your connection details and try again." What should I do?

You get this error message when incorrect connection settings are specified. Ensure that the correct user credentials are specified.

2. I am unable to find the Live Connect option while importing data into Zoho Analytics. What could be the possible reasons?

You will be able to connect live in Zoho Analytics only if,

  • You have a paid or trial plan.
  • You are importing data into a new Workspace in Zoho Analytics.
Note: Zoho Analytics does not permit the import of data into an existing Workspace using the Live Connect option.