Keboola Uploader

Pricing

Rating

Developer

Actor stats

Categories

Share

Reliable uploader of Apify Datasets to Keboola Connection. We are using Storage API Importer with optimal defaults. This actor is helpful in workflows or for ad-hoc data uploads.

This actor is generalisation of our custom-made uploaders for many of our projects. It uses minimum dependencies and optimizes for speed and reliability.

• gracefully handles migrations
• implements retry policy for failed uploads
• supports Actor Integration
• allows to fine tune the batch size for you optimal usage of resources

Your Apify Dataset will be split into batches, converted to CSV and uploaded with gzip compression enabled. You should choose the batchSize according to the nature of you data. Primitive properties from your Dataset will be 1:1 mapped to CSV table. Complex properties (arrays and objects) will be serialized to JSON, so you can use Snowflake support for JSON in your transformations.

Inputs

Apify Dataset ID datasetId

ID of Apify Dataset that should be uploaded to Keboola. When you use this actor in Integrations workflow, this field is optional. Default Dataset of previous actor in the flow will be used.

Keboola stack name keboolaStack

Hostname of your Keboola stack import endpoint. See Keboola documentations for more details. Default is import.keboola.com for AWS US-East region. You can alternatively set KEBOOLA_STACK environment variable instead.

Current multi-tenant stacks are:

If you are a single tenant user then your hostname is in format import.CUSTOMER_NAME.keboola.com.

Keboola API Key keboolaStorageApiKey

Your API Key to a Keboola project where you want to upload the data. You should generate a new API key just for this actor with limited rights to write-only for destination bucket. You can alternatively set KEBOOLA_STORAGE_API_KEY environment variable instead.

Keboola bucket bucket

Name of the destination Keboola bucket. eg. in.c-apify

Keboola table table

Name of the destination Keboola table. eg. scrape_results

Keboola table headers headers

Array of header names of destination Keboola table. You can use this to select subset of properties to result table or to reorder the columns - the order of headers is preserved in result table. You can leave it blank if your Dataset items have all properties always specified (without undefined values). In this case properties of the first Dataset item are used. Our recommendation is to be explicit to prevent unexpected data loss.

Batch size batchSize

Size of the batch to upload. Dataset will be split into more batches if it has more items that this number. Batches will be uploaded sequentially. Choose the batch size according to the nature of you data and parallelization of you process. Generally speaking, Keboola Importer works best if you send less frequent bigger portions (dozens of MB gzipped) of data. On the other side you are constrained by the Actor size. You can easily hit OOM condition when this number is too high.

Incremental load incremental

When enabled, imported data will be added to the existing table. When disabled, table will be truncated - all existing data will be deleted from the table. Default is enabled (true).

SDK

You can also use this actor from yours custom actors via @hckr_/apify-keboola npm package.

Install

npminstall @hckr_/apify-keboola

Usage

You can use free (pay per usage) variant:

import{ uploadToKeboola }from"@hckr_/apify-keboola";

Or you can support our work on https://www.hlidacshopu.cz/ with the paid option:

import{ uploadToKeboola }from"@hckr_/apify-keboola/hlidac-shopu";