Docs/Connections/Cloud Databases

Google Cloud SQL Connection Guide

Use this page when your source or target is hosted in Google Cloud SQL.

This guide focuses on the public setup that DBConvert Streams needs:

  • network reachability
  • connection parameters
  • SSL/TLS considerations
  • the extra flag required for PostgreSQL CDC

For current source, target, and mode boundaries, see the product introduction page.

Supported workflows in this docs set

This page covers Google Cloud SQL instances used through:

  • a MySQL connection
  • a PostgreSQL connection
  • PostgreSQL CDC source setup after the required Cloud SQL flag is enabled

It does not document Cloud SQL Proxy-specific connection flows. The public docs assume direct network access to the instance endpoint.

Base setup

  1. Sign in to the Google Cloud Console.
  2. Open your Cloud SQL instance.
  3. Confirm the engine type: MySQL or PostgreSQL.
  4. Confirm the instance has a public or otherwise reachable network path from the DBConvert Streams deployment.

select MySQL/ PostgreSQL instance

Network configuration

Use the instance IP address that your deployment can reach directly.

  1. Open the instance Summary tab and note the public IP.
  2. Open Networking.
  3. Confirm that the instance is allowed to accept traffic from the DBConvert Streams host.
  4. Add an authorized network entry for the deployment IP if needed.

Authorize Network

Cloud SQL Connections Summary

Connection configuration

Typical fields:

  • host: the Cloud SQL public IP or reachable hostname
  • port: 3306 for MySQL, 5432 for PostgreSQL
  • username
  • password
  • database
  • SSL/TLS settings if required by your policy

Use:

SSL configuration

Use SSL/TLS whenever your environment requires encrypted transport.

  1. Enable or confirm SSL on the Cloud SQL side.
  2. Configure the matching SSL mode in DBConvert Streams.
  3. Upload CA or client certificates where required by the selected engine and policy.

Use SSL Configuration for the certificate flow.

PostgreSQL CDC in Cloud SQL

If you use Cloud SQL PostgreSQL as a CDC source, you must enable logical decoding first.

Google Cloud SQL PostgreSQL Flags

  1. Edit the instance.
  2. Open the database flags section.
  3. Add cloudsql.logical_decoding = on.
  4. Save the change and wait for the instance to restart or apply the update.
  5. Then follow PostgreSQL CDC Source Configuration for privileges and stream setup.

Validation checklist

  1. Test the connection from the Data Explorer sidebar (right-click → Test connection) or from the connection editor. If it fails, verify the deployment IP is listed under Authorized networks in the Cloud SQL console.
  2. Open the instance in Data Explorer to verify visibility.
  3. For PostgreSQL CDC, confirm cloudsql.logical_decoding is set to on in the instance flags. Run SHOW wal_level and verify it returns logical.
  4. If using SSL, confirm the connection succeeds with the selected verification mode — Cloud SQL may reject connections that skip certificate validation.