Setup Zuora Connector for Generic Postgres
Configure Your Generic Postgres Destination
To configure your Generic Postgres destination within the Zuora Connector you must set up Generic Postgres database credentials, manage permissions, configure access to the database, and follow other necessary configurations to facilitate a smooth data transfer process from Zuora to Generic Postgres.
Prerequisites
- If your Postgres database is protected by security groups or other firewall settings, you will need to have the data-syncing service's static IP available to complete Step 1.
Step 1: Allow access
- Create a rule in a security group or firewall settings to:
- whitelist incoming connections to your host and port (usually
5432
) from the static IP. - whitelist outgoing connections from ports
1024
to65535
to the static IP.
Step 2: Create writer user
Create a database user to perform the writing of the source data.
- Open a connection to your PostgreSQL database.
- Create a user for the data transfer by executing the following SQL command.
-
CREATE USER <username> PASSWORD '<some-password>';
-
- Grant user
create
andtemporary
privileges on the database.create
allows the service to create new schemas andtemporary
allows the service to create temporary tables.-
GRANT CREATE, TEMPORARY ON DATABASE <database> TO <username>;
-
If the By default, the service creates a new schema based on the destination configuration (in the next step). If you prefer to create the schema yourself before connecting the destination, you must ensure that the writer user has the proper permissions on the schema, using
|
Step 4: Add Your Destination
- After completing the initial setup, access the Generic Postgres connector setup UI to start the provisioning process. To do this, you will need access to the Integration Hub. See Integration Hub to complete the installation.
- Follow this article to link your Connect account to your Zuora account and install the app. If you face any issues, raise a support ticket and stay in touch with your account representative for the necessary access to the Integration Hub UI.
- Once you have access, go to the Marketplace menu and select Integration Hub UI.
- Search for Zuora Connector for Generic Postgres and select it.
- You will see three tabs: Overview, Setup, and Status.
- In the Setup tab, click Configure, enter the required details, and select objects for synchronization.
- Click Test Connection. If successful, click Save Destination to finalize the setup. This will initiate the onboarding process.
- After onboarding, the connector’s Status will change to Active, and you will see status data in the Status tab after the first successful transfer.
- Alternatively, If you encounter issues gaining access to this UI, share your Generic Postgres host address with a Zuora representative. They will assist in creating a connection link. Use the provided connection link to securely input your Generic Postgres details, including the port, database name, schema, and authentication credentials information to complete the setup.
Verification and Data Transfer
Once data synchronization is configured with the Generic Postgres connector, the data is automatically transferred to the specified Postgres database. This enables direct access and querying of the data within your Postgres environment or through compatible data analysis tools. You can seamlessly manage and analyze this data within your Postgres ecosystem.
Format of Transferred Data
For Generic Postgres, the transferred data will be loaded as properly typed tables within a single schema in the database. Additionally, a special _transfer_status
table will be created within the schema to record transfer metadata, specifically including a transfer_last_updated_at
timestamp for each table. This table helps track the last update time for the transferred data, facilitating data management and synchronization processes