Cloudflare R2

Supports:

  • ✅ Models
  • ✅ Model sync destination
  • ✅ Bulk sync source
  • ✅ Bulk sync destination

Connection

Configuration

NameTypeDescriptionRequired
account_idstringAccount IDtrue
aws_access_key_idstringAccess Key ID with read/write access to a bucket.true
aws_secret_access_keystringSecret Access Keytrue
bucket_namestringBucket name (folder optional); ex: polytomic/datasettrue
directory_glob_patternstringTables glob pathfalse
is_directory_snapshotbooleanMulti-directory multi-tablefalse
is_single_tablebooleanFiles are time-based snapshots

Treat the files as a single table.
false
single_table_file_formatstringFile format

Accepted values: csv, json, parquet
false
single_table_namestringCollection namefalse
skip_linesintegerSkip first lines

Skip first N lines of each CSV file.
false

Example

1{
2 "name": "Cloudflare R2 connection",
3 "type": "cloudflare_r2",
4 "configuration": {
5 "account_id": "",
6 "aws_access_key_id": "AKIAIOSFODNN7EXAMPLE",
7 "aws_secret_access_key": "wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY",
8 "bucket_name": "polytomic/dataset",
9 "directory_glob_pattern": "",
10 "is_directory_snapshot": false,
11 "is_single_table": false,
12 "single_table_file_format": "csv",
13 "single_table_name": "collection",
14 "skip_lines": 0
15 }
16}

Model Sync

Source

Configuration

NameTypeDescriptionRequired
file_formatstringFile format

Accepted values: csv, json, parquet
false
keystringObject key

The key of the object in the bucket to read from.
false
model_fromstringFiles

The model is generated from a single file or a multi-file archive. Accepted values: single_file, multi_file_archive
true
skip_linesintegerSkip first lines

Skip first N lines of each CSV file.
false
subfolderstringSubfolder to read files from from (optional)false

Example

1{
2 ...
3 "configuration": {
4 "file_format": "",
5 "key": "",
6 "model_from": "",
7 "skip_lines": 0,
8 "subfolder": ""
9 }
10}

Target

Cloudflare R2 connections may be used as the destination in a model sync.

All targets

Configuration
NameTypeDescriptionRequired
formatstringOutput format

Output file encoding. Accepted values: csv, json-doc, json, parquet
false
Example
1{
2 ...
3 "target": {
4 "configuration": {
5 "format": "csv"
6 }
7 }
8}

Bulk Sync

Destination

Configuration

NameTypeDescriptionRequired
formatstringOutput file encodingfalse
subfolderstringSubfolder to write to (optional)false

Example

1{
2 ...
3 "destination_configuration": {
4 "format": "csv",
5 "subfolder": "reports"
6 }
7}