Difference between revisions of "Configuring a PostgreSQL Data Source"

From Explore Analytics: The Wiki
Jump to navigation Jump to search
Line 53: Line 53:
 
Setting up an agent-based data source is the most difficult task in Explore Analytics. Don't hesitate to seek help. You can contact [http://www.exploreanalytics.com/support.html Explore Analytics Support].
 
Setting up an agent-based data source is the most difficult task in Explore Analytics. Don't hesitate to seek help. You can contact [http://www.exploreanalytics.com/support.html Explore Analytics Support].
  
{{Template:Preparing to Explore|Configuring a MySQL Data Source|Configuring a Microsoft Access Data Source}}
+
{{Template:Preparing to Explore|Configuring a MySQL Data Source|Configuring a SQL Server Data Source}}

Revision as of 14:04, 23 October 2013

Overview

Explore Analytics supports two modes of connecting to your PostreSQL database:

  1. Direct - if your database is accessible directly from the cloud, for example if it resides on Amazon AWS, then you can directly connect to it.
  2. Agent - if your database resides in your private network, the Explore Analytics Agent facilitates the communication between Explore Analytics and your database.

If the agent is required, please see the section Installing the Explore Analytics Agent for installation instructions.

The agent should be installed on a Windows computer that has access to the database. For example, you may install it on the computer that hosts the database.

Unless you're using a direct connection, the rest of this page assumes that you have the agent installed and running. You're now ready to setup a PostgreSQL data source and create live reports that draw data directly from your database.

Creating the Data Source

To create the data source, go to the "Data" menu and select the option "Add a new data source", then select "PostgreSQL". You will see the following dialog. Select "Direct" or "Agent".

Add postgresql data source.png

You will then see the following dialog. If you selected "Direct", then the agent drop-down selection will be absent. We show the dialog with some example inputs already populated. We then explain each entry.

Add postgresql agent data source.png

Data Source Name

Give this data source a name that would identify it.

Description

Optional description. This is shown when you list data sources to help users choose the correct data source.

Agent Service Account

The choices for this field are typically pre-populated for you, and there's usually only one choice. This is the name of the Explore Analytics account through which the agent connects to Explore Analytics. You will need to make a selection here only if you have multiple agents that service different data sources.

PostgreSQL Host

This is the host name (computer name) of the computer on which PostgreSQL resides. If the agent is installed on the same computer as the database, then you can typically refer to the host as "localhost" as in our example. If the database is on another computer, enter the name or IP address of that computer.

PostgreSQL User

This is the name of the database user through which we connect to the database to access data. You can control access permissions by granting this user only the necessary (read) access to the tables.

PostgreSQL Password

The password of the user entered in the previous field.

PostgreSQL Database Name

Your database manages several "databases" each one has a database name (this is a PostgreSQL terminology). The data source is for one such database. Please specify the name of the database (in our example it is "Chinook", an example database for PostgreSQL).

Getting Help

Setting up an agent-based data source is the most difficult task in Explore Analytics. Don't hesitate to seek help. You can contact Explore Analytics Support.

Configuring a Data Source
Configuring an Oracle Data Source
Configuring an Oracle Cloud Data Source
Configuring a MySQL Data Source
Configuring a PostgreSQL Data Source
Configuring a DB2 Data Source
Configuring a SQL Server Data Source
Configuring a Microsoft Access Data Source
Configuring an Informix Data Source
Configuring a ServiceNow Data Source
Configuring an Amazon RDS Data Source
Configuring a SQLite Data Source
Refreshing Data Source Configuration
Explore Analytics Agent
Installing the Explore Analytics Agent
Installing the Explore Analytics Agent on Linux
Uploading Data
Importing a Google Spreadsheet