Export to S3

Write records to object storage for a warehouse, lakehouse, or batch ingestion.

S3 export writes files to object storage for a warehouse, lakehouse, or downstream batch ingestion. Use it when your data platform already ingests bucket files. S3-compatible storage targets are supported.

This is a dashboard-managed export. Create it once for the workspace, then Medblocks runs a first backfill and later delta exports when new pulls finish.

Open export settings

Open the dashboard, go to Settings, then Export.

The export destinations list in the dashboard

Add object storage

Click Add Object Storage, then choose AWS or an S3-compatible target.

Adding an S3 export destination

Enter bucket settings

The destination needs these fields.

FieldPurpose
NameLabel shown in the dashboard.
Cloud vendorAWS or an S3-compatible provider.
EndpointStorage endpoint, required for S3-compatible targets.
RegionBucket region.
BucketDestination bucket name.
Access key ID and secretCredentials used by export jobs.
File typeNDJSON or zipped NDJSON.

Medblocks tests bucket connectivity before saving. If the test fails, check bucket policy, credentials, endpoint, and region.

Choose a file format

NDJSON stores one FHIR resource JSON object per line, so downstream systems can stream files without parsing one large JSON array.

{"resourceType":"Patient","id":"example-patient"}
{"resourceType":"Observation","id":"example-observation","status":"final"}

Backfill and send deltas

Setting up a destination exports existing data first, then later pulls send new data based on watermark tracking. Failed runs can be retried from the dashboard.

Monitor runs

Open the destination detail page for run history and errors.

Operational notes

  • Update credentials after rotating storage access keys.
  • Disable a destination to pause delivery without deleting records.
  • Retry after fixing permission, authentication, or network issues.
  • Keep downstream ingestion idempotent. A retry can write files for work that previously failed partway through.

See also