Analytics-Plus Help

Importing data from Google Cloud SQL 

If you have your data stored in MySQL or PostgreSQL database hosted in Google Cloud SQL, you can either import the data or connect live with the Google Cloud SQL databases for advanced reporting and analysis. You can also set up schedules to periodically fetch the latest data from these databases into Analytics Plus.

You can import data from the following Google Cloud SQL databases:

Log in to Analytics Plus, click on the Import Your Data button found at the top right corner of the screen, and select the Local & Cloud Databases option.

Google Cloud SQL : MySQL

If you have data stored in MySQL database, you can either import the data or connect live with the MySQL server for advanced reporting and analysis. 

Follow the steps below to import data from Google Cloud SQL cloud databases.

Step 1: Local and Cloud Database Connection Settings

  • Service Name: Choose Google Cloud SQL as the service name, this identifies the database service on which the database is running.

  • Database Type: Choose MySQL as the database type.

  • Endpoint: Enter the endpoint host name. Endpoint is the host name that uniquely identifies the cloud database instance. If the endpoint is unknown, contact your database administrator.

  • Port: Enter the port on which the database instance is running.

Note: The database must be accessible from the Analytics Plus server. If the database is protected by firewall, firewall rules must allow public inbound connections to the port on which the database is running.

  • Username: Enter the username that is used to access the database. It is recommended to provide the read-only user name.

  • Password: Enter the password that is associated with the username specified in the database username text box.

  • Database Name: Enter the database name to connect with the data source instance.

  • Connection Type:  Select the connection type as Data Import or Live Connect

  • Click Next to proceed with the import process. 

Live connect

In this mode, data will not be imported and stored in Analytics Plus. Instead, Analytics Plus will display live data from your database when reports and dashboards are launched. Live connections offer the convenience of working with real-time data from your database.

To set up a live connection with your database, refer the Live connect help document. 

Data import

Data in MySQL will be imported and stored in Analytics Plus. You can setup periodic schedules to fetch the latest data automatically from your database. Report loading time will be faster as the data is stored in Analytics Plus.

Step 2: Select data to import

  • Select database: Select the database from which data is to be imported.

  • Select table: Select the required radio button to import data

    • Single table: Select the table from which the data is to be imported.

    • Multiple tables: Select multiple tables option to pull data from different tables at once.  

    • Custom query: Enter your custom query in the respective database query format from which data is to be imported.  

  • Click on "Next" to proceed with the import process.

Step 3: ManageEngine Analytics Plus database setup

You can change the title of the columns, choose to exclude some and change their data types. Choose what the application should do when an error occurs during import. 

Google Cloud SQL: PostgreSQL

Follow the steps below to import data from Google Cloud SQL cloud databases.

Step 1: Local and Cloud Database Connection Settings

  • Service Name: Choose Google Cloud SQL as the service name, this identifies the database service on which the Database is running.

  • Database Type: Choose the database type as PostgreSQL.

  • Endpoint: Enter the endpoint host name. Endpoint is the host name that uniquely identifies the cloud database instance. If the endpoint is unknown, contact your database administrator.

  • Port: Enter the port on which the database instance is running.

  • Note: The database must be accessible from the Analytics Plus server. If the database is protected by firewall, firewall rules must allow public inbound connections to the port on which the database is running.

  • Username: Enter the username that is used to access the database. It is recommended to provide the read-only user name.

  • Password: Enter the password that is associated with the username specified in the database username text box.

  • Database Name: Enter the database name to connect with the data source instance.

  • Connection Type:  Select the connection type as Data Import or Live Connect

  • Click Next to proceed with the import process. 

Live connect

In this mode, data will not be imported and stored in Analytics Plus. Instead, Analytics Plus will display live data from your database when reports and dashboards are launched. Live connections offer the convenience of working with real-time data from your database.

To set up a live connection with your database, refer the Live connect help document. 

Data import

Data in PostgreSQL will be imported and stored in Analytics Plus. You can setup periodic schedules to fetch the latest data automatically from your database. Report loading time will be faster as the data is stored in Analytics Plus.

Step 2: Select data to import

  • Select database: Select the database from which data is to be imported.

  • Select table: Select the required radio button to import data

    • Single table: Select the table from which the data is to be imported.

    • Multiple tables: Select multiple tables option to pull data from different tables at once.  

    • Custom query: Enter your custom query in the respective database query format from which data is to be imported.  

  • Click on "Next" to proceed with the import process.

Step 3: ManageEngine Analytics Plus database setup

You can change the title of the columns, choose to exclude some and change their data types. Choose what the application should do when an error occurs during import. 

Import Summary

Analytics Plus imports the input data provided, it will bring up a Import Summary dialog as shown below, capturing the status of the Import process just completed.

The details that would be shown include:

  • Column Details: Total number of columns in the input data and the total number of columns that where actually selected for import.

  • Row Details: Total number of rows in the input data and the total number of successfully imported rows in it.

  • Scheduling Options: If you wish to schedule imports, click on the "Schedule This Import" option

Schedule Settings 

How do you want to import?

Select your preference from a drop down list on the available options to add new records into your database.

  • Add records at the end: This option adds the new columns towards the end of the existing database table

  • Delete existing records and add: This option deletes the existing records and adds the new records into the database table

  • Add Records and replace if already exists: This option adds the new columns and overwrites records with same column name.

  • Add new, replace existing and delete missing records: This option adds the new records, overwrites the existing records with same column name and deletes the missing records.

Note

  • Check the "include new column added in your Cloud Database automatically into ManageEngine Analytics Plus table", to add the new columns into your Analytics Plus table automatically

  • When Add records and replace if already exists or Add records, replace existing and delete missing record is selected, it is mandatory to specify matching columns using the Select the column(s) to match existing records option. You can choose one or more columns as matching columns. Analytics Plus will use the values in these columns as the key to match the existing records with the new records being imported. Hence the matching column(s) combination should uniquely identify each record in the table. Once a match is identified, then Analytics Plus will update that existing record in the table with the new record values present in the data being Imported. Incase there is no match found, those records will be appended to the end of the table.

You can specify the schedule interval from the available options such as:

  • Repeat- Specify the schedule interval from the drop-down list. Available options are.

    • Every 'N' hours - Choose this option to schedule the import every 'N' hours i.e., every 2 hour or 6 hours. On choosing this option, specify the time interval to import the data.

    • Every Day - Choose this option to schedule the import at a particular time everyday. On choosing this option, specify the time to import data.

    • Weekly Once - Choose this option to schedule the import once in a week on a particular day. On choosing this option, specify the day of the week and the time to import the data.

    • Monthly Once - Choose this option if you want to schedule the import once in a month on a particular day. On choosing this option, specify the day of the month and the time to import data.

On closing the Summary dialog, Analytics Plus will display the newly created table with the data loaded in the same.

 

Share this post : FacebookTwitter