Automated Continuous Postmark Replication to Google BigQuery
Always-on applications rely on automatic failover capabilities and real-time data access. CData Sync integrates live Postmark data into your Google BigQuery instance, allowing you to consolidate all of your data into a single location for archiving, reporting, analytics, machine learning, artificial intelligence and more.
Configure Google BigQuery as a Replication Destination
Using CData Sync, you can replicate Postmark data to Google BigQuery. To add a replication destination, navigate to the Connections tab.
- Click Add Connection.
- Select the Destinations tab and locate the Google BigQuery connector.
- Click the Configure Connection icon at the end of that row to open the New Connection page. If the Configure Connection icon is not available, click the Download Connector icon to install the Google BigQuery connector. For more information about installing new connectors, see Connections in the Help documentation.
- After the connected is added, enter the necessary connection properties. To connect to Google BigQuery, use OAuth authentication::
- Connection Name: Enter a connection name of your choice.
- Auth Scheme: Select OAuth. Sync supports the OAuth, OAuthJWT, GCPInstanceAccount, and AWSWorkloadIdentity authentication methods.
- ProjectId: Enter the ID of the project you want to connect to.
- DatasetId: Enter the ID of the dataset you want to connect to.
- Insert Mode: Set it to Upload. The different Insert Modes available in Sync are Streaming, DML, Upload, and GCSStaging.
- Click Connect to Google BigQuery. Log in using your Gmail credentials to grant permissions to CData Sync. CData Sync completes the OAuth process and connects successfully to Google BigQuery.
- Once connected, click Save & Test to save the connection.
You are now connected to Google BigQuery and can use it as both a source and a destination.
NOTE: You can use the Label feature to add a label for a source or a destination.
In this article, we will demonstrate how to load Postmark data into Google BigQuery and utilize it as a destination.
Configure the Postmark Connection
You can configure a connection to Postmark from the Connections tab. To add a connection to your Postmark account, navigate to the Connections tab.
- Click Add Connection.
- Select a source (Postmark).
- Configure the connection properties.
Using API Key Authentication
Postmark uses server API tokens to authenticate requests. Each Postmark server has its own API token, which controls access to messages, bounces, templates, and statistics associated with that server.
To obtain your Server API Token, log in to your Postmark account and navigate to the server you want to connect to. Go to API Tokens under the server settings and copy the token labeled Server API token.
After setting the following connection properties, you are ready to connect:
- AuthScheme: Set this to APIKey.
- APIKey: Set this to your Postmark Server API Token. This value is sent as the X-Postmark-Server-Token header on every request.
Example connection string:
Profile=C:\profiles\Postmark.apip;AuthScheme=APIKey;ProfileSettings="APIKey=your-server-api-token"
Connecting to Postmark
Once the authentication is configured, you can connect to Postmark and query data from any of the available tables such as OutboundMessages, Bounces, and Templates.
- Click Connect to Postmark to ensure that the connection is configured properly.
- Click Save & Test to save the changes.
Configure Replication Queries
CData Sync enables you to control replication with a point-and-click interface and with SQL queries. For each replication you wish to configure, navigate to the Jobs tab and click Add Job. Select the Source and Destination for your replication.
Replicate Entire Tables
To replicate an entire table, navigate to the Task tab in the Job, click Add Tasks, choose the table(s) from the list of Postmark tables you wish to replicate into Google BigQuery, and click Add Tasks again.
Customize Your Replication
You can use the Columns and Query tabs of a task to customize your replication. The Columns tab allows you to specify which columns to replicate, rename the columns at the destination, and even perform operations on the source data before replicating. The Query tab allows you to add filters, grouping, and sorting to the replication with the help of SQL queries.
Schedule Your Replication
Select the Overview tab in the Job, and click Configure under Schedule. You can schedule a job to run automatically by configuring it to run at specified intervals, ranging from once every 10 minutes to once every month.
Once you have configured the replication job, click Save Changes. You can configure any number of jobs to manage the replication of your Postmark data to Google BigQuery.
Run the Replication Job
Once all the required configurations are made for the job, select the Postmark table you wish to replicate and click Run. After the replication completes successfully, a notification appears, showing the time taken to run the job and the number of rows replicated.
Free Trial & More Information
Now that you have seen how to replicate Postmark data into Google BigQuery, visit our CData Sync page to explore more about CData Sync and download a free 30-day trial. Start consolidating your enterprise data today!
As always, our world-class Support Team is ready to answer any questions you may have.