Export from Cloudflare to PostgreSQL

CloudQuery is an open-source data integration platform that allows you to export data from any source to any destination.

The CloudQuery Cloudflare plugin allows you to sync data from Cloudflare to any destination, including PostgreSQL. It's free, open source, requires no account, and takes only minutes to get started.

Ready? Let's dive right in!

Step 1. Install the CloudQuery CLI

The CloudQuery CLI is a command-line tool that runs the sync. It supports MacOS, Linux and Windows.

brew install cloudquery/tap/cloudquery

Step 2. Configure the Cloudflare source plugin

Create a configuration file for the Cloudflare plugin and set up authentication.

Configuration

Create a file called cloudflare.yaml and add the following contents:

kind: source
# Common source-plugin configuration
spec:
  name: cloudflare
  path: cloudquery/cloudflare
  version: "v5.0.11"
  tables: ["*"]
  destinations: ["postgresql"]

  # Cloudflare specific configuration
  spec:
    # Optional parameters
    # api_token: ""
    # api_email: ""
    # api_key: ""
    # accounts: []
    # zones: []
    # concurrency: 10000

Fine-tune this configuration to match your needs. For more information, see the Cloudflare Plugin ↗ page in the docs.

Authentication

In order to fetch information from Cloudflare, cloudquery needs to be authenticated. There are a few options for authentication:

Export the CLOUDFLARE_API_TOKEN environment variable
Export the CLOUDFLARE_EMAIL and CLOUDFLARE_API_KEY environment variables
Specify either the api_token or api_email, api_key parameters in the YAML configuration (See Configuration for more details).

The plugin requires only read permissions. To start, Cloudflare has a read all resources API token template (opens in a new tab) that will grant CloudQuery the necessary permissions to fetch information from Cloudflare. As necessary, those permissions can be refined and modified further to meet your needs.

Step 3. Configure the PostgreSQL destination plugin

Create a configuration file for the PostgreSQL plugin and set up authentication.

Configuration

Create a file called postgresql.yaml and add the following contents:

This example configures a Postgresql destination, located at localhost:5432:

kind: destination
spec:
  name: "postgresql"
  registry: "github"
  path: "cloudquery/postgresql"
  version: "v6.1.2"

  spec:
    connection_string: "postgresql://postgres:pass@localhost:5432/postgres?sslmode=disable"
    # can be also specified in DSN format which can hold special characters in password
    # connection_string: "user=postgres password=pass+0-[word host=localhost port=5432 dbname=postgres"
    # Optional parameters:
    # pgx_log_level: error
    # batch_size: 10000 # 10K entries
    # batch_size_bytes: 100000000 # 100 MB
    # batch_timeout: 60s

Fine-tune this configuration to match your needs. For more information, see the PostgreSQL Plugin ↗ page in the docs.

Step 4. Start the Sync

Run the following command in your terminal to start the sync

cloudquery sync cloudflare.yaml postgresql.yaml

And away we go! 🚀 The sync will run until completion, fetching all selected tables from Cloudflare. Any errors will be logged to a file called cloudquery.log.

Export from Cloudflare to PostgreSQL

Step 1. Install the CloudQuery CLI

Step 2. Configure the Cloudflare source plugin

Configuration

Authentication

Step 3. Configure the PostgreSQL destination plugin

Configuration

Step 4. Start the Sync

Further Reading