Integrate the Carbone API with the Snowflake API

The Carbone API provides a powerful solution for automating the generation and transformation of documents. With Carbone, you can dynamically create PDFs, Excel files, and more by injecting data into templates. On Pipedream, you can integrate Carbone into serverless workflows, tapping into its capabilities to automate document customization and distribution. Integrating Carbone into Pipedream workflows allows you to leverage data from various sources, transform it on-the-fly, and produce documents tailored for clients, reports, or any personalized content.

Connect Carbone#

import { axios } from "@pipedream/platform"
export default defineComponent({
  props: {
    carbone: {
      type: "app",
      app: "carbone",
    }
  },
  async run({steps, $}) {
    const data = {
      "template": `SGVsbG8gd29ybGQsIHRoaXMgaXMgbXkgUGlwZWRyZWFtIHRlbXBsYXRlLg==`,
    }
    return await axios($, {
      method: "post",
      url: `https://api.carbone.io/template`,
      headers: {
        Authorization: `Bearer ${this.carbone.$auth.production_api_key}`,
        "carbone-version": `4`,
        "carbone-template-delete-after": `86400`,
      },
      data,
    })
  },
})

Overview of Snowflake#

Snowflake offers a cloud database and related tools to help developers create robust, secure, and scalable data warehouses. See Snowflake's Key Concepts & Architecture.

Getting Started

1. Create a user, role and warehouse in Snowflake

Snowflake recommends you create a new user, role, and warehouse when you integrate a third-party tool like Pipedream. This way, you can control permissions via the user / role, and separate Pipedream compute and costs with the warehouse. You can do this directly in the Snowflake UI.

We recommend you create a read-only account if you only need to query Snowflake. If you need to insert data into Snowflake, add permissions on the appropriate objects after you create your user.

2. Enter those details in Pipedream

Visit https://pipedream.com/accounts. Click the button to Connect an App. Enter the required Snowflake account data.

You'll only need to connect your account once in Pipedream. You can connect this account to multiple workflows to run queries against Snowflake, insert data, and more.

3. Build your first workflow

Visit https://pipedream.com/new to build your first workflow. Pipedream workflows let you connect Snowflake with 1,000+ other apps. You can trigger workflows on Snowflake queries, sending results to Slack, Google Sheets, or any app that exposes an API. Or you can accept data from another app, transform it with Python, Node.js, Go or Bash code, and insert it into Snowflake.

Learn more at Pipedream University.

Connect Snowflake#

import { promisify } from 'util'
import snowflake from 'snowflake-sdk'

export default defineComponent({
  props: {
    snowflake: {
      type: "app",
      app: "snowflake",
    }
  },
  async run({steps, $}) {
    const connection = snowflake.createConnection({
      ...this.snowflake.$auth,
      application: "PIPEDREAM_PIPEDREAM",
    })
    const connectAsync = promisify(connection.connect)
    await connectAsync()
    
    async function connExecuteAsync(options) {
      return new Promise((resolve, reject) => {
        connection.execute({
          ...options,
          complete: function(err, stmt, rows) {
            if (err) {
              reject(err)
            } else {
              resolve({stmt, rows})
            }
          }
        })
      })
    }
    
    // See https://docs.snowflake.com/en/user-guide/nodejs-driver-use.html#executing-statements
    const { rows } = await connExecuteAsync({
      sqlText: `SELECT CURRENT_TIMESTAMP()`,
    })
    return rows
  },
})